Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt

The Data Connector applet retrieves data from or sends data to Salesforce, an external web service, or a client's bespoke system. This data is then available in the form of a Data Source for use in subsequent applets in the interaction plan:

Data retrieved by Data Connector applets is also available for use by Data Source Mappings. For information about Data Source Mappings, see Data Source Mappings. Data Source Mappings can subsequently make data available to Dashboards. For information about viewing mapped data source data in Dashboards, see Viewing mapped data source data in DashboardsReal-time Analytics.

Info

Vonage Contact Center uses account feature toggles to enable reading and writing of data in external sources other than Salesforce. This page describes the functionality available using the Salesforce and Web Service interfaces. For information about how to use the Data Connector with custom interfaces, please contact support.

...

Expand
titleSalesforce interfaces

Insert excerpt
_ExcerptSFDC
_ExcerptSFDC
nopaneltrue

Note

The Salesforce user that Vonage Contact Center uses to connect to Salesforce must have permission to view the required objects fields in Salesforce. Only objects and fields to which the user has access appear in the relevant sections in the Data Connector applet. For information about linking a Salesforce user with Vonage Contact Center , see Linking Vonage Contact Center to a Salesforce account.

Using the standard Salesforce interface, the Data Connector applet compares a single value that you specify—CLID, value in a previously found data source, or value entered in an IVR slot—to the value of a specified field of a specified object in Salesforce. If a match or matches are found, the applet retrieves the values of selected fields from the record or records and makes them available as Data Sources in the form Object Name | Field Name n.

For example, you can configure the applet to use an account number stored in a data source to compare to the Account Number field of an Account object in Salesforce and find one or more records. If there is a match or matches, you can specify that the applet must retrieve data from the Customer Type field on the found record or records in Salesforce.

For more information about retrieving data from Salesforce, see Retrieving data from Salesforce.

If enabled for your Vonage Contact Center account, you can also create and update object records in Salesforce using the Data Connector applet—the applet uses the values you specify to populate the fields you choose, on the record you want to create or update. After a successful creation or update the applet makes the ID of the created or updated record available for subsequent applets in a data source. For information about creating or updating Salesforce records, see Creating a Salesforce record and Updating a Salesforce record.

Salesforce Object Query Language (SOQL)

Using the Salesforce interface you can use Salesforce Object Query Language (SOQL) to perform more complex queries to retrieve data from multiple objects, using multiple search criteria. You can retrieve almost any Salesforce data using any SOQL query that you can use in Salesforce itself. For information about using the advanced Salesforce interface, see Retrieving data from Salesforce using Salesforce Object Query Language (SOQL). You cannot create Salesforce records using SOQL.

...

Expand
titleMicrosoft Dynamics 365 interfaces


Note

The Microsoft Dynamics 365 user that Vonage Contact Center uses to connect to Dynamics 365 must have permission to view the required objects object's fields in Dynamics 365. Only objects and fields to which the user has access to appear in the relevant sections in the Data Connector applet. For information about linking a Dynamics 365 user with VCC, see Linking Vonage Contact Center to a MS Dynamics account.

Using the standard Dynamics 365 interface, the Data Connector applet compares a value in a previously found data source to the value of a specified field of a specified object in Dynamics 365. If a match or matches are found, the applet retrieves the values of selected fields from the record or records and makes them available as Data Sources in the form Object Name | Field Name n.

For example, you can configure the applet to use an account number stored in a data source to compare to the Account Number field of an Account object in Dynamics 365 and find one or more records. If there is a match or matches, you can specify that the applet must retrieve data from the Customer Type field on the found record or records in Dynamics 365.

For more information about retrieving data from Dynamics 365, see Retrieving data from Microsoft Dynamics 365an integrated and linked CRM system.

If enabled for your Vonage Contact Center account, you can also create and update object records in Dynamics 365 using the Data Connector applet—the applet uses the values you specify to populate the fields you choose, on the record you want to create or update. After a successful creation or update the applet makes the ID of the created or updated record available for subsequent applets in a data source. For information about creating or updating Dynamics 365 records, see Creating a Microsoft Dynamics 365 recordrecord in an integrated and linked CRM system and Updating a Microsoft Dynamics 365 recordrecord in an integrated and linked CRM system.

Omni-Channel flows for SCV

...

FieldOptionsDescription
Interface

List of available interfaces

(in most cases just Salesforce and Web Service)

The interface to use to retrieve or send data.

To interact with Salesforce, select Salesforce.
To connect to a web service, select Web Service.
To interact with Dynamics 365, select MS Dynamics.
To use Omni-Channel flows to route VCC calls, select Omni-Channel flows for SCV.

Interface FailureList of available appletsThe

For most interfaces, the applet that the call is routed to if the applet cannot connect to the interface or the interface returns an error.

For the Web Service interface, the applet that the call is routed to if the applet cannot connect to the external API. The Data Connector applet will try to connect to the API for 10 seconds before timing out.

Action

(The availability and content of this section is determined by which interface you choose and the features enabled for your account.)

...

For information about creating Dynamics 365 records, see Creating a Microsoft Dynamics 365 recordrecord in an integrated and linked CRM system.

FieldOptionsDescription
ObjectList of available Dynamics 365 objects

The Dynamics 365 object that you want to create.

Select the name of the object to create. Add Field appears.

Add FieldList of fields available for the selected object

The field in the Dynamics 365 object that you want to populate.

Select the name of the field. The field is added to a table. Source appear.

Info

If the selected Dynamics 365 object contains one or more mandatory fields, you must provide values. If you do not provide a value for each of the mandatory fields, when you click Update, an error message or messages appear.

Use Add Field to add as many fields as you want to populate. Each time you select the name of a field a new row is added to the table with corresponding Source field.

SourceList of available data sources

The specific source of the information you want to populate the field with.

Select the data source.

...

For information about updating MS Dynamics records, see Updating a Microsoft Dynamics 365 recordrecord in an integrated and linked CRM system.

SectionFieldDescription

ObjectThe Object list contains the available Dynamics 365 objects. Click the object you want to update. The ID Field and Add Field list appears.

Object ID Field

Info
All Dynamics 365 records have a unique ID. Vonage Contact Center uses the value that you specify in this section to locate the Dynamics 365 record to update.



Field NameField Name is ID. Use the Source field to identify the source of the data for this field.

SourceThe source of the data. Click the data source that contains the data for the field.

Add Field

The Add Field list contains the fields available on the selected object. Click the field you want to populate. The Fields to Populate section appears. Use Add Field to add and populate as many fields on the selected Dynamics 365 object as you want.

Fields to Populate

Field NameContains the selected field. Use the Source field to identify the source of the data for this field.

SourceThe source of the data. Click the data source that contains the data for the field.

...

FieldOptionsDescription
Successful ActionList of available applets

The applet that the call is routed to if the Data Connector is successful:

  • using the Salesforce interface, if the Data Connector finds a match for the chosen object in Salesforce
  • using the Web Service interface, if the web service that the Data Connector calls returns a any response
  • using the MS Dynamics interface, if the Data Connector finds a match for the chosen object in Dynamics 365
  • using the Omni-Channel flows for SCV interface, if the Data Connector connects to and triggers the Omni-Channel flow.
Multiple Salesforce Matches / Multiple MatchesList of available applets

The applet that the call is routed to if the applet finds multiple matches for the chosen object in Salesforce or Dynamics 365. This field is only available if you select the Salesforce or MS Dynamics interface and is unavailable if you select Retrieve Multiple Records.


No Salesforce Match / No MatchList of available appletsThe applet that the call is routed to if the applet finds no match for the chosen object in Salesforce or Dynamics 365. This field is only available if you select the Salesforce or MS Dynamics interface.

...