Um guia completo para os limites de taxa da API da Intercom

Vamos contextualizar. Está a construir uma integração personalizada e elegante para a sua equipa de suporte no Intercom. As coisas estão finalmente a começar a funcionar. A sua automatização está a correr bem, os tickets estão a ser atualizados e está a sentir-se bastante orgulhoso de si mesmo. De repente, do nada, tudo simplesmente para. Mergulha nos registos e lá está ele: o temido erro "429 Too Many Requests" (Demasiados Pedidos).

Se isto lhe soa demasiado familiar, não está definitivamente sozinho. Os limites de taxa da API são uma realidade para qualquer pessoa que tente construir e escalar as suas ferramentas em plataformas como o Intercom. Existem para manter a plataforma estável para todos, mas podem parecer um grande obstáculo quando está apenas a tentar criar melhores fluxos de trabalho para a sua equipa.

Este guia irá orientá-lo por tudo o que precisa de saber sobre os limites de taxa da API do Intercom. Abordaremos por que são importantes para o seu negócio e mostraremos como trabalhar com eles, quer esteja a programar do zero ou à procura de uma solução mais inteligente e pré-construída.

Quais são os limites de taxa da API do Intercom?

Na sua essência, a limitação de taxa da API é apenas um limite para o número de pedidos que a sua aplicação pode enviar para um servidor num determinado período de tempo. É uma forma de as plataformas garantirem que nenhuma aplicação pode monopolizar todos os recursos e abrandar as coisas para todos os outros. O Intercom utiliza a limitação de taxa para manter o seu serviço rápido e fiável.

De acordo com a documentação oficial do Intercom, os limites padrão na sua API REST mudam dependendo do tipo de aplicação que está a usar.

• Aplicações Privadas: Estas estão limitadas a 10.000 chamadas de API por minuto para cada aplicação, com um limite total de 25.000 chamadas de API por minuto para todo o espaço de trabalho. Portanto, se tiver algumas aplicações privadas a funcionar, todas têm de partilhar esse conjunto de 25.000 chamadas do espaço de trabalho.

• Aplicações Públicas: Estas também têm um limite de 10.000 chamadas de API por minuto por aplicação. A principal diferença é que cada aplicação pública tem a sua própria quota separada, pelo que não têm de partilhar entre si.

Mas aqui está o detalhe que muitas vezes confunde as pessoas: o Intercom não conta apenas os pedidos durante um período de 60 segundos. Para evitar picos repentinos de tráfego, na verdade distribui o limite por janelas de 10 segundos. Isso significa que um limite de 10.000 chamadas por minuto corresponde, na prática, a cerca de 1.666 chamadas a cada 10 segundos. Se tentar enviar todos os 10.000 pedidos nos primeiros cinco segundos de um minuto, será limitado muito antes desse minuto terminar.

Aqui está um resumo rápido:

Tipo de Aplicação	Limite por Aplicação (por minuto)	Limite por Espaço de Trabalho (por minuto)	Limite Distribuído (a cada 10 segundos)
Aplicação Privada	10.000	25.000 (partilhado)	~1.666
Aplicação Pública	10.000	25.000 (separado)	~1.666

Para o ajudar a manter-se dentro destes limites, o Intercom inclui alguns cabeçalhos HTTP úteis nas suas respostas da API. Estes permitem que os seus programadores monitorizem o uso em tempo real:

• "X-RateLimit-Limit": O número total de pedidos que tem permissão para fazer.

• "X-RateLimit-Remaining": Quantos pedidos lhe restam na janela atual.

• "X-RateLimit-Reset": Um carimbo de data/hora que lhe diz quando o seu contador de pedidos será reiniciado para o limite.

Porque é que os limites de taxa da API do Intercom são importantes para as suas operações de suporte

Atingir o seu limite de taxa é mais do que um problema técnico para os seus programadores. Tem um impacto real na sua equipa de suporte e, mais importante, nos seus clientes. Quando as suas automatizações falham, os efeitos podem ser sentidos em todo o seu sistema de suporte.

Aqui está uma análise de como atingir esses limites pode causar problemas para o seu negócio.

Os seus clientes ficam à espera

Digamos que o seu bot de IA personalizado foi criado para dar respostas instantâneas a perguntas comuns. Se atingir um limite de taxa, não consegue criar ou atualizar tickets no Intercom. De repente, essa resposta "instantânea" deixa de o ser, e os clientes ficam à espera. Isto pode prejudicar as suas pontuações de satisfação do cliente e afetar as métricas de tempo de resposta da sua equipa.

As suas automatizações e sincronizações de dados falham

Muitas equipas usam a API para trabalhos importantes nos bastidores, como atualizar perfis de utilizador em massa ou sincronizar dados de conversas com um CRM. Se estas tarefas falharem a meio devido à limitação de taxa, acaba com dados desorganizados e incompletos e uma tarefa de limpeza manual que ninguém quer fazer.

Os seus programadores são desviados para resolver problemas urgentes

Em vez de construir novas funcionalidades interessantes para o seu produto, a sua equipa de engenharia fica presa a resolver erros da API. Têm de gastar o seu tempo a construir e a testar soluções alternativas, como lógica de repetição e sistemas de recuo, o que desvia o seu foco de projetos mais valiosos.

Os seus relatórios tornam-se pouco fiáveis

Se as suas ferramentas de relatórios extraem dados diretamente da API do Intercom, atingir os limites de taxa significa que não está a obter a imagem completa. Dados incompletos podem distorcer as suas métricas em tudo, desde a produtividade dos agentes até às tendências dos tickets, levando a más decisões de negócio baseadas em informações erradas.

O que começa como um simples erro "429 Too Many Requests" pode facilmente tornar-se um problema maior, envolvendo clientes frustrados, dados pouco fiáveis e uma equipa de engenharia distraída.

Como lidar com os limites de taxa da API do Intercom: A abordagem manual

Então, o que fazer quando começa a atingir estes limites? Se a sua equipa está a construir as suas próprias integrações personalizadas, os programadores geralmente têm alguns truques na manga. Estes métodos funcionam, mas todos requerem uma boa dose de programação e manutenção contínua.

Aqui estão as três principais formas de lidar manualmente com os limites de taxa:

• Verificar primeiro os cabeçalhos: Esta é a forma mais direta de evitar erros. Antes de fazer uma nova chamada à API, o seu código pode verificar o cabeçalho "X-RateLimit-Remaining". Se o número estiver a ficar baixo, o script pode simplesmente fazer uma pausa e esperar que o carimbo de data/hora de reinicialização em "X-RateLimit-Reset" passe. É uma tática simples de "parar e esperar" que pode funcionar, mas não é muito elegante.

• Usar uma estratégia de recuo (backoff): Esta é uma forma mais inteligente de lidar com as coisas quando recebe um erro 429. Em vez de tentar novamente de imediato, o código espera por um curto e aleatório período de tempo. Se essa segunda tentativa também falhar, espera por um período mais longo, e assim por diante. Isto é frequentemente chamado de "recuo exponencial," e impede que o seu sistema sobrecarregue a API e piore o problema.

• Apoiar-se em bibliotecas: Para poupar algum tempo, os programadores utilizam frequentemente bibliotecas pré-construídas que já têm toda esta lógica integrada. Um programador de Node.js pode usar um pacote como "retry", enquanto alguém que trabalha em Ruby pode usar a gem "retries". Estas ferramentas podem simplificar o código, mas também adicionam outra dependência ao seu projeto que precisa de ser gerida e mantida atualizada.

Construir este tipo de tratamento de erros do zero não é uma tarefa fácil. Envolve muito planeamento, testes e a garantia de que não perde nenhuns dados se um pedido falhar após algumas tentativas. Para a maioria das equipas de suporte, este é um trabalho pesado que não é prático sem recursos de engenharia dedicados.

Preços do Intercom e limites de taxa da API do Intercom

Os preços do Intercom estão divididos em níveis. Embora geralmente possa aceder à API na maioria dos planos, algumas das funcionalidades mais avançadas e limites potencialmente mais altos podem estar ligados aos pacotes mais caros. Vale a pena descobrir o que cada plano oferece antes de se inscrever, especialmente se planeia depender muito de automatizações.

Aqui está uma breve análise dos seus planos atuais:

Plano	Preço	Principais Funcionalidades
Starter	A partir de $74/mês	Chat ao vivo, caixa de entrada partilhada, centro de ajuda básico, chatbot de IA (Fin), relatórios básicos. Bom para pequenas empresas a começar.
Pro	Preço personalizado	Tudo do Starter, mais encaminhamento de tickets, regras de automatização avançadas, várias caixas de entrada de equipa e integrações com ferramentas como Slack e Salesforce.
Premium	Preço personalizado	Tudo do Pro, mais funcionalidades avançadas como funções personalizadas, gestão de carga de trabalho e painéis de relatórios personalizáveis.

Para os planos Pro e Premium, tem de entrar em contacto com a equipa de vendas para obter um orçamento. Isto pode tornar complicado comparar opções e orçamentar adequadamente sem ter uma chamada de vendas.

Uma forma mais inteligente de automatizar o Intercom sem atingir os limites de taxa da API

Em vez de passar semanas a construir e a manter uma integração complexa apenas para lidar com os limites de taxa, e se pudesse usar uma plataforma que foi construída para tratar de tudo por si?

É aqui que uma ferramenta como a eesel AI pode ser uma grande ajuda. A eesel é uma plataforma de IA que se liga ao Intercom com uma simples integração de um clique, gerindo todas as coisas complicadas da API para que não tenha de o fazer. Foi concebida para ser totalmente self-service, para que possa começar sem escrever uma única linha de código ou assistir a uma demonstração de vendas obrigatória.

Aqui está como a eesel o ajuda a contornar a dor de cabeça dos limites de taxa da API do Intercom:

• Configure em minutos, não em meses: Com a eesel, pode esquecer a construção de lógica de repetição ou a monitorização de cabeçalhos de API. A plataforma já está otimizada para trabalhar com a API do Intercom, obtendo dados e executando ações de uma forma que respeita automaticamente os limites. Isto liberta inúmeras horas para a sua equipa se focar em desenhar ótimos fluxos de trabalho de suporte, em vez de se preocupar com quotas.

• Teste as suas automatizações com confiança: Uma das partes mais complicadas de construir integrações de API é testá-las em escala sem mexer nos seus dados de produção ao vivo. A eesel tem uma solução inteligente para isto com o seu modo de simulação. Pode testar as respostas do seu agente de IA em milhares dos seus tickets reais e históricos do Intercom sem fazer uma única chamada à API ao vivo. Isto permite-lhe ver exatamente como irá funcionar antes de alguma vez falar com um cliente.

O modo de simulação da eesel AI permite testar automatizações em dados históricos para evitar atingir os limites de taxa da API do Intercom em tempo real.

• Unifique todo o seu conhecimento, instantaneamente: A eesel pode treinar o seu agente de IA nas suas conversas passadas do Intercom, macros e artigos do centro de ajuda. Este é um processo intensivo em dados que normalmente envolveria toneladas de chamadas à API, mas a eesel trata de tudo nos bastidores. A sua equipa não terá de construir e executar scripts de sincronização de dados que poderiam levá-lo a ser limitado pela taxa.

Usar uma plataforma especializada como a eesel AI dá à sua equipa o poder de uma integração personalizada sem a sobrecarga de engenharia. Pode focar-se em criar ótimas experiências para o cliente, não em gerir quotas de API.

Considerações finais sobre os limites de taxa da API do Intercom

Os limites de taxa da API do Intercom são algo em que todas as equipas precisam de pensar se quiserem automatizar e escalar o seu suporte. Existem por uma boa razão, mas podem definitivamente ser uma dor de cabeça se não estiver preparado para eles.

Tem realmente dois caminhos a seguir. Pode optar pela rota DIY (faça você mesmo), o que significa que a sua equipa de engenharia constrói e mantém toda a lógica de limitação de taxa. Isto dá-lhe controlo total, mas custa muito em termos de tempo e pessoas.

Ou, pode usar uma plataforma que já resolveu este problema. Para equipas que querem implementar IA e automatização poderosas sem as dores de cabeça técnicas, uma ferramenta como a eesel AI é o caminho mais direto. Dá-lhe todas as vantagens de uma integração profunda com o Intercom sem nenhuma da complexidade.

Pronto para automatizar o seu suporte no Intercom sem se preocupar com os limites da API? Comece o seu teste gratuito da eesel AI e veja como pode ser fácil.