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

Request

  • Base URL
    https://api.tidio.com
  • URL
    https://api.tidio.com/contacts/{contactId}/messages
  • Auth
    API key in header X-Tidio-Openapi-Client-Id and API key in header X-Tidio-Openapi-Client-Secret

Path parameters

contactIdstring uuid required

ID of the contact

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

Request body

messagestring required

Message text (1–5000 characters).

Example request

{
  "message": "Hi, I need help with my order #2341."
}

Response

Message accepted for asynchronous processing.

statusstring

Example response

{
  "status": "accepted"
}

Changes

No recorded changes to this operation across all 1 revision of this API.