> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Intercom

Koppel de gehoste [MCP server](/docs/nl/reception-ai/integrations/mcp-server) van Intercom, zodat je receptionist bellers die klant zijn kan herkennen, hun openstaande gesprekken kan controleren en vragen kan beantwoorden met artikelen uit je Help Center.

> **Warning**
>
> Gesprekken kunnen privédetails bevatten. Instrueer je receptionist via de instructies of een
> [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) om gespreksdetails alleen te delen
> nadat is bevestigd dat de beller de contactpersoon is, bijvoorbeeld door het telefoonnummer of
> e-mailadres te vergelijken.

## Instellen

### Maak een privé-app

Open in Intercom de **Developer Hub** en maak een nieuwe app voor je workspace. Open de app, ga naar **Configure** → **Authentication** en kopieer vervolgens het access token.

Controleer of de machtigingen van de app toegang bevatten voor het lezen van gebruikers, bedrijven en gesprekken, plus het lezen van artikelen. Voeg alleen schrijfrechten voor gesprekken toe als je wilt dat je receptionist interne notities achterlaat.

### Voeg de MCP server toe

Ga in Reception.ai naar **Integrations**, selecteer **Add integration** en kies **MCP Server**.

| Veld             | Waarde                                           |
| ---------------- | ------------------------------------------------ |
| **Name**         | Intercom                                         |
| **Server type**  | Streamable HTTP                                  |
| **Server URL**   | De URL voor de regio van je workspace, hieronder |
| **Secret Token** | Je access token                                  |

| Workspaceregio                          | Server-URL                        |
| --------------------------------------- | --------------------------------- |
| VS (je logt in via app.intercom.com)    | `https://mcp.intercom.com/mcp`    |
| EU (je logt in via app.eu.intercom.com) | `https://mcp.eu.intercom.com/mcp` |

Selecteer **Enable**. Reception.ai verstuurt het token als bearer token en toont de tools van Intercom.

### Wijs tools toe

Open het tabblad **Tools** en wijs deze toe aan de **Client** (receptionist):

* `search_contacts` en `get_contact`: zoek de beller en diens gegevens.
* `search_conversations` en `get_conversation`: controleer de status van de verzoeken van de beller.
* `search_articles` en `get_article`: beantwoord vragen met je Help Center.

Wijs eventueel `add_internal_note` toe, zodat je receptionist een samenvatting van het gesprek kan toevoegen aan het gesprek van de beller. Notities zijn alleen zichtbaar voor je team. Laat `create_article` en `update_article` niet toegewezen.

### Test het

[Test je receptionist](/docs/nl/reception-ai/receptionist/testing) door te bellen vanaf een nummer dat is opgeslagen bij een testcontact en naar een open gesprek te vragen.

## Beperkingen

De MCP server van Intercom ondersteunt geen workspaces die in Australië worden gehost.

## Problemen oplossen

| Probleem                                   | Controleer                                                                                                                |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Er worden geen tools weergegeven           | Gebruik het servertype **Streamable HTTP** en de URL voor de regio van je workspace.                                      |
| Een tool geeft een machtigingsfout terug   | Voeg de ontbrekende machtiging toe aan de app in de **Developer Hub**.                                                    |
| De receptionist kan een beller niet vinden | Intercom vergelijkt telefoonnummers zoals ze bij het contact zijn opgeslagen. Sla nummers in één indeling op.             |
| Je hebt het token gewijzigd                | Bewerk de integratie en gebruik **Rotate Secret Token (optional)**. Het opgeslagen token wordt nooit opnieuw weergegeven. |