Um guia para a API REST da Intercom (2025)

Provavelmente, utiliza o Intercom todos os dias para conversar com clientes, e é ótimo para isso. Mas e se pudesse conectá-lo a todas as outras ferramentas das quais a sua empresa depende? Imagine automatizar fluxos de trabalho, sincronizar dados de clientes de forma transparente e criar experiências personalizadas sem o trabalho manual pesado. Esse é o verdadeiro poder por trás da API REST do Intercom.

Sejamos realistas, o termo "API" pode parecer intimidante, especialmente se não tiver um programador à distância de uma chamada. Mas não se preocupe. Neste guia, vamos explicar o que é a API REST do Intercom, o que pode fazer com ela e, mais importante, como pode obter todos os benefícios sem precisar de se tornar um especialista em programação da noite para o dia.

O que é a API REST do Intercom?

Então, o que é exatamente uma API REST? Pense nela como um tradutor que permite que diferentes programas de software conversem entre si online. A API REST do Intercom, especificamente, é um conjunto de ferramentas que permite que as suas outras aplicações acedam e modifiquem com segurança os dados dentro da sua conta Intercom.

Em vez de exportar manualmente uma lista de utilizadores ou atualizar o perfil de um cliente à mão, pode usar a API para que outra aplicação o faça por si automaticamente. Como o Intercom diz, a sua API REST é um "bloco de construção fundamental da Plataforma Intercom" que pode usar para extrair, atualizar, criar e eliminar informações.

Isto permite-lhe fazer algumas coisas realmente úteis, como:

• Sincronizar conversas e dados de clientes com o seu CRM.

• Adicionar mais contexto aos perfis de utilizador com informações da sua base de dados interna.

• Criar alertas personalizados para a sua equipa de suporte no Slack.

Compreender os principais modelos de dados da API REST do Intercom

Antes de começar a construir qualquer coisa, é útil saber como o Intercom organiza as suas informações. Agrupa tudo em algumas categorias principais. Assim que se familiarizar com elas, terá uma imagem muito mais clara do que realmente pode fazer com a API.

Contactos: Visitantes, leads e utilizadores

O Intercom divide as pessoas com quem interage em três grupos:

• Visitantes: Pessoas anónimas que navegam no seu site antes de iniciarem uma conversa.

• Leads: Visitantes que enviaram uma mensagem ou responderam a uma. É neste momento que o Intercom começa a manter um histórico da sua atividade.

• Utilizadores: Leads que se inscreveram no seu produto ou iniciaram sessão numa conta existente.

Conversas e mensagens

Este é o pão com manteiga de toda a comunicação no Intercom:

• Mensagens: Qualquer peça única de comunicação, seja da sua equipa, de um chatbot ou de um cliente.

• Conversas: O tópico inteiro de mensagens entre si e um cliente.

Uma vista do mensageiro conversacional do Intercom, uma parte fundamental da API REST do Intercom.

Empresas, atributos e eventos

Estes dados ajudam-no a organizar os seus contactos e a adicionar contexto importante:

• Empresas: Permite agrupar contactos pela organização a que pertencem.

• Atributos: São apenas campos que armazenam detalhes sobre um contacto ou empresa, como o nome, e-mail, plano de subscrição ou quaisquer outros dados personalizados que queira acompanhar.

• Eventos: Ações que os seus contactos realizam e que pretende rastrear, como a utilização do produto ou atividade específica no site.

Outros tipos de dados importantes

Também irá encontrar estes objetos para organização interna da equipa e acompanhamento de problemas:

• Etiquetas e Segmentos: Usados para rotular e agrupar contactos para que possa filtrá-los ou enviar mensagens direcionadas.

• Notas: Comentários internos que a sua equipa pode adicionar ao perfil de um contacto.

• Tickets: Uma forma mais formal de acompanhar e gerir pedidos específicos de utilizadores dentro do Intercom.

Uma captura de ecrã da vista de tickets do Intercom, que pode ser gerida através da API REST do Intercom, mostrando detalhes do cliente.

Casos de uso comuns (e limitações) da API REST do Intercom

A API parece ótima na teoria, certo? Pode construir todo o tipo de coisas interessantes para personalizar o seu suporte. Mas construir e manter estas integrações pode ser uma verdadeira dor de cabeça, com muitos custos ocultos e complicações.

Sincronizar dados de leads e clientes

Um objetivo comum é sincronizar novos leads do Intercom para o seu CRM, ou extrair dados das suas ferramentas internas para dar mais contexto aos agentes nas suas conversas. A armadilha? Tem de escrever e hospedar código personalizado para gerir tudo isto. E se o Intercom ou o seu CRM atualizarem a sua API, a sua integração personalizada pode quebrar, deixando os seus dados dessincronizados no pior momento possível.

Construir chatbots e fluxos de trabalho personalizados

Outra ideia é construir bots personalizados que fazem mais do que os nativos do Intercom, como verificar o estado de uma encomenda no Shopify ou verificar uma funcionalidade da conta. Este é um projeto de desenvolvimento massivo. Teria de gerir o fluxo da conversa, a lógica e as chamadas a outros sistemas, tudo enquanto se mantém dentro dos limites da API do Intercom.

Honestamente, é um trabalho a tempo inteiro. Em vez de construir do zero, uma plataforma como a eesel AI permite-lhe criar agentes de IA poderosos em minutos. Com integrações simples para ferramentas como o Intercom e a sua própria base de conhecimento, pode ter um agente autónomo a lidar com questões complexas sem escrever uma única linha de código. Também obtém controlo total sobre a personalidade da IA e as ações específicas que pode realizar.

Um exemplo de um construtor de fluxos de trabalho visual que simplifica processos em comparação com a construção direta com a API REST do Intercom.

Criar alertas e gerir atribuições de equipa

Ou talvez queira atribuir automaticamente conversas a agentes num estilo de round-robin, ou receber um alerta no Slack quando um cliente VIP envia uma mensagem. Para fazer isto por conta própria, precisaria de um programador para construir um serviço que está sempre a escutar estes eventos. É mais uma peça de tecnologia personalizada que a sua equipa tem de construir, monitorizar e corrigir quando avaria.

Este é outro ponto onde uma ferramenta de IA dedicada poupa imenso esforço. Por exemplo, a automação de triagem da eesel AI liga-se diretamente ao seu helpdesk para automatizar o encaminhamento e a etiquetagem, para que a sua equipa possa parar de organizar filas e começar a falar com os clientes.

Como começar com a API REST do Intercom

Ok, então ouviu os avisos e ainda quer mergulhar e construir algo por si próprio. Justo. Aqui está uma visão geral rápida de como é esse processo.

Autenticação e fazer a sua primeira chamada

Para começar com a API, primeiro precisa de um Token de Acesso das suas configurações de programador do Intercom. Este token é apenas uma chave que prova que tem permissão para aceder aos dados do seu espaço de trabalho. Em seguida, inclui este token nos seus pedidos. Por exemplo, poderia usar um simples comando "cURL" para obter uma lista de administradores no seu espaço de trabalho.

Navegar pelos principais endpoints da API REST do Intercom

A API está dividida em diferentes "endpoints", que são apenas URLs para aceder a diferentes tipos de dados. Os mais comuns que irá usar são para os modelos de dados de que falámos anteriormente:

• "/contacts"

• "/conversations"

• "/companies"

• "/tickets"

• "/messages"

A alternativa mais simples e sem código à API REST do Intercom

Construir com a API REST do Intercom dá-lhe muito controlo, mas é um enorme compromisso de tempo, dinheiro e horas de programador. Para a maioria das equipas de suporte, simplesmente não é prático. Uma abordagem muito mais rápida é usar uma plataforma que trata de todo esse trabalho pesado por si.

A eesel AI foi projetada para ser completamente self-service. Pode conectar o Intercom com um clique e começar a funcionar em minutos, não em meses. Pode até simular a IA em milhares dos seus tickets passados para ver uma previsão precisa da sua taxa de resolução antes mesmo de a ativar para os clientes. Acabou-se a adivinhação.

Preços do Intercom

Falando de custos, também é importante olhar para como o próprio Intercom estrutura os seus preços, especialmente no que diz respeito às suas próprias funcionalidades de IA. Os seus planos principais têm um preço por agente, mas o seu agente de IA, Fin, é vendido separadamente.

De acordo com a sua página de preços, o Fin custa $0.99 por resolução. O que isto significa é que, para além do que paga por cada agente, tem um custo extra cada vez que a IA fecha um ticket com sucesso. Isto pode tornar a sua fatura mensal bastante imprevisível, uma vez que muda com base no seu volume de suporte.

Este modelo de pagamento conforme o uso é bastante comum, mas pode ser uma verdadeira dor de cabeça para o orçamento. Na eesel AI, fazemos as coisas de forma diferente. O nosso preço é direto e previsível, baseado num número fixo de interações de IA por mês. Obtém todas as nossas ferramentas, o Agente de IA, o Copilot e a Triagem, tudo num plano simples sem taxas surpresa.

Plano	Preço por Lugar/mês (faturado anualmente)	Custo do Agente de IA Fin
Essential	$29	+ $0.99 por resolução
Advanced	$85	+ $0.99 por resolução
Expert	$132	+ $0.99 por resolução

Vá além do básico da API REST do Intercom

Então, qual é a conclusão? A API REST do Intercom é uma ferramenta fantástica que pode ajudá-lo a criar fluxos de trabalho personalizados e a conectar os seus dados. Mas tentar construir tudo por conta própria é um caminho longo e caro, cheio de obstáculos técnicos e manutenção contínua.

As plataformas de IA modernas oferecem uma forma muito mais rápida e acessível de obter os mesmos, se não melhores, resultados. Em vez de lutar com código, pode usar uma ferramenta como a eesel AI para unificar todas as suas fontes de conhecimento e automatizar o suporte, tudo isto mantendo as ferramentas que a sua equipa já adora.

Automatize o seu suporte Intercom em minutos

Pronto para ver o que um agente de IA construído de propósito pode fazer pela sua equipa de suporte? Conecte o seu helpdesk do Intercom com um clique e inicie o seu teste gratuito com a eesel AI. Não é necessário programador.

Inicie o seu teste gratuito