v1

latestOpenAPI 3.0.32026-07-26303155.1 KB
Conversations

Send a message on behalf of the contact

Ingests a message as if the contact had sent it themselves. Used by partners whose end-users type messages into a partner-hosted widget — the partner's backend forwards each message to Tidio via this endpoint.

The message is attributed to the contact (not to an operator or bot), persisted into the conversation, routed to the assigned operator's panel like any other inbound message, and triggers any matching bot/AI-agent rules.

Processing is asynchronous: the response is 202 Accepted. Retrieve the persisted message via GET /contacts/{contactId}/messages if you need the canonical record.

post/contacts/{contactId}/messages

Path parameters

contactIdstring uuid required

ID of the contact

Example:a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e

Response

Message accepted for asynchronous processing.