> This page is for version Generative (default).
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Webhook: Conversation message

POST 

A webhook sent when a message is sent to a conversation

Reference: https://developers.ada.cx/reference/conversations/conversation-message-webhook

## Request

### Payload

- `type` (string, optional) — The webhook event type
- `timestamp` (string, optional) — The timestamp for when the event was generated, uses millisecond precision to help with event ordering needs
- `data` (ConversationMessageWebhookPayloadData, optional) — The webhook event data

## Types

### ConversationMessageWebhookPayloadData

The webhook event data

- `message_id` (string, optional) — The ID of the message that triggered the webhook event
- `conversation_id` (string, optional) — The ID of the conversation that contains the message
- `channel_id` (string, optional) — The ID of the channel
- `created_at` (string, optional) — The date and time the message was created
- `author` (ConversationMessageWebhookPayloadDataAuthor, optional) — Information about the message author
- `content` (ConversationMessageWebhookPayloadDataContent, optional)

### ConversationMessageWebhookPayloadDataAuthor

Information about the message author

- `id` (string, optional) — The ID of the user that will be participating in the conversation
- `role` (enum, optional) — The author's role
  - Allowed values: `end_user`, `ai_agent`, `human_agent`
- `avatar` (string, optional) — The URL of the author's avatar
- `display_name` (string, optional) — The author's display name

### ConversationMessageWebhookPayloadDataContent

- ConversationMessageWebhookTextMessageContent
- ConversationMessageWebhookLinkMessageContent

### ConversationMessageWebhookTextMessageContent

The content of the text message

- `type` (string, optional) — The type of the message. Always `text` for text messages.
- `body` (string, optional) — The body of the message

### ConversationMessageWebhookLinkMessageContent

The content of the link message

- `type` (string, optional) — The type of the message. Always `link` for link messages.
- `url` (string, optional) — The link's URL
- `alt_text` (string, optional) — The link's alt text
- `title` (string, optional) — The link's title
- `link_text` (string, optional) — The link's text
- `link_icon` (string, optional) — The URL of the link's icon
- `link_description` (string, optional) — The link's description
- `new_window` (boolean, optional) — Whether the link should open in a new window
- `generate_link_preview` (boolean, optional) — Whether a preview should be generated for the link