> For the complete documentation index, see [llms.txt](https://doc.aissist.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.aissist.io/tutorial/deploy/chatwoot.md).

# Chatwoot

Deploy Aissist in Chatwoot (beta) - connect with an access token, choose the inboxes it manages and the user it answers as.

*Last updated: November 17, 2026*

The Chatwoot gateway lets Aissist answer conversations in the Chatwoot inboxes you choose, on Chatwoot Cloud or your own Chatwoot server. Read [Deploy](https://doc.aissist.io/tutorial/deploy.md) first for the steps every gateway shares.

{% hint style="info" %}
The Chatwoot gateway is in beta, and the platform picker currently shows it greyed out for new gateways. Existing Chatwoot gateways keep working. [Contact us](https://aissist.io/contact-us/request-demo) if you want to deploy on Chatwoot.
{% endhint %}

### Create a connector

The gateway signs in through a Chatwoot connector: its URL, account ID and a user access token. See [Chatwoot connector](https://doc.aissist.io/tutorial/add-connectors/helpdesk/chatwoot.md) for what each one is.

### Prepare Chatwoot

* Create a Chatwoot user for Aissist to answer as. Aissist works best with a dedicated user.

### Connect Chatwoot

On the gateway's **Connect** tab, choose your Chatwoot connector. The tab then shows the host URL and account ID the gateway uses.

### Set up the agent

* **Managing Points (Inboxes)**: the inbox Aissist manages. Aissist works on conversations in that inbox until they are transferred or a person steps in.
* **Actor**: the user Aissist works as.

The gateway runs in **Auto-Pilot**: Aissist sends replies automatically and detects when to hand over to a person.

The Chatwoot gateway has no escalation target or handover rules: when Aissist hands over, your team picks the conversation up in the same inbox.

No additional steps are needed in the Aissist console. Aissist answers new incoming messages in the managed inbox.

### Actions

The Chatwoot connector carries no help desk actions. Actions that look up or change records in other systems use those systems' connectors. See [Add Actions](https://doc.aissist.io/tutorial/add-actions.md).

### Do it with Ask Engine

> How is our Chatwoot gateway configured?

Ask Engine answers from the gateway's settings, including whether it is deployed.

### Best practice

* Use a dedicated Chatwoot user as the actor, so your team can see which replies came from Aissist.
* Start with one inbox.
* Use Chatwoot's own assignment rules to bring a conversation to your team after a handover.

### Related

* [Deploy](https://doc.aissist.io/tutorial/deploy.md)
* [Connectors](https://doc.aissist.io/capabilities/connectors.md)
