Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lfautomatiza.com/llms.txt

Use this file to discover all available pages before exploring further.

A API do LF Connect aplica limites pra proteger a plataforma e os clientes finais. Conhecer o comportamento esperado evita surpresas em produção.

​
Como funciona

Limites são aplicados em três dimensões:
  1. Por token de acesso — protege contra integração mal comportada
  2. Por conta (workspace) — protege contra abuso de múltiplos tokens da mesma conta
  3. Por endereço de origem (IP) — proteção adicional contra força bruta
Os números exatos podem mudar conforme o plano e o ambiente, então a fonte da verdade são os headers da resposta — sempre consulte eles em vez de assumir valores fixos.

​
Headers de resposta

Endpoints sujeitos a rate limit retornam estes headers: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1715972400
  • X-RateLimit-Limit — teto da janela atual
  • X-RateLimit-Remaining — quantas chamadas restam
  • X-RateLimit-Reset — timestamp Unix de quando o contador zera

​
Quando você é bloqueado

Se estourar o limite, recebe 429 Too Many Requests com header Retry-After indicando quantos segundos esperar: 
HTTP/1.1 429 Too Many Requests
Retry-After: 23

{
  "error": "Rate limit exceeded. Try again in 23 seconds."
}
Sempre respeite o Retry-After em vez de chutar tempos de espera. Implementar backoff exponencial em cima dele é a forma mais robusta de lidar com 429.

​
Limites de envio por canal

Independente de rate limit da API, cada canal de mensageria tem suas próprias regras externas (definidas pelas plataformas Meta/WhatsApp/Instagram). A plataforma respeita essas regras automaticamente — mensagens que violariam (ex: fora da janela de 24h sem template aprovado) são rejeitadas antes de chegar no provedor.

​
Limites de mídia

Anexos seguem os limites do canal de destino:
Tipo de mídiaLimite
Imagem5 MB
Áudio16 MB
Vídeo32 MB
Documento100 MB
Sticker500 KB

​
Boas práticas

Não fique chamando GET /conversations a cada poucos segundos esperando novidades. Configure um webhook e reaja a eventos.
Pra mover 100 cards no Kanban, use o endpoint bulk_move_items em vez de 100 chamadas individuais.
account_id, inbox_id, funnel_id, team_id quase nunca mudam. Carregue 1 vez no startup do seu serviço e reutilize.
Quando receber 429, dobre o tempo de espera a cada tentativa (1s → 2s → 4s → 8s) até Retry-After ser respeitado. Evita martelar o sistema enquanto você ainda está bloqueado.
Cada token está vinculado a um agente. Distribuir o mesmo token entre workers paralelos não aumenta capacidade — só faz o limite por usuário estourar mais rápido.

​
Precisa de mais?

Se sua integração tem requisitos específicos (alto volume, SLA contratual de latência ou disponibilidade), fale com a equipe pra avaliarmos o caso — contato@lfautomacoes.com.