Skip to main content
Older versions of Internet Explorer will not support certain site features. Chrome, Safari, Firefox, and Edge will provide the best experience.

Adding a Smart Suite Integration

You can add new integrations in the Spok Enterprise Administration interface. To add a new integration to the Spok Server, do the following:

When you add or update integrations in high availability environments, the changes are applied to the DRS web service’s web.config file. However, the changes to the secondary server’s web.config must be made manually. To do this, copy the updated file from the primary server’s DRS (<IISROOT>\wwwroot\Spok\SpokDRS\web.config) and paste the new file onto the secondary server to replace the existing file.

  1. Access the Spok Enterprise Administration interface.

  2. Navigate to Administration > System Configuration > Integration to view the Manage Integration Settings screen.

  3. Click the Add link. The Create Integration Settings screen will appear.

  4. From the Application Type drop-down menu, select the type of integration that you would like to add. The fields change depending on which option you select.

Adding Smart Suite

The Data Repository Service can integrate with Smart Suite. The Smart Suite products manage an organization’s call center needs, including call handling to messaging services, paging, on-call schedules, contact preferences, scheduled events, and messaging services. 

Because Smart Suite can integrate with the Data Repository Service, its products are automatically updated with the most current, accurate information from the Data Repository.

If ODAC was installed prior to Spok Mobile Services installation, the information that is pre-populated into the fields below may vary. Depending on when ODAC was installed relative to Spok Mobile Services, you may need to configure different fields when setting up an integration.

You can configure an integration with Smart Suite in the Integrations screen. To create an integration with the Smart Suite system, configure the following fields:


In the Name field, enter a name to describe the service that you are creating.


In the Remark field, enter any additional clarification information that could be helpful when viewing this service. This clarification information could include any notes or reference information that should be associated with the service that is being created.

Application Type

From the Application Type drop-down menu, choose the Smart Suite option.


In the Server field, select Web.

Default System

Enable Default System if the system you are using is the only host system which is connecting through the Data Repository Service.

This option should also be enabled if multiple host systems are configured through the Data Repository Service and the client system (CTRM, Spok Mobile, or Messenger) calling the DRS does not specify which host system (MediCall Suite, Spok Console Suite, or Smart Suite) to use. In this situation, the default system will be used.

Use Connect Descriptor

Enable Use Connect Descriptor if there is an Oracle connect descriptor for the system. Use Connect Descriptor is enabled by default when the Smart Suite Application Type is selected. If Use Connect Descriptor is enabled, the Connect Descriptor field will appear. If Use Connect Descriptor is disabled, the Database Instance and Database fields will appear instead.

Connect Descriptor

In the Connect Descriptor field, enter the Oracle connect descriptor.

For detailed configuration information, see Configuring Oracle Connect Descriptor.

This field will only appear if the Use Connect Descriptor option is enabled.

Database Instance

In the Database Instance field, enter the IP address and port of the Smart Suite database instance. This information should be entered in the following format: <IP Address>:<Port>

For example, “”.

This field will only appear if the Use Connect Descriptor option is disabled.


In the Database field, enter the name of the Spok Console Suite database with which you are integrating. This field must contain the name of the database on which the Smart Suite system stores its data.

For example: "amcom"

This field will only appear if the Use Connect Descriptor option is disabled.


In the Username field, enter the Oracle username that has permission to access the Smart Suite database that you configured in the Database field above.

For example: “web_service


In the Password field, enter the password that is associated with the username that you entered in the Username field above. This password will be used to access the database.

Mobile Site ID

From the Mobile Site ID drop-down menu, select a site to assign to the host system. Every host system must be connected to a unique site ID. If an installation supports multiple host systems, you can add multiple customer site IDs. Please note that these site IDs should be the same site IDs used in the Spok Hosted Administration system.

Site IDs can be added in Spok Hosted Administration and re-imported either as a license or in the Edit Tenant page in Spok Enterprise Administration.

Use "Contains" Logic for Directory Search


Select this option to use "contains" search logic rather than the default "begins with" logic.

Client Initiated Messaging

Enable Client Initiated Messaging if you would like this service to use the client-initiated messaging feature. The client-initiated messaging feature allows users to create and send messages to other Spok Mobile users from the application on their smartphone devices. Checking this box allows the enterprise system to identify the method by which the clients can send and receive messages.

Note that disabling this option does not currently prevent Android clients from being able to initiate a message.

Host Projections

Enable Host Projections if Spok Mobile users should be able to change their profile information and their status information from the Spok Mobile application on their smartphone devices. This allows users to update the profile information that is associated with their Spok Mobile account. This also allows users to update their status, giving them control of their availability information within the application.

When this option is selected, the Edit Profile and Edit Status fields will appear.

The Spok Mobile Windows Service must be running when this option is enabled.

This option should not be altered more than once in a five minute period. If it is changed and saved more than once within a five minute time period, the system may fail.

Edit Profile

Enable Edit Profile if Spok Mobile clients should be able to view or edit their profiles in the application. If this option is disabled, users will not be able to view or edit their profiles in the Spok Mobile application on their devices.

This field only appears if the Host Projections option is enabled.

Edit Status

Enable the Edit Status option if Spok Mobile clients should have the ability to view or edit their status or availability in the application. If this option is disabled, users will not have the ability to view or change their status or availability in the Spok Mobile application on their devices.

This field only appears if the Host Projections option is enabled.

Click the Save link. Your choices will be saved and the new service will appear in the Manage Integration Settings screen. Any clients already registered on the system will automatically receive an update to their settings to reflect the new options.

Configuring Oracle Connect Descriptor

Change the IP addresses in the following examples to the correct IP addresses or hostnames for the customer's Oracle database servers.

If the Customer Does Not Have FSFO

If the Customer does not have FSFO, use the following format for the connect descriptor:





(SERVICE_NAME = amcom)




If the Customer Has FSFO

If the customer has FSFO, use the following format for the connect descriptor:







       (CONNECT_DATA =

              (SERVER = DEDICATED)

              (SERVICE_NAME = amcomfan)

              (FAILOVER_MODE =

                     (TYPE = SELECT)

                     (METHOD = BASIC)

                     (RETRIES = 180)

                     (DELAY = 5)