This operation posts a message in a conversation as specified by the conversationId. You can retrieve the conversationId by listing the conversations for a contact or by listing all conversations in the organization. You can also send messages to a phone number, an email address, fax number, or securely message a contact using a specific internal endpoint. The requestID returned by this API may be used to match against the requestID field of the conversationItem.created webhook event to identify when the message is posted.

Posting an internal message containing a page for an organization member

To post a message with a page for an organization member, you'll first need to know the member's id. You can find the id of the organization member by listing all organization members. Once the member id is known, you can post a message to the conversation with internal=true and an element of type=page and value=<member-id> in the list of body elements being posted. The body parameter is a list of message elements. Each element can be of type text or page. The request can contain combinations of text and page elements to create internal messages with useful content while also notifying a set of members.

Posting to a Team or Note conversation

You can also use this API to post messages into a Team or Note conversations. For Note conversations, you will have to specify internal=true since only internal messages can be posted in Note conversations.