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à
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:
- ElevenLabs verifica la firma del webhook rispetto al client secret della tua app.
- Recupera la conversazione completa da Intercom e associa la cronologia dei messaggi all’agente configurato.
- 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 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:
- In Intercom, crea un Team per l’agente (Settings → Teammates & Teams → Teams), ad esempio “AI Agent”.
- 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.
- Recupera l’ID numerico del team tramite l’API List all teams 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.
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:
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.