DocsOpen Henkan Chat
Connectors

Henkan Vision

Connect Henkan Vision, Henkan's session replay, with an API key. Steps, example questions, sessions and frustration tools, limits and troubleshooting.

Up to date with v1.5.4Updated 26 October 20262 min read

Henkan Vision is Henkan's session replay. Connected to Chat, it lets Henkan find sessions, read their timelines and summarise frustration, with replay links you can open.

Before you start#

FieldWhere to find it
API keyIn Henkan Vision: the API page › create a key. It starts with hv_live_.

Connect#

Connecting Henkan Vision with an API key.
1
Name. Helps you recognise this connection.
2
Help text. Where to create the key in Henkan Vision.
3
Test and save. Checks the key before storing it.
  1. Open Tools In the sidebar, select Tools, then select Henkan Vision and Connect.
  2. Paste the key Enter the API key.
  3. Select Test and save The key is checked, then stored encrypted.

What you can ask#

  • "What frustrates visitors most on maison-exemple.com this month?"
  • "Show mobile sessions with rage clicks on the checkout yesterday."
  • "Walk me through session 8f2c…: where did the visitor get stuck?"

What Chat can and can't do#

ToolWhat it doesRead or writeAsks first?
Find siteFinds Vision sites by name or domain.ReadNo
List sessionsSearches sessions by date, page, device, rage or dead clicks, errors or conversion. Returns ids and replay links.ReadNo
Get sessionOne session's timeline: pages, clicks, scroll, pauses and errors with timestamps, frustration tags, the AI summary if any, and the replay link.ReadNo
Frustration summaryQualified sessions, friction and conversion rates, top friction types and the largest recurring patterns over 30 days.ReadNo
Page heatmapReturns the friction patterns recorded on a page, because Vision's API has no heatmap aggregates yet.ReadNo

When Vision is connected, Henkan prefers it for behaviour questions. It cites session ids, timestamps and replay links.

Limits and good to know#

  • No heatmaps yet through the API. Henkan says so.
  • No country or test-variant filters yet when searching sessions.
  • Visitor content is untrusted. Text recorded from visitors' pages is treated as data; Henkan never follows instructions found in it.
  • Costs and who pays. Your Henkan plan covers the AI requests: each question counts towards your organisation's requests (see Usage and limits).

Troubleshooting#

Error or symptomFix
Henkan Vision rejected the credentialsCreate a new key on Vision's API page. It must start with hv_live_.
A site isn't foundUse its name or domain as shown in Vision.
No sessions matchWiden the dates or remove a filter.