Skip to main content

Uniphore Customer Portal

Exotel Multimodal API

Exotel Multimodal API

In a multimodal call, end user can submit information through a chat bot on the mobile browser. User takes several seconds to submit the information, if no input is provided the call gets disconnected after the no input prompts are played.

This API allows the flow admin to play a message before call termination; enable or disable sending the user's voice input to the ASR or VAD. This API can be called any number of times in the flow.

This API is added to an Integration Point under Resources in X‑Platform and used through Integration Point element in X‑Designer.

EndPoint

Method: POST

URL: http://localhost:port/ecr/playMessage/callSid/<callId>

Multimodal Call without Message
curl --location --request POST 'http://localhost:9929/ecr/playMessage/callSid/2f600001d0d8144edf850567a31d17c7?discardUserInput=false&apikey=aYktdm9pY2UtaBTtbXktcGFzc3dvcmWtdWJvdDI0MjE%3D'\
--header 'Content-Type: text/plain' \
--data ''
Multimodal Call with Message
curl --location 'http://localhost:9929/ecr/playMessage/callSid/2f600001d0d8144edf850567a31d17c7?discardUserInput=false&apikey=aYktdm9pY2UtaBTtbXktcGFzc3dvcmWtdWJvdDI0MjE%3D'\
--header 'Content-Type: text/plain' \
--data 'Please click the link to open the form and enter the data.'
Path Parameter

Parameter Name

Data Type

Description

Required / Optional

callId

String

Call Id of the ongoing voice call.

Required

Query Parameter

Parameter Name

Data Type

Description

Required / Optional

Request Body

Data

The message entered here is played before terminating the call.

Example: Thanks for filling the form. We will get back to you shortly.

Optional

discardUserInput

Boolean

If discardUserInput is set to True then the user input are not sent to ASR and VAD. The user input are not processed, even if the call continues.

If discardUserInput is set to False then the connector allows the receive voice input from user which is sent to ASR and VAD for processing.

Optional

apikey

String

apikey is an authorization token that is provided when making API calls

Reach out to Platform team to obtain the apikey.

Required

Response and Error Codes

Response Code

Condition

200

Ok

400

Bad request

401

Unauthorized

In this section: