DocsOpen Henkan Chat
Connectors

Connect your tools

Give Henkan live access to your analytics, testing, behaviour and feedback tools, and choose what it may do with each one.

Up to date with v1.5.4Updated 30 October 20265 min read

Connect your tools once, and Henkan answers with your real numbers. Each connector links Henkan Chat to one account in one tool, such as your Google Analytics account or a Kameleoon workspace, with that account's own permissions.

In the Acme demo workspace, every connector is already connected to fictional data and can't be changed.

The Tools page, with sample data.
1
Connected tools. They come first, with a green dot.

Connect a suggested tool#

The Tools page shows your whole stack on one page: connected tools first, then one section per family: Analytics, Experimentation, Behaviour and VoC, CRM and engagement, Tags and consent, Acquisition and Workspace.

  • Connected tools come first, with a green dot.
  • Other tools are grouped by family below.
  • The search box narrows the page.
  • Sign in again shows in amber on the tile of a tool that needs signing in again.
  1. Open Tools In the sidebar, select Tools.
  2. Select a tool Its panel opens, with its status, what Henkan does with it and how to connect it.
  3. Select Connect For tools with several connection methods, a dialog lets you choose one (see below).
  4. Sign in or enter credentials Depending on the tool, a sign-in window opens or a form asks for API credentials (see the table below).
  5. Check the result The tool turns solid on the map and its panel shows the connection as Connected, with its tools loaded.
How it connectsTools
Sign-in windowGoogle Analytics 4, Search Console, Google Tag Manager, Slack, Notion, and the official MCP connectors: Optimizely, MoEngage, Meta Ads, Amplitude, Fullstory, Klaviyo, Braze, Air360, Commanders Act, Tealium, HubSpot and Salesforce.
API credentialsKameleoon, Wingify, Contentsquare, Qualtrics, Microsoft Clarity, Piano Analytics, AB Tasty, BigQuery, Didomi, Hotjar and Henkan Vision.
Something firstCommanders Act asks for the address it sent you, and Salesforce for your External Client App's keys, before the sign-in. Adobe Analytics uses server-to-server credentials. OneTrust needs no sign-in.

Credentials are tested before they are saved. If the test fails, the dialog shows the error and nothing is saved.

A small Max badge on a logo marks a premium connector your plan doesn't include (BigQuery, Adobe Analytics, Salesforce, Optimizely, your own MCP servers). Its panel explains how to switch to Max or to try it, with a Talk to Henkan link. On the Free plan an organisation can hold 2 connections: after that the page shows Your Free plan includes 2 tools. with a Talk to Henkan link, and your connections stay as they are. See Requests and plans.

Choose a connection method#

Add another Contentsquare account from the Accounts block.
1
Accounts. Your connected accounts, then the methods to add another; a green chip marks one in use.
2
Manage. Opens the methods to add an account or pick another method.

Contentsquare, Kameleoon and Notion can be connected in two ways. You can use both at once; Henkan picks the right one for each question. Once a tool is connected, its card shows a green chip per method in use and its button becomes Manage, which opens the same dialog.

ToolMethodBest for
ContentsquareOfficial connection (MCP) (recommended), signed in with your Contentsquare accountJourneys, funnels, frustration and rage clicks, errors, page comparison. A Contentsquare admin must enable MCP. Analytics calls count against your Contentsquare plan quota.
ContentsquareMetrics API, with API credentialsKPIs, zones, Web Vitals, diagnosis and audit, without using the MCP quota.
KameleoonAutomation API (credentials) (recommended)Results with Henkan's statistics, SRM, breakdowns, audits, pause or stop with approval.
KameleoonOfficial connection (MCP)Variation code and Kameleoon's own tools.
NotionConnect Notion (recommended)Read pages and databases, write with approval.
NotionNotion MCP (advanced)Notion AI search.

Enter API credentials#

Connecting Microsoft Clarity with an API token.
1
Name. Helps you recognise this connection.
2
Help text. Where to find each value in the tool.
3
Test and save. Checks the credentials before storing them.

Each field explains where to find the value in the tool. Credentials are stored encrypted and are never shown again, not even to you; to change them, disconnect and connect again.

Each tool's page lists the values it needs: see Supported tools.

Manage your connectors#

Connectors belong to your organisation: every member can use them, and only organisation owners can add, rename, sign in again, refresh or disconnect them. Members see the list without these buttons, with a note saying so. The top of the page shows your role, for example Your role in Maison Exemple: Member · Role managed by Henkan: roles are decided by Henkan in Henkan Account, so ask your Henkan contact if you need to become an owner.

Some connections act as you rather than as your company, such as Slack. They are marked Just for you:

  • Only you can see and use them, in chats, flows, Slack and other AI tools, even inside your organisation.
  • Organisation owners cannot use or change them.
  • Any member can connect their own, and manages it themselves.
Advanced settings of a Kameleoon connection.
1
Group setting. One approval setting for each group of tools.
2
Can act. Tools that publish always ask for approval.
3
Tool by tool. Switches a single tool on or off.
4
Account actions. Rename, test the connection, refresh its tools or disconnect.

Select a connected tool to open its panel: its status, what Henkan does with it and its last uses. Advanced settings holds the permissions, each account (name, connection method and account, number of tools) and the actions below. When a connection stops working, the panel offers Reconnect.

Status in the panelMeaningWhat to do
All goodReady to use. The tile says Connected.Nothing.
Sign in againThe sign-in expired or was revoked. The tile says Sign in again.Select Sign in again, or paste a new token for token-based servers.
One account stopped respondingOne of the tool's accounts failed its last check.Open Advanced settings and select Test connection. If it keeps failing, disconnect and connect again.
Setting upThe connection was just created and is not verified yet.Finish the sign-in, then Test connection.
ActionWhat it does
RenameChanges the name shown in Henkan Chat. It does not change anything in the tool.
Refresh tools / Test connectionChecks the connection and reloads its list of tools.
Sign in againOpens the tool's sign-in window again, for connections that use a sign-in. For Notion, Share more pages reopens Notion's page picker.
DisconnectDeletes the connection and its saved credentials. For Google, Henkan also revokes its access where possible.

Choose which tools Henkan may use#

Open a tool's Advanced settings to see its tools. These settings apply to every conversation and flow in the organisation, and only owners can change them.

GroupWhat its tools do
Read your dataLook at data and change nothing.
Prepare changesChange data, or prepare drafts nobody sees yet.
PublishMake changes visible to visitors or colleagues.

Each group has one approval setting. To switch a single tool on or off, or set it apart, open Tool by tool under the groups.

SettingEffect
Switch onHenkan may use the tool.
Switch offHenkan never sees the tool.
Always allowHenkan runs the tool without asking. Default for tools that only read data.
Ask before runningAn approval card appears in the chat first. See Approve actions.
Always asks (changes data)Shown instead of the setting for tools that change data. They always ask.

To keep a whole connection out of one conversation only, use Tools in the message box instead. See Ask a question.

Slack settings#

The Slack connection has extra settings for talking to Henkan from Slack. See Henkan in Slack.