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.
Quão simples é conectar um agente de IA ao Intercom?
É simples: cria-se um app no Developer Hub e usa-se o token de acesso do próprio workspace. A API cobre conversas, contatos, tickets e artigos. O cuidado é fixar a versão da API, que é definida por cabeçalho, e começar com respostas sob aprovação.
O que influencia o custo de usar a API do Intercom?
Confira no seu plano do Intercom o que a API e os recursos de automação incluem, pois não temos valores. Há limites por app e workspace. Do lado do agente, o gasto de IA tem teto no iTeam.
O Intercom tem ambiente de testes para validar o agente?
Na prática, use um workspace de teste ou contatos internos e limite o agente a eles. Valide respostas sob aprovação antes de permitir o envio direto ao cliente.
A API do Intercom muda entre versões?
A API é versionada por cabeçalho, então fixe a versão usada e acompanhe mudanças na documentação oficial. Há limites de requisição por app e workspace. O agente deve tratar erros e registrar falhas, para a equipe revisar após cada atualização.
O agente do iTeam pode trabalhar ao lado do Fin no mesmo Intercom?
Em tese sim, mas confira o que cada um faz no seu fluxo para não duplicar respostas. O iTeam traz cargo, permissões, aprovação e trilha de auditoria e conversa com o Intercom pela API. Combine a divisão de papéis no diagnóstico da primeira semana.
As respostas do agente de IA ao cliente no Intercom precisam de aprovação?
É recomendável começar com aprovação: o agente redige e uma pessoa confirma. Conforme os casos de baixo risco se provam, pode-se liberar o envio direto. No iTeam, a trilha registra o que foi respondido e quem aprovou.
O que um agente de IA pode fazer no Intercom?
Ele resume conversas, sugere respostas com base na central de ajuda, classifica tickets, atualiza contatos e empresas e aplica tags. Exemplo: preparar a resposta e passar ao atendente só o que exige decisão. Eventos e webhooks mantêm o agente atualizado sem consultas constantes.
Como integrar o Intercom ao CRM e ao ERP com um agente de IA?
O agente cruza dados do contato no Intercom com o CRM e o ERP para responder com contexto, como plano e pedidos. O iTeam integra CRM, ERP e planilhas, e o diagnóstico da primeira semana mapeia quais dados o atendimento precisa.
Outras APIs da categoria.
Times de IA prontos que usam Intercom.
Suporte ao cliente com IA
Os tickets do Zendesk, Freshdesk ou Movidesk ganham uma primeira resposta certa, tirada da sua base de conhecimento, e os casos difíceis chegam ao ana…
Customer success e pós-venda
Os agentes leem uso, tickets e conversas no HubSpot ou no Salesforce e dizem quem precisa de uma ligação esta semana.
