Tidio API

14 endpoints for Tidio, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/tidio
Connects with: Your own Tidio operator login (an admin account to change Settings, Macros and Flows). You sign in once in your own browser and keep your own 2-step verification.
Integration page: Tidio

Read (9)

Return data and change nothing in the account.

Tidio Endpoints: Read
Endpoint	Description
GET /conversations	Live chat conversations in the Tidio Inbox, in the order the Inbox shows them.
GET /conversations/{conversation_id}	Every message of one live chat conversation, with who wrote each.
GET /tickets	Email tickets from a folder, with status, priority, assignee and department.
GET /tickets/{ticket_id}	One ticket with all its messages, tags and internal notes.
GET /contacts	Contacts with email, tags and contact properties.
GET /contacts/{contact_id}	One contact with every property and tag.
GET /macros	Macros (saved replies) with name, label and text.
GET /flows	Chatbot Flows from My Flows, with their trigger.
GET /operators	Operators of your account with their departments.

Change the account. Calls marked Confirm wait for the user to approve them.

Tidio Endpoints: Write
Endpoint	Description
POST /tickets/{ticket_id}/replies Confirm	Send a public reply or an internal note on a ticket.
POST /conversations/{conversation_id}/replies Confirm	Send a message to a visitor in a live chat as an operator.
PATCH /tickets/{ticket_id}	Change priority, status, assignee, department or tags of a ticket.
PATCH /contacts/{contact_id}	Set contact properties and add or remove tags on a contact.
POST /macros	Add a macro (saved reply) to Settings > General > Macros.