The Chatlio source is in beta. Please read the sources overview for more information on using beta-labeled sources.
This tutorial provides steps for creating a Chatlio source connection using the Adobe Experience Platform user interface.
This tutorial requires a working understanding of the following components of Experience Platform:
The following section provides information on prerequisites to complete before you can create a Chatlio source connection.
Before creating a Chatlio source connection, you will require a source schema to be provided. You can use the JSON below.
{
"visitor": {
"email": "test@example.com",
"UUID": "2d3f4260-2235-903b-0a82-a23d326cc257"
},
"message": "Hi",
"channelId": "C04J7M7LCMQ",
"slackChannelName": "aep",
"slackChannelId": "C04JVR71WKS"
}
You must also ensure that you create a Platform schema to use for your source. Read the tutorial on creating a Platform schema for comprehensive steps on how to create a schema.
In the Platform UI, select Sources from the left navigation to access the Sources workspace and see a catalog of sources available in Experience Platform.
Use the Categories menu to filter sources by category. Alternatively, enter a source name in the search bar to find a specific source from the catalog.
Go to the Marketing automation category to see the Chatlio source card. To begin, select Add data.
The Select data step appears, providing an interface for you to select the data that you want to bring to Platform.
Select Upload files to upload a JSON file from your local system. Alternatively, you can drag and drop the JSON file you want to upload into the Drag and drop files panel.
Once your file uploads, the preview interface updates to display a preview of the schema you uploaded. The preview interface allows you to inspect the contents and structure of a file. You can also use the Search field utility to access specific items from within your schema.
When finished, select Next.
The Dataflow detail step appears, providing you with options to use an existing dataset or establish a new dataset for your dataflow, as well as an opportunity to provide a name and description for your dataflow. During this step, you can also configure settings for Profile ingestion, error diagnostics, partial ingestion, and alerts.
When finished, select Next.
The Mapping step appears, providing you with an interface to map the source fields from your source schema to their appropriate target XDM fields in the target schema.
Platform provides intelligent recommendations for auto-mapped fields based on the target schema or dataset that you selected. You can manually adjust mapping rules to suit your use cases. Based on your needs, you can choose to map fields directly, or use data prep functions to transform source data to derive computed or calculated values. For comprehensive steps on using the mapper interface and calculated fields, see the Data Prep UI guide.
The mappings listed below are mandatory and should be setup before proceeding to the Review stage.
Target Field | Description |
---|---|
UUID |
The Chatlio identifier for the event. |
Once your source data is successfully mapped, select Next.
The Review step appears, allowing you to review your new dataflow before it is created. Details are grouped within the following categories:
Once you have reviewed your dataflow, select Finish and allow some time for the dataflow to be created.
With your streaming dataflow created, you can now retrieve your streaming endpoint URL. This endpoint will be used to subscribe to your webhook, allowing your streaming source to communicate with Experience Platform.
In order to construct the URL used to configure the webhook on Chatlio you must retrieve the following:
To retrieve your Dataflow ID and Streaming endpoint, go to the Dataflow activity page of the dataflow that you just created and copy the details from the bottom of the Properties panel.
Once you have retrieved your streaming endpoint and dataflow ID, build a URL based on the following pattern: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}
. For example, a constructed webhook URL may look like: https://dcs.adobedc.net/collection/d56b47ee3985104beaf724efcd78a3e1a863d720471a482bebac0acc1ab95983
With your webhook URL created, you can now set up your webhook using the Chatlio user interface.
Login to your Chatlio account and follow the guide on setup and installation to create a widget.
Once a widget is crated, navigate to the widget’s settings page to add your webhook URL to that widget.
Next, select the Behavior tab and add your webhook URL to the Webhook when a new conversation starts field and any other webhook events fields that you want to subscribe to.
You can subscribe to a variety of different events for your Chatlio webhook. For more information on the different events, please refer to the Chatlio events documentation.
By following this tutorial you have successfully configured a streaming dataflow to bring your Chatlio data to Experience Platform. To monitor the data that is being ingested, refer to the guide on monitoring streaming dataflows using Platform UI.
The sections below provide additional resources that you can refer to when using the Chatlio source.
To validate that you have correctly set up the source and Chatlio messages are being ingested, follow the steps below:
For additional information on Chatlio, visit the Chatlio documentation and FAQ.