Chatwoot

Add a bot to Chatwoot using the official integration.

Open in Hubv

The official Chatwoot integration allows users to chat with your bot through Telegram, WhatsApp, Email, or any Chatwoot-supported channel. It also allows your bot to hand off conversations to human agents when needed.

Setup

You will need:

• A published bot
• A Chatwoot account (self-hosted or cloud)

Step 1: Install the integration in Botpress

1. In Botpress Studio, select Explore Hub in the upper-right corner.

2. Search for the Chatwoot integration, then select Install Integration.

3. In the Configuration menu, you should see three fields:

   • API Access Token
   • Account ID
   • Inbox ID

Step 2: Get your credentials from Chatwoot

Log in to Chatwoot. Then, in Botpress, fill in the integration’s configuration fields using information from your Chatwoot account:

API Access Token

1. In Chatwoot, select your profile icon (bottom-left corner).

2. Go to Profile Settings.

3. Scroll to the Access Token section.

4. Copy the token, then paste it into the API Access Token field in Botpress.

Account ID

1. In the Chatwoot page’s URL, find and copy your account ID—it should be after /accounts/.

   For example, if your page URL is:

   https://app.chatwoot.com/app/accounts/145294/...

   the account ID is:

   145294.

2. Paste the account ID into the Account ID field in Botpress.

Inbox ID

1. In Chatwoot, go to Settings > Inboxes.

2. Select Add Inbox.

3. Select API as the channel type.

4. Choose a name for the channel.

5. After creation, select the inbox to open its settings.

6. In the Chatwoot page’s URL, find and copy your inbox ID—it should be after /inboxes/.

   For example, if your page URL is:

   https://app.chatwoot.com/app/accounts/1/settings/inboxes/88275

   the inbox ID is 88275.

7. Paste the inbox ID into the Inbox ID field in Botpress.

Step 3: Configure your webhook in Chatwoot.

Finally, configure your Botpress webhook in Chatwoot:

1. In Botpress, copy the integration’s webhook URL (starting with https://webhook.botpress.cloud).

2. In Chatwoot, go to Settings > Integrations > Webhooks.

3. Select Add New Webhook.

4. Paste the Botpress webhook URL.

5. Select the following events:

   • message_created
   • conversation_status_changed
6. Select Create Webhook.

Your Chatwoot integration is ready. When users send a message to the provided Chatwoot inbox, it’ll respond as your Botpress bot.