Message Types and Message Format Types

Message types and message format types are referred by the List Conversation Entries and Server-Sent Events Structure sections.

Message Type (messageType)Description
StaticContentMessageA message containing static content. No specific response is expected. For a sample payload, see StaticContentMessage.
ChoicesMessageA message with some choices from which the recipient can choose. A response of type ChoicesResponse is expected but not required. This API doesn't cause CRM changes, such as creating and updating records, but sometimes results in conversation routing in bots. For a sample payload, see ChoicesMessage.
ChoicesResponseMessageA message with the selected choices as a response to a Choices message. For a sample payload, see ChoicesResponseMessage.
FormMessageA message with a form containing multiple single or multiselect choices that a recipient can choose from. A response of type FormResponse is expected but not required. For a sample payload, see FormMessage.
FormResponseMessageA message with the form selection as a response to a Form message. The message results in a record being created or updated in the CRM database. For a sample payload, see FormResponseMessage.

Each message type supports specific format types, and each format type determines the shape of the payload.

For example, messageType StaticContentMessage supports formatType Text, RichLink, Attachments, ExternalAttachments, and WebView, If, say, messageType is StaticContentMessage and formatType is Text, the payload includes the details of the message in plain text:

This table lists all message types and their possible format types.

Message Type (messageType)Format Type (formatType)Description
StaticContentMessageTextSend and receivePlain text. For a sample payload, see StaticContentMessage.
StaticContentMessageRichLinkReceiveA rich link containing an inline image or video. For a sample payload, see StaticContentMessage.
StaticContentMessageAttachmentsReceiveAttachments stored in the CRM. Sent with MT messages. Can have optional text. For a sample payload, see StaticContentMessage.
StaticContentMessageExternalAttachmentsSendExternal attachments not stored in the CRM. Sent with MO messages. Can have optional text. For a sample payload, see StaticContentMessage.
StaticContentMessageWebViewReceiveWeb page sent. For a sample payload, see StaticContentMessage.
ChoicesMessageButtonsReceiveA text with buttons with a title. The buttons can be postbacks. For a sample payload, see ChoicesMessage.
ChoicesMessageQuickRepliesReceiveAn optional text with buttons that has titles and/or images. All buttons are postbacks. For a sample payload, see ChoicesMessage.
ChoicesMessageCarouselReceiveA set of items that can include images, text, and buttons. The buttons can be postbacks. For a sample payload, see ChoicesMessage.
ChoicesResponseMessageSelectionsSendSelections of options from choices or forms. Always set for choice and form response. For a sample payload, see ChoicesResponseMessage.
FormMessageInputsReceiveSends a form from the agent side. For a sample payload, see FormMessage.
FormResponseMessageResultSendThe end user’s responses to the form sent from the agent. For a sample payload, see FormResponseMessage.