Endpoint used to converse with a bot.
Server Address: https://api.ultimate.ai
String API Key for the botId. The key can be generated on custom CRM integration page in our Ultimate.ai Dashboard. Please see Authentication article to learn more.
The ID of the bot that is sending the event.
application/jsonAn ID provided by the custom CRM to identify the conversation. The custom CRM application can decide the format.
Type of event from enum values. Use startSession when the conversation is created. The welcomeMessage will be given as a response in case there is one for the specific bot. Use message if sending a visitor message. Use endSession to end the session. Otherwise the Session will end automatically after 2 hours or preconfigured timeout.
The text message that the visitor typed into the chat. The text is optional and not used if the eventType is startSession or endSession. If a button was pressed (also in carousels), send the value of the button as text (unless it’s a link button).
Sending metadata gives you the ability to send metadata on the user or the session of the conversation. These params will be saved on the session and can be used by the bot to personalize the conversation flows.
Name the session parameter, can be referenced by to personalize a conversation.
Value of the session parameter, note that we only support values of type string at this moment.
An Optional field, should be set as true for PII data.
The card index of the card that the visitor clicked in the chat. The card index is optional and not used if the eventType is startSession or endSession. Card index start in 0
The request has been acknowledge and will be processed. The actual response will come through webhooks.
{ "platformConversationId": "string", "eventType": "string", "text": "string", "metaData": { "key": "string", "value": "string", "sanitize": true }, "cardIndex": 0}