> 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

Collega il [server MCP](/docs/it/reception-ai/integrations/mcp-server) fornito da Intercom affinché il tuo receptionist possa riconoscere i chiamanti che sono tuoi clienti, verificare le loro conversazioni aperte e rispondere alle domande usando gli articoli del tuo Centro assistenza.

> **Warning**
>
> Le conversazioni possono contenere dettagli privati. Indica al tuo receptionist, nelle sue istruzioni o in una
> [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures), di condividere i dettagli delle conversazioni
> solo dopo aver confermato che il chiamante è il contatto, ad esempio confrontando il numero di telefono o
> l'email.

## Configurazione

### Crea un'app privata

In Intercom, apri l'**Developer Hub** e crea una nuova app per il tuo workspace. Apri l'app e vai su **Configura** → **Autenticazione**, quindi copia il token di accesso.

Verifica che le autorizzazioni dell'app includano la lettura di utenti, aziende e conversazioni, oltre alla lettura degli articoli. Aggiungi la scrittura delle conversazioni solo se vuoi che il tuo receptionist lasci note interne.

### Aggiungi il server MCP

In Reception.ai, vai su **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Server MCP**.

| Campo              | Valore                                        |
| ------------------ | --------------------------------------------- |
| **Nome**           | Intercom                                      |
| **Tipo di server** | HTTP streamable                               |
| **URL del server** | L'URL per la regione del tuo workspace, sotto |
| **Token segreto**  | Il tuo token di accesso                       |

| Regione del workspace                    | URL del server                    |
| ---------------------------------------- | --------------------------------- |
| Stati Uniti (accedi da app.intercom.com) | `https://mcp.intercom.com/mcp`    |
| UE (accedi da app.eu.intercom.com)       | `https://mcp.eu.intercom.com/mcp` |

Seleziona **Abilita**. Reception.ai invia il token come bearer token e mostra gli strumenti di Intercom.

### Assegna gli strumenti

Apri la scheda **Strumenti** e assegna questi strumenti al **Client** (receptionist):

* `search_contacts` e `get_contact`: trovano il chiamante e i suoi dettagli.
* `search_conversations` e `get_conversation`: controllano lo stato delle richieste del chiamante.
* `search_articles` e `get_article`: rispondono alle domande dal tuo Centro assistenza.

Facoltativamente, assegna `add_internal_note` affinché il tuo receptionist possa aggiungere un riepilogo della chiamata alla conversazione del chiamante. Le note sono visibili solo al tuo team. Lascia non assegnati `create_article` e `update_article`.

### Verificalo

[Verifica il tuo receptionist](/docs/it/reception-ai/receptionist/testing) chiamando da un numero salvato in un contatto di test e chiedendo informazioni su una conversazione aperta.

## Limitazioni

Il server MCP di Intercom non supporta i workspace forniti in Australia.

## Risoluzione dei problemi

| Problema                                              | Cosa controllare                                                                                              |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Non sono elencati strumenti                           | Usa il tipo di server **HTTP streamable** e l'URL per la regione del tuo workspace.                           |
| Uno strumento restituisce un errore di autorizzazione | Aggiungi l'autorizzazione mancante all'app nell'**Developer Hub**.                                            |
| Il receptionist non trova un chiamante                | Intercom confronta i numeri di telefono come sono salvati nel contatto. Salva i numeri in un unico formato.   |
| Hai modificato il token                               | Modifica l'integrazione e usa **Ruota token segreto (facoltativo)**. Il token salvato non viene più mostrato. |