Add a data dip connector


Note: This article applies to the web services data dip connector.

To use the web services data dip connector, add one or more connectors to your Genesys Cloud organization. Multiple connectors allow you to use different configurations.

Note: Any configuration change after initial setup requires a connector restart.
  1. Add a connector.
    1. In Genesys Cloud, click Admin.
    2. Under Integrations, click Bridge.
    3. Click the Connectors tab.

      A list of all connectors that you have installed appears.

    4. Click Add Connector.

      The Add a new Connector dialog box appears.

    5. In the Name box, enter a name for the connector group.

      The name must not contain any spaces but can include hyphens. This name appears as the Group Name on the Manage Connectors page.

      Use unique names. Unique names differentiate multiple connector groups of the same connector type from one another. For example, if you create two connector groups for the web services data dip connector, name them WebServicesDDGroup1 and WebServicesDDGroup2. 

      You can use multiple connector groups of the same connector type but with different configurations for different parts of your organization, such as Support and Sales. Be sure to link the connector instances in both connector groups to the same Bridge Server.

    6. In the Choose a Connector box, type webservices-datadip or select it from the list. 
    7. Click Save.

    The Connector Details page appears.

  2. Add configuration properties.
    Note: These configurations do not affect the configuration of your web service. To configure your web service, contact your web service provider.
    1. On the Connector Details page, click the Configuration tab.
    2. Enter the following information:
      • PluginName: Unique name (for example, webservices-datadip) given to the log file created for this connector.
        Note: When running multiple connector instances on the same Bridge Server, make sure that the value for PluginName is unique for each connector group. The value for PluginName distinguishes the log files of the connector groups from one another.
      • EndpointAddress: Endpoint address of the web service, for example, https://yoursite.com:12345/webservices.
      • Log Level (optional): Log level for the connector (for example, TRACE, DEBUG, INFO).
    3. Click Save & Publish.
  3. Add a connector instance.
    1. Click the Connector Details tab.
    2. Click Add Instance.
    3. Click Set Server.
    4. Select a Bridge Server and click Save.
    5. Under Enabled, click OFF.

      Enabled changes to ON, and the Enable Connector Instance dialog box appears. 

    6. Click Yes in the Enable Connector Instance dialog box.
    7. To turn on the connector, click the Start button under Control.
    8. To create more instances, repeat these steps.

      If you installed more than one instance of the Bridge Server for fault tolerance, then add extra instances of the connector. For more information, see Fault tolerance for Bridge Connectors.

    Note: If you added multiple connector groups of the same connector type, be sure to link all connector instances in the connector groups to the same Bridge Server.
Note: Upgrades to Genesys Cloud and its connectors occur regularly. You must manually upgrade an existing version of the web services data dip connector. For more information, see Upgrade a Bridge Connector.

Next, add a bridge action.

For more information about the connector, see About the web services data dip connector.