Server-Sent Events Structure

Clients subscribe to the Server-Sent Events endpoint to receive server-side events.

These events encompass diverse message entries and provide supplementary information related to the conversation entry.

For a comprehensive understanding of the various supported message types and formats, please refer to the “Message Types & Format Types” section.

The CONVERSATION_ROUTING_RESULT event handles routing to a rep or chatbot, such as when a conversation is initially created or when a conversation is transferred from a chatbot to a rep.

Add the following payload to the Server-Sent Events endpoint.

The CONVERSATION_PARTICIPANT_CHANGED event handles when a new participant joins a conversation or an existing participant leaves. This event applies to a participant other than the end user using the Messaging for In-App and Web client.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The CONVERSATION_MESSAGE event handles when a conversation message comes through the event source (SSE).

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The CONVERSATION_DELIVERY_ACKNOWLEDGEMENT event handles when an end user receives an acknowledgment for their message when it is ‘Delivered’.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The CONVERSATION_PROGRESS_INDICATOR event allows you to display a progress indicator when an AI agent is responding to a conversation. Progress indicators are useful to provide more information and context to users when an AI Agent is executing complex actions.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The CONVERSATION_READ_ACKNOWLEDGEMENT event handles when an end user receives an acknowledgment for their message when it is ‘Read’.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The CONVERSATION_STREAMING_TOKEN event allows you to feed partial responses in real time as they become available, engaging users immediately and allowing them to consume content sooner.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The token type StreamingTokenValidation notifies you when there's an issue like hallucination in the tokens streamed.

The CONVERSATION_TYPING_STARTED_INDICATOR event handles when the client receives a “typing started” indicator when the other participant, such as a rep or chatbot, starts typing a message.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The CONVERSATION_TYPING_STOPPED_INDICATOR event handles when the client receives a “typing stopped” indicator when the other participant, such as a rep or chatbot, stops typing a message.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.

The CONVERSATION_CLOSE_CONVERSATION event handles when the client receives an indicator or a confirmation that the conversation is closed.

Add the following payload to the Server-Sent Events Server-Sent Events endpoint.