Additional information about a contact is always useful. The Chatwoot Website SDK ensures that you can send additional information that you have about the user.
If you have installed our code on your website, the SDK would expose
In order to make sure that the SDK has been loaded completely, please make sure that you listen to
chatwoot:ready event as follows:
To hide the bubble, you can use the setting mentioned below.
Note: If you use this, then you have to trigger the widget by yourself.
Chatwoot support 2 designs for for the widget
- Standard (default)
- Expanded bubble
If you are using expanded bubble, you can customize the text used in the bubble by setting
launcherTitle parameter on chatwootSettings as described below.
Inorder to enable the popout window, add the following configuration to
chatwootSettings. This option is disabled by default.
setUser accepts an identifier which can be a
user_id in your database or any unique parameter which represents a user. You can pass email, name, avatar_url as params. Support for additional parameters is in progress.
Make sure that you reset the session when the user logs out of your app.
To disallow impersonation and to keep the conversation with your customers private, we recommend setting up the identity validation in Chatwoot. Identity validation is enabled by generating an HMAC(hash based message authentication code) based on the
identifier attribute, using SHA256. Along with the
identifier you can pass
identifier_hash also as shown below to make sure that the user is correct one.
To generate HMAC, read identity validation
Inorder to set additional information about the customer you can use customer attributes field.
To set a custom attributes call
setCustomAttributes as follows
You can view these information in the sidepanel of a conversation.
To delete a custom attribute, use
deleteCustomAttribute as follows
To set the language manually, use the
Please note that the labels will be set on a conversation if the user has not started a conversation. In that case, the following items will not have any effect: