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 URLhttps://api.tidio.com
- URLhttps://api.tidio.com/contacts/{contactId}/messages
- AuthAPI 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
Example request
{
"message": "Hi, I need help with my order #2341."
}Response
Message accepted for asynchronous processing.
Example response
{
"status": "accepted"
}Changes
No recorded changes to this operation across all 1 revision of this API.