AI agents for Chatwoot

List conversations

Lists conversations, 25 a page, newest activity first, filtered by status (open by default), assignee.

Filter conversations

Finds conversations with Chatwoot's filter conditions, for anything List conversations cannot express.

Get a conversation

Reads one conversation by its number (id in lists, the number in the Chatwoot address).

List messages in a conversation

Reads a conversation's messages, oldest first: the latest 20 by default, the 20 before a message ID (before), or up to 100 after one (after).

Search contacts

Finds contacts whose name, email, phone number or identifier matches the text, 15 a page.

Get a contact

Reads one contact by ID.

List a contact's conversations

Lists every conversation with one contact, newest first.

List inboxes

Lists the inboxes the connected agent can see.

List agents

Lists the account's agents and administrators.

Reply or add a private note

Posts a message in a conversation as the connected agent.

Start a conversation

Opens a conversation with an existing contact in an inbox (website, email, API or phone inbox), optionally with a first outgoing message, a status, an assignee and a team.

Change a conversation's status

Sets a conversation to open, pending, resolved or snoozed.

Assign a conversation

Assigns a conversation to an agent (assignee_id, from List agents) or, without one, to a team (team_id).

Set a conversation's labels

Replaces a conversation's labels with the list given (Chatwoot overwrites them, so include the labels to keep; read them with Get a conversation first).

Create a contact

Adds a contact with a name, email, phone number (E.164, like +14155550100), your own identifier and custom attributes.