Intercom

Overzicht

Koppel je ElevenLabs AI-agents aan Intercom om contacten, gesprekken, tickets en notities te beheren. De integratie ondersteunt twee processen:

Tools: laat een agent contacten opzoeken en bijwerken, gesprekken doorzoeken en beantwoorden, de gesprekslevenscyclus beheren (sluiten, heropenen, toewijzen), gesprekken taggen, tickets maken en beantwoorden en interne notities toevoegen — allemaal vanuit een actief ElevenLabs-gesprek.
Triggers: laat een agent automatisch reageren op nieuwe Intercom-gesprekken en antwoorden van contacten, waarbij reacties als Intercom-admin worden geplaatst.

Mogelijkheden

Mogelijkheid	Ondersteuning
Zero retention mode (ZRM)	Niet ondersteund
Bijlagen in triggers	Niet ondersteund — bijlagen en afbeeldingen in binnenkomende gesprekken worden niet naar de agent doorgestuurd
Bijlagen in tools	Niet ondersteund — tools werken alleen met tekst

Zo werkt de trigger

Wanneer je de trigger Intercom Conversation inschakelt, abonneert ElevenLabs zich op twee Intercom-webhookonderwerpen — één voor nieuwe gesprekken die door een contact worden gestart, en één voor vervolgreacties van een contact. Wanneer Intercom een melding aflevert:

ElevenLabs verifieert de webhookhandtekening aan de hand van het client secret van je app.
Het haalt het volledige gesprek op uit Intercom en koppelt de berichtgeschiedenis aan de geconfigureerde agent.
De agent genereert een antwoord, dat ElevenLabs als de geconfigureerde admin terugplaatst in het gesprek.

Omdat Intercom alleen meldingen verstuurt voor activiteiten van eindgebruikers (niet voor antwoorden van admins), reageert de agent nooit op zijn eigen berichten.

Instellen

Maak een Intercom-app en access token

Open in Intercom Settings → Integrations → Developer Hub en maak een nieuwe app voor ElevenLabs (of open een bestaande app).

Kopieer onder Authentication het Access token — dit is het token voor toegang tot de gegevens van je eigen workspace. Je hebt ook het Client secret nodig op de pagina Basic information; ElevenLabs gebruikt dit om de authenticiteit van elke webhooklevering te verifiëren.

Zoek je Intercom-admin-ID

De agent plaatst antwoorden als Intercom-admin (meestal een speciaal teamgenootaccount). Open Settings → Teammates in Intercom en selecteer de teamgenoot namens wie de agent berichten moet plaatsen. De admin-ID is een numerieke waarde (bijvoorbeeld 1234567) — je kunt deze ook programmatisch ophalen via de API List all admins van Intercom.

Koppel in ElevenLabs

Klik op de ElevenLabs-integratiepagina voor Intercom op Connect en plak het Access token uit Developer Hub.

Schakel de trigger Intercom Conversation in

Open het tabblad Triggers van de Intercom-integratie en schakel Intercom Conversation in. Vul het volgende in:

Agent — de ElevenLabs-agent die binnenkomende Intercom-gesprekken moet afhandelen.
Client secret — de waarde uit Developer Hub → Basic information. Wordt gebruikt om webhookhandtekeningen te verifiëren.
Admin ID — de numerieke admin-ID namens wie de agent antwoorden moet plaatsen.
Team inbox ID (optioneel) — beperk de agent tot één Intercom-teaminbox. Wanneer dit is ingesteld, reageert de agent alleen op gesprekken die momenteel aan dat team zijn toegewezen; laat dit leeg om op alle gesprekken te reageren. Zie de volgende stap om de agent tot een specifieke inbox te beperken.

(Optioneel) Beperk de agent tot een specifieke teaminbox

Als je wilt dat de agent slechts een specifieke subset van gesprekken afhandelt, stuur je die gesprekken naar een specifieke teaminbox en koppel je de trigger daaraan:

Maak in Intercom een Team voor de agent (Settings → Teammates & Teams → Teams), bijvoorbeeld “AI Agent”.
Bouw een Workflow (Fin AI Agent → Workflows) die de gesprekken die je wilt laten afhandelen aan dat team toewijst via een actie Assign → Team (voor Workflows heb je een Advanced-/Expert-abonnement nodig). Verplaats het gesprek bij escalatie van dit team naar een menselijk team.
Haal de numerieke ID van het team op via de API List all teams van Intercom en plak deze in het veld Team inbox ID van de trigger.

Met een geconfigureerde teaminbox negeert de agent elk gesprek dat niet aan dat team is toegewezen.

Intercom wijst het team via je Workflow toe aan het begin van een gesprek. Als een conversation.user.created-webhook wordt afgeleverd voordat de toewijzing is verwerkt, kan dat eerste bericht worden overgeslagen; de agent gaat verder bij het volgende antwoord van het contact. Houd hier rekening mee tijdens het testen.

Abonneer je in Intercom op webhookonderwerpen

Open in Intercom Developer Hub het onderdeel Webhooks van je app en voeg een nieuw abonnement toe dat naar deze URL verwijst:

https://api.elevenlabs.io/v1/convai/api-integrations/intercom/triggers/conversation

Abonneer je op beide volgende onderwerpen:

conversation.user.created — wordt geactiveerd wanneer een eindgebruiker een nieuw gesprek start.
conversation.user.replied — wordt geactiveerd wanneer een eindgebruiker op een bestaand gesprek reageert.

Intercom ondertekent elke webhook met je client secret; ElevenLabs verifieert bij elke levering de header X-Hub-Signature. Leveringen met een ongeldige of ontbrekende handtekening worden stilzwijgend genegeerd.

Controleer de configuratie

Open Intercom Messenger als testcontact (of gebruik de eigen preview van Intercom), stuur een bericht naar je workspace en controleer of de geconfigureerde agent antwoordt als de admin die je hebt geselecteerd. Je kunt het resulterende gesprekstranscript bekijken in de weergave Conversations van ElevenLabs.

Als er geen antwoord komt, controleer dan nogmaals de webhook-URL en het onderwerpabonnement in Developer Hub, en bevestig dat het Access token en Client secret bij dezelfde Intercom-app horen.