Cognigy has integrated Chatwoot as an additional handover provider that can be used by our customers to connect their users with real agents (in third-party sources). Chatwoot is an open-source solution and free to use. You can read more about Agent Handover here.
To start using Chatwoot as a handover provider with Cognigy.AI, you first have to sign in to Chatwoot here: https://www.chatwoot.com.
Running Chatwoot On-Premise
You can also set up Chatwoot to run on an On-Premise environment. You can read more about that here
Add webhook while creating the inbox¶
You need to configure the webhook Inbox for incoming messages.
Click on Inboxes in the main menu on the Chatwoot homepage
Click on Add Inbox to start the Inbox creation and configuration procedure
Create API Channel
Choose the API channel and enter a channel name
Enter the Endpoint Base URL in the "Webhook URL" line and append /handover/chatwoot/ to the end of the URL (e.g. for example https://endpoint-trial.cognigy.com/handover/chatwoot)
Click on Create API Channel
Select the Agent who will be assigned to the Inbox messages, then confirm with a click on the "Add agents" button.
The new channel will be added to the Chatwoot Inbox.
You need two numbers that are listed in the Chatwoot address line:
- Account ID (is unique for you as the user)
- Inbox ID (is not unique and will be created newly with every new channel)
Both IDs are required to use the new Inbox channel.
Chatwoot Account ID (red marked in the Chatwoot address line)
Chatwoot Inbox ID (red marked in the Chatwoot address line)
Connect Chatwoot to Cognigy.AI¶
In the Handover Node in Cognigy.AI, you can specify to which Inbox you want the handover to start in.
You need to configure this by opening the Handover Node, opening the Chatwoot Settings menu, and filling in the Inbox ID.
Dynamically setting the Inbox ID
You can use CognigyScript to dynamically decide which Inbox should be used for the handover request
Now we need to connect the Endpoint to Chatwoot. To do this, open the Endpoint Editor and open the Handover Settings section.
Enter following data -- Select Chatwoot as Handover Platform -- Select BaseUrl as shown (e.g.
https://app.chatwoot.com/api/v1or your on-premise Chatwoot API URL) -- Enter Chatwoot Account ID -- Enter the API Key (use copy and paste - you will find the key in Chatwoot in your Profile Settings in AccessToken - use the Copy button)
Click on Save to confirm the entries
Click on "Open Webchat" and start a conversation
When you start a conversation with the Endpoint and trigger the Handover Node, then an Agent Handover will be started with Chatwoot (you will find a handover message in the Chatwoot Inbox)
On the left-hand side the user messages are displayed - on the right-hand side the connected real agent replies are displayed in Chatwoot.
When a User request is answered and solved by the agent, the agent can Resolve the connection and if a further request will come in from the user side the agent can Reopen the connection in Chatwoot to be able to reply to the request.
Supported message content¶
Using the Chatwoot integration the user can receive
- text messages
- videos (mp4, ...)
- images ( jpg,png,... see example below)
- animated gifs
Agents in Chatwoot¶
In case you want to add a new Agent to Chatwoot go to the Chatwoot homepage and click on the Agents menu item.
Chatwoot API updated¶
With Cognigy.AI 4.10.0 the Chatwoot API has been updated due to the implementation with Cognigy Live Agent (new color, chat history).
Chatwoot API updated to version 1.19.0.
Support of custom agent bot name (config-map: AGENT_BOT_NAME).
Support of custom agent bot description (config-map: AGENT_BOT_DESCRIPTION).
Message history of a conversation is available.
Messages in the Chatwoot dashboard appear in a new theming / styling.