> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zazubot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chatwoot

The Chatwoot integration block allows you to open a Chatwoot widget to allow your user to directly talk to a human. It allows you to add a Live Chat layer on your zazubot.

## Requirements

For this integration, you need a Chatwoot account and create a "Website" inbox:

<Frame>
  <img src="https://mintcdn.com/zazubot/qJF_uz16fIP4j3sz/images/blocks/integrations/chatwoot/website-inbox.png?fit=max&auto=format&n=qJF_uz16fIP4j3sz&q=85&s=6c188424188c4274831d6596282801b8" alt="Create website inbox" width="2356" height="1606" data-path="images/blocks/integrations/chatwoot/website-inbox.png" />
</Frame>

## Setup

Insert a Chatwoot block where you want to trigger the widget:

<Frame>
  <img src="https://mintcdn.com/zazubot/qJF_uz16fIP4j3sz/images/blocks/integrations/chatwoot/options.png?fit=max&auto=format&n=qJF_uz16fIP4j3sz&q=85&s=b1a96f040d44043db8eba7fbc35b2ee2" alt="Chatwoot block" width="1316" height="898" data-path="images/blocks/integrations/chatwoot/options.png" />
</Frame>

To find your website token, head over to Chatwoot in your Inbox settings:

<Frame>
  <img src="https://mintcdn.com/zazubot/qJF_uz16fIP4j3sz/images/blocks/integrations/chatwoot/website-token.png?fit=max&auto=format&n=qJF_uz16fIP4j3sz&q=85&s=6768fb4e8130f7d89a512ceca7047c8e" alt="Find website token" width="2524" height="1624" data-path="images/blocks/integrations/chatwoot/website-token.png" />
</Frame>

You can prefill user information by adding collected variables to the "Set user details" inputs.

For example, if you set the "Email" input to "[john@gmail.com](mailto:john@gmail.com)" then Chatwoot will automatically associate this email to the current user.

## Custom attributes

You can add these custom attributes that zazubot will automatically fill in for you:

### Result URL

You can link the current result URL to the Chatwoot conversation by creating this custom attribute:

<Frame>
  <img src="https://mintcdn.com/zazubot/qJF_uz16fIP4j3sz/images/blocks/integrations/chatwoot/custom-attribute.png?fit=max&auto=format&n=qJF_uz16fIP4j3sz&q=85&s=2c459c485534808ce36b8f270d650a1e" alt="Chatwoot custom attribute" width="1820" height="2114" data-path="images/blocks/integrations/chatwoot/custom-attribute.png" />
</Frame>

### Set user behavior

If you are prefilling user information, by default, if you leave the ID input empty, it will set the Chatwoot user ID as either the `Email` or the Result ID.

Setting the `Email` as the ID allows us to avoid having contact not properly merged together ([https://github.com/chatwoot/chatwoot/issues/2811](https://github.com/chatwoot/chatwoot/issues/2811))
