Skip to content
Last updated

Adding CSAT, NPS, or Thumbs Rating to a Conversation

Dixa has APIs for adding CSAT, NPS, and thumbs ratings to conversations. The intent is that an external system captures the rating and stores it in Dixa. For chatbots, it is common to capture a score in their widget after a conversation ends.

The API uses a two-step design: first an offer, then a rating result. Keeping these separate allows Dixa to calculate the response rate, so it's required to use the offer step alongside your rating questions. Add the rating result once the contact has responded.

Rating Setup

Because of the API's design, it can be used with marketing platforms, chatbots, or CRM tools.

The first step is to present the question using one of the three supported rating systems: CSAT (1–5), NPS (1–10), or thumbs up or down (0–1). Use the Rating Offer API to create an offer. You will need to create an offer for each rating system you wish to use.

The second step is to capture the result using the Rating Result API. To match the correct rating system to the correct offer, you will need to use the ratingId returned from the first API call.

Channel Compatibility

The rating APIs are not restricted to the Generic API Messaging channel — they can be used across all Dixa-supported channels. For example, ratings captured via email marketing can also be stored in Dixa, giving managers visibility into the data via Dixa Intelligence.