{"site":{"name":"Koji","description":"AI-native customer research platform that helps teams conduct, analyze, and synthesize customer interviews at scale.","url":"https://www.koji.so","contentTypes":["blog","documentation"],"lastUpdated":"2026-05-27T06:37:48.326Z"},"content":[{"type":"documentation","id":"8b0efbb4-9bff-4ecc-9190-774eea9c4244","slug":"intercom-research-integration","title":"Intercom + Koji: Run Deep AI Interviews From Your Support and Messaging Workflows","url":"https://www.koji.so/docs/intercom-research-integration","summary":"The Koji + Intercom integration is bidirectional. From Intercom into Koji: any Intercom trigger (conversation closed, tag applied, segment entered, outbound message sent) calls Koji's headless API to start an interview for the contact, and Intercom outbound messages deliver the personalized link inside the messenger surface customers already trust. From Koji back into Intercom: on every interview's `analysis_ready` event, the forwarder updates Intercom custom user attributes (last_interview_sentiment, last_interview_top_theme, last_interview_quality, last_interview_url), adds a private note to the originating conversation with the top theme and transcript link, and optionally applies tags for inbox routing. The result is CS reps who see qualitative context on every conversation, save-the-account segments built on sentiment, and onboarding flows that branch on interview themes. Three integration paths exist: Zapier (no code, 30 min), Intercom Series + serverless forwarder (1 hour), or a custom Intercom Canvas app (production-grade). Available on the Interviews plan (€79/mo) and Enterprise; the Zapier path works on any plan. Best applied at post-resolution moments, end-of-onboarding, churn signals, feature adoption nudges, and trial midpoints.","content":"# Intercom + Koji: From Support Conversations to Deep Customer Insight\n\n**Answer first:** Intercom is where your customers talk to your team. Koji is where the same customers go deeper in an AI-moderated conversation that produces structured themes, sentiment, and quotes you can actually act on. The integration pattern is bidirectional: (1) trigger a Koji interview link from any Intercom conversation — after a ticket closes, after a successful onboarding, or as an outbound message to a segment — and (2) pipe each completed Koji interview's themes, sentiment, quality score, and a link back to the transcript into Intercom as custom user attributes and a conversation note. End-to-end this takes about 30 minutes via Intercom's outbound messages + Koji's headless API, or under an hour with no code via Zapier. With tools like Koji, the team that already lives in Intercom inbox can finally hand customers a 5-minute conversational interview that does the work of a 30-minute scheduled call.\n\nIf your CS, support, or product team already trusts Intercom as the customer surface, this is the integration that turns *every closed ticket into a research data point* without asking the customer to do anything more than tap a link.\n\n## Why combine Intercom and Koji\n\nIntercom is the most common customer messaging surface in B2B SaaS — chat, email, in-app messages, ticketing, all in one inbox. Intercom's built-in surveys are fine for a one-question NPS or CSAT, but they hit a wall the moment you want depth:\n\n- They cannot follow up on a vague answer. \\\"It's fine\\\" is the end of the data.\n- They do not produce themes — you get a list of free-text responses and a human has to read every one.\n- They do not score quality, so a one-word junk response weighs the same as a thoughtful paragraph.\n- They cannot conduct a 5-10 minute conversational interview without losing the participant midway through.\n\nKoji solves all four. AI-moderated interviews probe vague answers ([AI probing guide](/docs/ai-probing-guide)), generate themes automatically ([understanding themes and patterns](/docs/understanding-themes-patterns)), score each conversation for quality ([understanding quality scores](/docs/understanding-quality-scores)), and routinely sustain 70-85% completion rates on 5-10 minute conversations because the AI keeps the conversation natural.\n\nThe integration plugs Koji into the moments Intercom already owns: the end of a support ticket, a successful onboarding, a feature-discovery message, a churn signal in chat.\n\n## What flows in each direction\n\n### Intercom → Koji (trigger interviews from messaging moments)\n\n- An Intercom event fires: a conversation closes with a CSAT score, a user enters a segment, an outbound message is sent.\n- An Intercom webhook (or a Series step) calls your forwarder with the user's email and the Intercom conversation ID.\n- The forwarder calls Koji's headless API to start an interview for that respondent ([starting interviews via API](/docs/starting-interviews-via-api)).\n- The forwarder also posts a follow-up message in Intercom containing the personalized Koji interview link — so the participant taps it without leaving the Intercom messenger surface they already trust.\n\n### Koji → Intercom (pipe insights back as user attributes + notes)\n\nWhen each Koji interview reaches `analysis_ready`, the webhook payload includes themes, sentiment, quality score, and a transcript URL. Your forwarder updates Intercom:\n\n- **As custom user attributes** — `last_interview_at`, `last_interview_sentiment`, `last_interview_top_theme`, `last_interview_quality`, `last_interview_url`.\n- **As a note on the originating conversation** — a short summary with the top theme, sentiment, and link to the full transcript, so the next CS rep to open the ticket has the qualitative context one click away.\n- **Optional: as a tag** — apply Intercom tags like `koji_negative_sentiment` or `koji_pricing_friction` so the inbox auto-routes future conversations from that user to the right human.\n\nOnce that data lands, Intercom segments can use the new attributes — for example, \\\"all users with `last_interview_sentiment = negative` in the last 30 days\\\" becomes a save-the-account playbook your CS team can run weekly.\n\n## Step 1 — Pick the moments worth triggering an interview\n\nNot every Intercom interaction deserves a research follow-up. The highest-leverage moments are:\n\n- **Post-resolution on a major issue.** After a 24-hour bug or billing escalation closes, send a Koji interview that asks: \\\"Walk me through what you were trying to do when this went wrong. What were you about to do next?\\\" That is a churn-prevention conversation worth running.\n- **End of onboarding.** After a user completes the onboarding flow, ask them about their expectations vs. reality. See [user onboarding research](/docs/user-onboarding-research).\n- **Detected churn signal.** When a high-value account stops responding or downgrades, route a Koji interview before they cancel. See [cancel-flow exit interviews](/docs/cancel-flow-exit-interview) and [win-back customer interviews](/docs/win-back-customer-interviews).\n- **Feature adoption nudge.** When a user starts using a new feature, queue a Koji interview 7 days later asking what they think. See [feature adoption research](/docs/feature-adoption-research).\n- **Post-demo or trial midpoint.** Outbound an interview at the trial midpoint to surface friction before the conversion deadline.\n\nFor each pattern, the [customer success interview guide](/docs/customer-success-interview-guide) and [B2B customer research](/docs/b2b-customer-research-ai-interviews) docs cover the methodology side.\n\n## Step 2 — Trigger Koji interviews from Intercom\n\nThree paths, in order of complexity:\n\n### Path A: Zapier or Make (no code, ~30 minutes)\n\n1. **Trigger:** Intercom → Conversation Closed (or any of Intercom's native triggers — new user, tag applied, segment entered).\n2. **Action:** Koji → Start Interview, passing the user's email.\n3. **Action:** Intercom → Send Outbound Message, containing the Koji interview link.\n\nSee [Zapier research automation](/docs/zapier-research-automation) for the connector reference.\n\n### Path B: Intercom Series + serverless forwarder (~1 hour)\n\nIntercom Series lets you build multi-step automations triggered by user behavior. Add a custom HTTP step that POSTs to your forwarder, which calls Koji's [start interview API](/docs/starting-interviews-via-api) and returns the interview URL. A subsequent Series step uses that URL in an outbound chat message.\n\nThis path keeps the participant entirely inside Intercom's messenger — the interview link opens Koji in a tab, but the invitation feels native to the customer's existing conversation thread.\n\n### Path C: Intercom Apps Framework (production-grade)\n\nFor teams investing heavily in Intercom inbox workflows, build a small Intercom Canvas app that adds a \\\"Send Koji interview\\\" button to the inbox sidebar. A teammate handling a conversation taps the button to queue an interview without leaving the inbox. This is the cleanest pattern for CS-led research programs.\n\nFor any path, the [user research API guide](/docs/user-research-api-guide), [API authentication](/docs/api-authentication) doc, and [managing research participants](/docs/managing-research-participants) doc cover the credential and audience basics.\n\n## Step 3 — Pipe Koji results back into Intercom\n\nSubscribe to Koji's `interview.analysis_ready` event (full reference in [webhook setup](/docs/webhook-setup)). Your forwarder:\n\n1. **Verifies the Koji HMAC signature.**\n2. **Calls Intercom's API** with three writes:\n   - `PUT /contacts/{id}` — set or update custom attributes like `last_interview_sentiment`.\n   - `POST /conversations/{id}/reply` (admin note) — add a brief private note to the originating conversation with the top theme and a transcript link.\n   - `POST /conversations/{id}/tags` (optional) — apply tags based on theme or sentiment for inbox routing.\n3. **Handles anonymous interviews.** When `respondent_email` is null, skip the Intercom write entirely — there is no contact to attach to.\n\nThe full round-trip — interview completes, Koji analyzes, webhook fires, Intercom updates — typically lands in under 5 minutes from the participant tapping \\\"submit.\\\"\n\n## What you can build in Intercom once the data lands\n\n- **Sentiment-driven inbox routing.** Conversations from users with `last_interview_sentiment = negative` auto-route to senior CSMs instead of front-line support.\n- **Save-the-account segments.** A dynamic segment \\\"users whose `last_interview_top_theme = pricing` and `last_interview_sentiment = negative`\\\" becomes a weekly outreach list.\n- **Onboarding personalization.** Outbound onboarding messages branch based on `last_interview_top_theme` so the next message addresses the friction the customer just told you about.\n- **Inbox context for every rep.** The Koji interview summary lives as a note on the originating conversation, so any rep who opens it sees the qualitative context without leaving Intercom.\n- **Tag-based reporting.** Intercom's reporting can show conversation volume by Koji-generated tag, giving CS leadership a view of which interview themes are tied to the most support load.\n\n## Comparison: Koji + Intercom vs. Intercom Surveys alone\n\nIntercom's native Surveys product is fine for a one-question CSAT or a quick NPS. The moment you want more, you hit limits:\n\n- **Intercom Surveys cannot probe.** A free-text question gets one shot at an answer. Koji's AI moderator probes vague answers and routinely turns \\\"it's fine\\\" into a paragraph of specifics. ([AI probing guide](/docs/ai-probing-guide).)\n- **Intercom Surveys do not generate themes.** You get a list of responses. Koji surfaces themes, sentiment, and representative quotes automatically. ([Understanding themes and patterns](/docs/understanding-themes-patterns).)\n- **Intercom Surveys do not score quality.** Every response is treated equal. Koji scores each conversation 1-5 and you can keep only quality 3+ from flowing back into Intercom attributes. ([Understanding quality scores](/docs/understanding-quality-scores).)\n- **Intercom Surveys lock you into form logic.** Koji's six structured question types (open_ended, scale, single_choice, multiple_choice, ranking, yes_no — see [structured questions guide](/docs/structured-questions-guide)) plus open-ended conversation flow give you depth and structure in the same conversation.\n- **Voice mode.** Intercom Surveys are text-only. Koji supports voice interviews with the same AI moderator pattern when you want richer responses ([voice vs text interviews](/docs/voice-vs-text-interviews)).\n\nIntercom Surveys remain the right tool for a one-question pulse. The integration above adds Koji for anything that needs depth without losing the Intercom workflow your team already runs.\n\n## Plan requirements and cost\n\nWebhooks and the headless API are included on the Interviews plan (€79/month, 79 credits) and Enterprise. The Insights plan (€29/month) doesn't include webhooks — for that tier, the Zapier path works on any plan. Text interviews cost 1 credit, voice interviews cost 3, and only conversations scoring 3 or higher on Koji's quality gate consume credits. See [plan comparison guide](/docs/plan-comparison-guide).\n\nA typical post-ticket research program — every closed conversation with CSAT ≤ 7 gets a Koji interview, ~50/week for a mid-stage SaaS — uses around 30-50 credits per week if running text. That fits inside the Interviews plan with room to spare.\n\n## Identity, consent, and what stays in Intercom\n\nFor a closed-loop CS research program, identity flows naturally: the Intercom contact's email is the Koji `respondent_email`, the round trip uses email as the join key. For sensitive research topics, run the study in anonymous mode and skip the Intercom write — see [anonymizing customer interview data](/docs/anonymizing-customer-interview-data).\n\nWhat lives in Intercom after the integration runs is intentional and minimal: themes, sentiment, quality, an attribute timestamp, and a link to the full transcript. The transcript itself stays in Koji. That keeps Intercom out of scope for anything that classifies raw interview transcripts as sensitive data, while still giving the CS team enough context to act.\n\nFor regulated industries, see [GDPR-compliant AI user research](/docs/gdpr-compliant-ai-user-research) and [HIPAA-compliant AI user research](/docs/hipaa-compliant-ai-user-research).\n\n## A 30-minute first run\n\nThe fastest way to test the loop:\n\n1. In Koji, create a 5-question study targeting \\\"customers whose last support ticket was resolved in the past 48 hours.\\\" Publish.\n2. In Intercom, pull a list of contacts who match that filter (about 20-30 for a mid-stage SaaS in a typical week).\n3. Use Koji's [CSV participant import](/docs/importing-participants-csv) to load them — no integration code yet.\n4. Send the personalized Koji links via an Intercom outbound message.\n5. Within 48 hours you'll have themes, sentiment, and quotes in the [insights dashboard](/docs/insights-dashboard). If the signal is useful, wire up the webhook → Intercom forwarder so future studies are automated.\n\nThis manual first run is usually enough to convince a skeptical CS lead that the Intercom-Koji loop is worth the engineering cost of full automation.\n\n## Related Resources\n\n- [Structured Questions Guide](/docs/structured-questions-guide) — the six question types that ride along on every Intercom attribute update.\n- [Salesforce Research Integration](/docs/salesforce-research-integration) — sister guide for CRM-side closed-loop research.\n- [HubSpot Research Integration](/docs/hubspot-research-integration) — same pattern, mapped to HubSpot CRM.\n- [Webhook Setup](/docs/webhook-setup) — full reference for Koji webhook events and HMAC signature verification.\n- [Zapier Research Automation](/docs/zapier-research-automation) — no-code path for the same integration.\n- [Customer Success Interview Guide](/docs/customer-success-interview-guide) — methodology for the CS-led research programs this integration powers.\n- [Cancel-Flow Exit Interviews](/docs/cancel-flow-exit-interview) — what to ask the customers about to leave.\n- [Real-Time Research Insights](/docs/real-time-research-insights) — how themes appear in Koji as conversations complete.","category":"API Reference","lastModified":"2026-05-27T02:07:11.363418+00:00","metaTitle":"Intercom + Koji Integration: Deep AI Interviews From Support Conversations","metaDescription":"Trigger Koji AI-moderated interviews from Intercom conversations and outbound messages, then sync themes, sentiment, and quality back as Intercom user attributes and conversation notes.","keywords":["intercom integration","intercom customer interviews","intercom user research","intercom survey alternative","customer success research","support ticket research","intercom ai survey","intercom webhook"],"aiSummary":"The Koji + Intercom integration is bidirectional. From Intercom into Koji: any Intercom trigger (conversation closed, tag applied, segment entered, outbound message sent) calls Koji's headless API to start an interview for the contact, and Intercom outbound messages deliver the personalized link inside the messenger surface customers already trust. From Koji back into Intercom: on every interview's `analysis_ready` event, the forwarder updates Intercom custom user attributes (last_interview_sentiment, last_interview_top_theme, last_interview_quality, last_interview_url), adds a private note to the originating conversation with the top theme and transcript link, and optionally applies tags for inbox routing. The result is CS reps who see qualitative context on every conversation, save-the-account segments built on sentiment, and onboarding flows that branch on interview themes. Three integration paths exist: Zapier (no code, 30 min), Intercom Series + serverless forwarder (1 hour), or a custom Intercom Canvas app (production-grade). Available on the Interviews plan (€79/mo) and Enterprise; the Zapier path works on any plan. Best applied at post-resolution moments, end-of-onboarding, churn signals, feature adoption nudges, and trial midpoints.","aiPrerequisites":["Intercom workspace with Series or outbound messages enabled","Koji account on Interviews plan or higher for webhook automation","Basic familiarity with Intercom triggers and no-code tools or webhooks"],"aiLearningOutcomes":["Trigger Koji AI interviews from Intercom conversations and segments","Sync themes, sentiment, and quality back as Intercom user attributes and conversation notes","Choose the right integration path for your team (Zapier, Series, or Canvas app)","Route inbox conversations based on Koji-generated tags","Build save-the-account and onboarding flows that branch on interview themes"],"aiDifficulty":"intermediate","aiEstimatedTime":"18 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}