Dixa

How to connect the data from Dixa to Plecto to see your conversation KPIs in real time.

Last updated: Aug. 16, 2021

Dixa_Dashboard.png

An example of Dixa dashboard.

Be aware: This integration is currently available as a beta feature in Plecto.

Available data types

With Plecto, you can display the following data types:

  • Conversations
  • Messages

Please visit our Dixa integration page to see the technical details.

Generate an API token on Dixa

Before you are able to connect Dixa to Plecto, you need to generate an API token from your Dixa account. Please read this article to learn how to create your Dixa API token.

Be aware: You need to have admin access to Dixa to be able to generate an Integrations API.

Connect Dixa to Plecto

To connect your Dixa account to Plecto, do the following:

  1. Go to Data management > Data sources > + New data source and select Dixa from the list.
  2. Insert the API token that you previously generated in Dixa, then click on "Next."
  3. Select the data types you want to import to Plecto. Click on "Next" to continue and import the data.

You have now connected your Dixa data to Plecto. Find your list of data sources in Data management > Data sources, or go to KPI management > Formulas to start building your KPIs.

Tip: Visit Plecto Store and install a Dixa dashboard to see your conversation KPIs right away. The dashboard is ready to be used with your Dixa data, and you can customize it however you please once it's installed.

Query limitations

Dixa's API limits manual imports to 1 month (31 days) on a query. Therefore, whenever the time between the start date and end date parameters is greater than 1 month, the start date gets adjusted to 30 days before the set end date. Meaning, only 1 month is imported. This is important to know when performing big manual imports.

Dixa webhooks

The Dixa webhooks update all your Dixa data sources in Plecto that use your credentials. For example, if you have added two data sources, namely Conversations and Messages, webhooks allow Plecto to update both of them at once, using the same credentials.

To create a webhook, go to the integration settings page in Dixa. Alternatively, you can find it under Settings > Integrations > Webhooks (configure webhooks) > Add Webhook in Dixa.

Add the following information:

  • Name: Choose the name of your webhook.
  • Webhook URL: https://app.plecto.com/admin/data-sources/dixa/{PLECTO CREDENTIALS UUID}/hook/ You can find the UUID of your Plecto credentials under Data management > Credentials. Click on your credentials for the Dixa integration and copy the alphanumerical string that is the final part of the URL when opening the credentials.
  • Authorization: Not required.
  • Enable: Make sure to enable the webhook.
  • Events: Select the events from the list for which you want to enable the webhook.

To finish, click on "Create Webhook."

Was this article helpful?