Berner Setterwall3 min read

    Hotjar Is Live in Cogny: Survey Answers and NPS for Your Agent

    Your analytics say the checkout page loses half its visitors. Your Hotjar survey on that page says why, in the visitors' own words. Hotjar is now a live MCP integration in Cogny, so the agent that reads your funnel can also read what people told you about it.

    An API key and a Site ID, no app to install.


    TL;DR

    • Live now, included from Cogny Solo ($9/mo). Hotjar's API itself needs a Hotjar Ask Scale plan.
    • 5 read-only tools: list_sites, list_surveys, get_survey, list_survey_responses, summarize_survey_responses.
    • Results worked out for you: NPS with promoters, passives and detractors; rating averages and distributions; counts per choice; Hotjar's sentiment and tags; devices, countries and the pages responses came from.
    • Every answer as given, with the page it was submitted on, device, country, user attributes you send to Hotjar, and a link to the recording when there is one.
    • Nothing changes in Hotjar: surveys can't be created, edited or paused from Cogny.

    What you can ask

    ToolWhat it does
    list_sitesThe Hotjar sites on the connection, and whether each one answers.
    list_surveysSurveys on a site, with their type (popover, full screen, link) and whether they're live.
    get_surveyOne survey with its questions, answer choices and rating labels.
    list_survey_responsesEvery response, newest first: answers, comments, sentiment, tags, page, device, country, recording link.
    summarize_survey_responsesNPS, ratings, choices, sentiment and tags per question for up to 2,000 of the newest responses, plus sample open-text answers.

    Questions this answers in one prompt:

    • "What's our NPS this month, and what do detractors complain about?"
    • "On the exit survey, which reason for leaving comes up most on mobile?"
    • "Which pages do the negative answers come from?"
    • "Pull every answer that mentions shipping cost and suggest a test for the checkout page."

    With GA4 or your ad platforms in the same workspace, the agent can put what people said next to what they did: the landing page with the worst feedback and the campaigns sending traffic to it.

    How to connect it

    1. In Hotjar, as an organization Admin, open Settings → API.
    2. Pick the organization, name the credential and click Generate credentials. Copy the Client ID and Client Secret.
    3. Copy the Site ID from Sites & Organizations.
    4. In Cogny, open Settings → Integrations, click Connect on Hotjar and paste all three.

    The Client Secret is stored encrypted and only ever sent to Hotjar. Hotjar API keys expire after one year; when that happens Cogny asks you to reconnect, and you paste in a new key.

    What it doesn't do

    Hotjar's API covers surveys only. Heatmaps, session recordings, funnels and feedback widgets aren't in it, so the agent can't read them. Responses can't be filtered by date in the API, so the agent reads newest first and stops when it has covered the period you asked about. The full list of tools and gaps is on the Hotjar tools page.


    Connect it from your Cogny dashboard and ask what your last survey really said.