Configuring post-call IVR surveys

You can configure your Twilio Flex environment to automatically transfer callers to a voice IVR survey at the end of a call via a Send to Flex widget. By setting a few attributes in the widget before routing calls to an agent, you can trigger the Mindful Feedback integration to automatically send the call to a survey when the agent ends the call.

Two attributes are required, and two optional attributes are available. In addition, you can attach any custom attributes that you would like in one of two ways:

  • Define a Survey Mapping in Mindful Feedback to associate the transferred call with specific survey attributes (more flexible approach).
  • Set custom attributes in the Send to Flex widget prefixed by SDX_ (for example, SDX_CustomerName).

Task Attributes

The following table outlines the attributes required to initiate a post-call voice IVR survey, listed in order of importance.

Attribute NameAttribute Value
sdxVoiceSurvey(Required) This must be a value of either 1 or 0. When set to 1, the redirect-to-survey service (part of the Mindful Feedback integration) will transfer the call to Mindful Feedback when the agent clicks End Call. Note that all other required attributes must be present to transfer the call.
SDX_survey_sip_token(Required) Set this attribute to the SIP survey token / UUID of the survey (found at Surveys > Your survey > Advanced tab). This is required in order to tell Mindful Feedback which survey to execute when the interaction is created.
SDX_external_ref(Recommended) Set this attribute to the Twilio Flex Call SID by referencing the trigger.call.CallSid variable. You can use this attribute later to map other attributes from the call to the associated survey.
SDX_respondent_language(Optional) Enter any valid respondent language code (for example, en-US or es-ES). For a complete list of supported languages, see the Supported Languages page in the API Reference guide.
SDX_AttributeName(Optional) Use the SDX_ prefix to add any custom attributes you would like to include with the survey interaction. Any number of additional attributes can be passed to the survey interaction using the SDX_ prefix. However, it is also possible to map task attributes to the survey interaction when the agent clicks the Completed button.

The screenshot below shows an example of attributes being set in a Twilio Studio Flow in a Send to Flex widget. With this configuration in place, Mindful Feedback will automatically transfer the call to the specified survey when the agent clicks End Call.

Screen capture of Send to Flex widget with attached attributes