If you're using Census for syncing Users and Accounts, please follow this instructions on this page:
https://helpcenter.enterpret.com/en/articles/8611269-syncing-users-and-accounts
You can now use Enterpret's webhook APIs via Census to ingest feedback data from various custom feedback sources into Enterpret. This integration allows you to quickly and seamlessly bring in feedback data from various sources so that you can gain a more comprehensive understanding of customer feedback across all your channels.
In this article, we cover a sample use case of how Census custom API can be leveraged to ingest data from different sources into Enterpret.
To achieve this integration, we will first set up destination using Census Custom API. We will then need to add a sync from the source warehouse to custom API destination, which will automatically ingest the data into Enterpret.
Creating Destination
Head to Census, specifically the Connections page.
Click on
New Destinationand selectEnterpret.
Provide a descriptive
Namefor your new destination.Add your
API Token
To generate API Token
Navigate to the Integrations page in your Enterpret instance.
Click on
+New Integration, and selectWebhookfrom the list.
Provide a
Display Namefor the integration in the presented form, this name will appear as the Source for the records, everywhere in your Enterpret instances, for the records ingested using this Webhook.
Click
Connect, a Webhook integration will be created, with an API Key, that you can copy as shown below.
Creating a Sync
Open Syncs page, click on
Add Syncbutton.Select your source warehouse and your new Custom Destination.
Select the object type from the drop down menu
Review Records : To ingest review feedback.
Survey Response Records : To ingest survey response feedback.
Set up Custom Destination API Field Mappings
To ingest Review Data
Set the source column to the
Textfield if it contains review text.
To ingest Survey Data
Click on
Add Mapping.Select the source column from the drop-down menu on the left
Provide the survey question as the field name with a
feedback_prefix.
To ingest any additional fields along with the feedback
You can also ingest additional source columns along with the feedback as metadata.
Click on Add Mapping.
Select the desired source column from the drop-down menu on the left.
Provide a field name for the metadata on the right.
Choose the data type for the field(Defaults to
string). Currently, we only supportstringandfloattypes.
Your sync should look like this at the end.
Note: The createdAt field takes UNIX timestamp seconds, which are essential for accurate time-series analysis on the census data. Properly mapping this field is crucial to ensure that data displays correctly on Enterpret.
5. Once you have defined the mapping, you can proceed with running a test sync.
6. Confirm details and create the sync.
For more details on how census sync works, please refer to Census Doc.
Note: If you're using Census to send survey data, please ensure that the order of survey questions and answers is the same across all feedback for consistent analysis.
Running a sync
Once you've got your sync up and running, you can configure your sync to run automatically from schedules.
For detailed instructions on how to create a periodic trigger, please refer to Census Doc.
Note: After the sync is finished it can take upto 4 hours for the feedback to show up on Enterpret.
Give it a try and explore other use cases where you can leverage Enterpret's Census custom API to ingest your customer feedback. We hope you found this tutorial helpful, and we look forward to seeing what you come up with.