Vai alla navigazione

Intercom

Cerca clienti, conversazioni e articoli dell'assistenza tramite il server MCP di Intercom.

Collega il server MCP 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.

Le conversazioni possono contenere dettagli privati. Indica al tuo receptionist, nelle sue istruzioni o in una procedura, 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

1

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.

2

Aggiungi il server MCP

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

CampoValore
NomeIntercom
Tipo di serverHTTP streamable
URL del serverL’URL per la regione del tuo workspace, sotto
Token segretoIl tuo token di accesso
Regione del workspaceURL 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.

3

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.

4

Verificalo

Verifica il tuo receptionist 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

ProblemaCosa controllare
Non sono elencati strumentiUsa il tipo di server HTTP streamable e l’URL per la regione del tuo workspace.
Uno strumento restituisce un errore di autorizzazioneAggiungi l’autorizzazione mancante all’app nell’Developer Hub.
Il receptionist non trova un chiamanteIntercom confronta i numeri di telefono come sono salvati nel contatto. Salva i numeri in un unico formato.
Hai modificato il tokenModifica l’integrazione e usa Ruota token segreto (facoltativo). Il token salvato non viene più mostrato.