Chatwoot

Name: Chatwoot API
Brand: Chatwoot
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCRMCustomer SupportapiKey144 EndpointsREST

For Agents

Manage Chatwoot conversations, contacts, agents, inboxes, and automation rules through a single API so an agent can triage support tickets, send replies, label conversations, and pull reports.

Install Jentic One Beta

Connect the Chatwoot to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Chatwoot, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fchatwoot.com%2Fchatwoot" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fchatwoot.com%2Fchatwoot" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Chatwoot API.

Create, list, and update contacts and merge duplicates across inboxes

Read and reply to conversations across email, web, and messaging channels

Send outbound messages and attach private notes for agent collaboration

GET STARTED

Start building with Chatwoot API

Explore with Jentic One

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Chatwoot, keeping it validated and agent-ready. Chatwoot is an open-source customer engagement platform that unifies conversations from email, web chat, social channels, and messaging apps into a shared inbox. Its API exposes deep control over accounts, agents, contacts, conversations, messages, inboxes, teams, labels, automation rules, and reporting - 144 endpoints across more than 30 resource groups. It supports three distinct API token types (user, agent bot, and platform app) so you can build everything from in-app integrations to multi-tenant provisioning.

Use Cases

Patterns agents use Chatwoot API for, with concrete tasks.

★ Automated Conversation Triage

Route incoming customer conversations to the right team based on content, channel, or contact attributes. Use the conversations and labels endpoints to inspect new threads, apply tags, and assign them to agents or teams. Pair with automation rules so the platform handles routine cases without human intervention.

Fetch all unassigned conversations in account 12, label any matching 'billing' as 'finance-team', and assign them to team_id 4.

Unified Contact Management

Keep customer profiles in sync between Chatwoot and your CRM. Create, search, and update contacts via the Contacts API; attach custom attributes for product tier or lifecycle stage; and merge duplicates that arrive through different channels. Useful for support teams running on multiple sources of truth.

Create a contact for 'jane@example.com' with custom attribute plan='enterprise' in account 12 and confirm the contact id is returned.

Support Reporting and Analytics

Pull operational metrics - conversation volume, response times, agent workload, CSAT - into a BI tool or weekly stand-up summary. The Reports endpoints aggregate by team, agent, label, or inbox, so you can compare performance across channels and time windows without exporting data manually.

Pull the agents report for account 12 between 2026-06-01 and 2026-06-07 and summarise the top three agents by conversations resolved.

AI Agent for Customer Support

An autonomous agent watches Chatwoot for new conversations, drafts contextual replies based on the contact's history and product, posts them as private notes for human approval, and labels the thread. Through Jentic, the agent calls the Conversations and Messages APIs without ever holding the api_access_token in its prompt.

Through Jentic, search 'reply to a conversation', load the schema, and post a private note suggesting a refund for conversation_id 9876.

Key Endpoints

144 endpoints — jentic publishes the only available openapi specification for chatwoot, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/api/v1/accounts/{account_id}/conversations

List conversations in an account

POST

/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages

Send a message in a conversation

POST

/api/v1/accounts/{account_id}/contacts

Create a contact

GET

/api/v1/accounts/{account_id}/reports

Retrieve reports for an account

POST

/api/v1/accounts/{account_id}/automation_rules

Create an automation rule

POST

/api/v1/accounts/{account_id}/agent_bots

Create an agent bot

GET

/api/v1/accounts/{account_id}/conversations

List conversations in an account

POST

/api/v1/accounts/{account_id}/conversations/{conversation_id}/messages

Send a message in a conversation

POST

/api/v1/accounts/{account_id}/contacts

Create a contact

GET

/api/v1/accounts/{account_id}/reports

Retrieve reports for an account

POST

/api/v1/accounts/{account_id}/automation_rules

Create an automation rule

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring Chatwoot by hand means handling its api_access_token header, picking which token type applies (user, agent bot, or platform app), and finding the right call among 144 endpoints. Through Jentic you install once, import Chatwoot from the API Directory, store the token once, and your agent calls it.

Permission scoping

Chatwoot puts the account id in the URL path (/api/v1/accounts/{account_id}/...), so a rule can pin your agent to one account: it works within that account and nothing else. You choose the operations it may call, so creating automation rules or agent bots is not included unless you add it.

Credential isolation

Your Chatwoot api_access_token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'reply to a conversation' or 'create a contact', and Jentic returns the matching Chatwoot operation with its input schema so the agent picks the right endpoint among 144 without browsing the reference docs.

FAQs

Specific to using Chatwoot API through Jentic.

Why is there no official OpenAPI spec for Chatwoot?

Chatwoot does not publish an OpenAPI specification on its own site. Jentic generates and maintains this spec so that AI agents and developers can call Chatwoot via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Chatwoot API use?

Chatwoot uses an API key passed in the api_access_token header. Three token types are defined: user (full user permissions), agent bot (limited bot integrations), and platform app (provisioning accounts and users). Through Jentic, the right token is stored encrypted in your Jentic One instance and injected at execution time without entering the agent's context.

Can I send replies to conversations with the Chatwoot API?

Yes. POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages sends a reply or private note in a specific conversation. The endpoint accepts the message content, message type (incoming, outgoing, or private), and optional attachments.

How do I create a contact via the Chatwoot API?

Use POST /api/v1/accounts/{account_id}/contacts with name, email, phone, and any custom attributes. The endpoint returns the created contact id, which you can then attach to inboxes or conversations.

What are the rate limits for the Chatwoot API?

The OpenAPI specification does not declare formal rate limits. Self-hosted Chatwoot instances are bound by the host's configuration, and the cloud version applies plan-based throttling - check your dashboard or the Chatwoot docs for current limits and plan for retry-with-backoff on 429 responses.

How do I post a reply to a Chatwoot conversation through Jentic?

Install the SDK with `pip install jentic`, then run Jentic.search('send a message in a conversation'), load the schema for /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages, and execute with the conversation_id and message content. Jentic injects the api_access_token automatically.

Can I limit what my agent is allowed to do with the Chatwoot API?

Yes. Because you run Jentic One yourself, your own rules decide which Chatwoot operations and credentials the agent may use. Since Chatwoot puts the account id in the URL path (/api/v1/accounts/{account_id}/...), you can pin the agent to a single account so it works within that account and nothing else. You also choose the specific operations it may call, so higher-risk actions like creating automation rules or agent bots are excluded unless you explicitly add them.

Chatwoot

Connect the Chatwoot to your agent

Capabilities

Start building with Chatwoot API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs