2
0
Files
bot/apps/docs/editor/blocks/integrations/chatwoot.mdx
2023-12-22 09:13:53 +01:00

62 lines
1.7 KiB
Plaintext

---
title: 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 typebot.
## Requirements
For this integration, you need a Chatwoot account and create a "Website" inbox:
<Frame>
<img
src="/images/blocks/integrations/chatwoot/website-inbox.png"
alt="Create website inbox"
/>
</Frame>
## Setup
Insert a Chatwoot block where you want to trigger the widget:
<Frame>
<img
src="/images/blocks/integrations/chatwoot/options.png"
alt="Chatwoot block"
/>
</Frame>
To find your website token, head over to Chatwoot in your Inbox settings:
<Frame>
<img
src="/images/blocks/integrations/chatwoot/website-token.png"
alt="Find website token"
/>
</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" then Chatwoot will automatically associate this email to the current user.
## Custom attributes
You can add these custom attributes that Typebot 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="/images/blocks/integrations/chatwoot/custom-attribute.png"
alt="Chatwoot custom attribute"
/>
</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)