> 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

## Panoramica

Collega i tuoi agenti IA di ElevenLabs a Intercom per gestire contatti, conversazioni, ticket e note. L'integrazione supporta due flussi:

* **Strumenti**: consentono a un agente di cercare e aggiornare contatti, cercare conversazioni e rispondere, gestire il ciclo di vita delle conversazioni (chiudere, riaprire, assegnare), aggiungere tag alle conversazioni, creare ticket e rispondere, nonché aggiungere note interne, tutto dall'interno di una conversazione ElevenLabs in corso.
* **Trigger**: consentono a un agente di rispondere automaticamente a nuove conversazioni Intercom e alle risposte dei contatti, pubblicando come amministratore Intercom.

## Funzionalità

| Funzionalità                     | Supporto                                                                                                   |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Modalità a ritenzione zero (ZRM) | Non supportata                                                                                             |
| Allegati nei trigger             | Non supportati — gli allegati e le immagini nelle conversazioni in arrivo non vengono inoltrati all'agente |
| Allegati negli strumenti         | Non supportati — gli strumenti operano solo sul testo                                                      |

## Come funziona il trigger

Quando abiliti il trigger **Intercom Conversation**, ElevenLabs si iscrive a due topic webhook di Intercom: uno per le nuove conversazioni create da un contatto e uno per le risposte successive di un contatto. Ogni volta che Intercom invia una notifica:

1. ElevenLabs verifica la firma del webhook rispetto al client secret della tua app.
2. Recupera la conversazione completa da Intercom e associa la cronologia dei messaggi all'agente configurato.
3. L'agente genera una risposta, che ElevenLabs pubblica nella conversazione come amministratore configurato.

Poiché Intercom invia notifiche solo per l'attività degli utenti finali (non per le risposte degli amministratori), l'agente non risponde mai ai propri messaggi.

## Configurazione

#### Crea un'app Intercom e un access token

In Intercom, apri **Settings → Integrations → Developer Hub** e crea una nuova app per ElevenLabs (oppure aprine una esistente).

In **Authentication**, copia l'**Access token**: è il token etichettato per accedere ai dati del tuo workspace. Ti servirà anche il **Client secret** della pagina **Basic information**; ElevenLabs lo usa per verificare l'autenticità di ogni invio webhook.

#### Trova l'ID dell'amministratore Intercom

L'agente pubblica le risposte come amministratore Intercom (in genere un posto dedicato per un membro del team). Apri **Settings → Teammates** in Intercom e seleziona il membro del team a nome del quale l'agente deve pubblicare. L'ID dell'amministratore è un valore numerico (ad esempio `1234567`); puoi recuperarlo anche a livello programmatico tramite l'API [List all admins](https://developers.intercom.com/intercom-api-reference/reference/listadmins) di Intercom.

#### Connetti in ElevenLabs

Nella pagina dell'integrazione Intercom di ElevenLabs, fai clic su **Connect** e incolla l'**Access token** dal Developer Hub.

#### Abilita il trigger Intercom Conversation

Apri la scheda **Triggers** dell'integrazione Intercom e abilita **Intercom Conversation**. Compila i seguenti campi:

* **Agent** — l'agente ElevenLabs che deve gestire le conversazioni Intercom in arrivo.
* **Client secret** — il valore in Developer Hub → Basic information. Viene usato per verificare le firme dei webhook.
* **Admin ID** — l'ID numerico dell'amministratore a nome del quale l'agente deve pubblicare le risposte.
* **Team inbox ID** *(facoltativo)* — limita l'agente a una singola casella di posta del team Intercom. Quando è impostato, l'agente risponde solo alle conversazioni attualmente assegnate a quel team; lascia vuoto per rispondere a tutte le conversazioni. Consulta il passaggio successivo per scoprire come limitare l'agente a una casella dedicata.

#### (Facoltativo) Limita l'agente a una casella di posta del team dedicata

Se vuoi che l'agente gestisca solo uno specifico sottoinsieme di conversazioni, indirizzale a una **casella di posta del team** dedicata e collega il trigger a essa:

1. In Intercom, crea un **Team** per l'agente (**Settings → Teammates & Teams → Teams**), ad esempio "AI Agent".
2. Crea un **Workflow** (**Fin AI Agent → Workflows**) che assegni al team le conversazioni che vuoi gestire usando un'azione **Assign → Team** (i Workflow richiedono un piano Advanced/Expert). Per l'escalation, sposta la conversazione dal team a un team umano.
3. Recupera l'ID numerico del team tramite l'API [List all teams](https://developers.intercom.com/intercom-api-reference/reference/listteams) di Intercom e incollalo nel campo **Team inbox ID** del trigger.

Con una casella di posta del team configurata, l'agente ignora tutte le conversazioni non assegnate a quel team.

> **Note**
>
> Intercom assegna il team tramite il tuo Workflow all'inizio di una conversazione. Se un webhook
> `conversation.user.created` viene inviato prima che l'assegnazione sia effettuata, il primo messaggio
> potrebbe essere ignorato; l'agente riprenderà dalla risposta successiva del contatto. Tienine conto durante i test.

#### Iscriviti ai topic webhook in Intercom

In Intercom Developer Hub, apri la sezione **Webhooks** della tua app e aggiungi una nuova iscrizione che punti a questo URL:

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

Iscriviti a entrambi i topic seguenti:

* `conversation.user.created` — si attiva quando un utente finale avvia una nuova conversazione.
* `conversation.user.replied` — si attiva quando un utente finale risponde a una conversazione esistente.

Intercom firma ogni webhook con il tuo client secret; ElevenLabs verifica l'header `X-Hub-Signature` per ogni invio. Gli invii con firma non valida o mancante vengono ignorati senza avviso.

#### Verifica la configurazione

Apri Intercom Messenger come contatto di test (oppure usa l'anteprima di Intercom), invia un messaggio al tuo workspace e verifica che l'agente configurato risponda come l'amministratore selezionato. Puoi esaminare la trascrizione della conversazione risultante nella vista **Conversations** di ElevenLabs.

Se non arriva alcuna risposta, controlla di nuovo l'URL del webhook e l'iscrizione al topic in Developer Hub, quindi conferma che **Access token** e **Client secret** corrispondano alla stessa app Intercom.

### CLI

> **Note**
>
> La documentazione CLI per questa integrazione sarà disponibile a breve.

### SDK

> **Note**
>
> La documentazione SDK per questa integrazione sarà disponibile a breve.

## Link utili

* [Riferimento API REST di Intercom](https://developers.intercom.com/docs/references/rest-api/api.intercom.io)
* [Panoramica dei webhook di Intercom](https://developers.intercom.com/docs/webhooks)
* [Topic webhook di Intercom](https://developers.intercom.com/docs/references/webhooks/webhook-models)
* [Intercom Developer Hub](https://app.intercom.com/a/apps/_/developer-hub)