API do Intercom: conversas, contatos e artigos com agentes de IA
O Intercom tem uma API REST versionada que cobre conversas, contatos, empresas, tickets e a central de ajuda. É usada por empresas de software e serviços para integrar suporte, produto e CRM. O acesso é por token de acesso de um app no Developer Hub ou por OAuth.
Os grandes recursos da API, em português claro.
Listar, responder, atribuir, fechar e etiquetar conversas.
Criar e atualizar usuários, leads e empresas com atributos personalizados.
Criar e acompanhar tickets de suporte e seus estados.
Ler e publicar artigos da central de ajuda.
Registrar eventos de uso do produto e segmentar contatos.
Receber eventos de conversas e contatos.
Como se acessa a API do Intercom.
- Com credencial da sua empresaToken de acesso de um app criado no Developer Hub do Intercom para o próprio workspace, ou OAuth para apps públicos.
- Documentação oficialdevelopers.intercom.com
- A API é versionada por cabeçalho; fixe a versão usada.
- Há limites de requisição por app e workspace.
- Respostas ao cliente começam com aprovação.
- api intercom
- intercom api documentação
- intercom api conversas
- webhook intercom
- integração intercom
- intercom developer hub
O que um agente do iTeam faz com a API do Intercom.
Antes do atendente abrir, o agente busca plano, uso e faturas e deixa uma nota na conversa.
Relatos de erro são resumidos pelo agente e viram issue com link para a conversa.
O agente sincroniza plano e status de pagamento do billing para o contato no Intercom.
Perguntas que se repetem viram rascunho de artigo para o time de suporte revisar.
Da credencial ao agente trabalhando, com aprovação.
Criar o app no Developer Hub
No Developer Hub do Intercom, crie um app interno para o workspace e copie o token de acesso.
Cadastrar a credencial no cofre do iTeam
A credencial do Intercom fica no cofre do iTeam, fora de prompts e planilhas. Cada agente recebe só as ações de que precisa (ler conversas, adicionar nota, atualizar contato), e o que grava dados passa por aprovação.
Testar com aprovação humana
Antes de liberar, adicione uma nota em uma conversa interna. Nas primeiras semanas, as ações de escrita ficam com aprovação e tudo fica na auditoria.
Dúvidas sobre a API do Intercom.
A API do Intercom é gratuita?
A API está disponível para workspaces do Intercom; o custo é o do plano e de recursos pagos como o Fin.
Preciso programar para usar a API do Intercom com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam aprende os endpoints da API do Intercom pela documentação, e o time de implantação configura credenciais, permissões e o processo. Sua equipe valida o resultado.
Posso usar o agente do iTeam junto com o Fin?
Pode. O Fin atende dentro do Intercom; o agente do iTeam cuida do que atravessa sistemas, como consultar ERP ou abrir chamado em outra ferramenta.