Primeiros passos
Limites e erros
Quanto dá para chamar e como a API avisa que algo deu errado.
Limite de requisições#
120 requisições por minuto por IP em /integrations/v1. Passou disso, a resposta é 429 com o header Retry-After: 60 (segundos). O limite conta por endereço de origem, então vários tokens usados do mesmo servidor dividem a mesma cota. O gatilho por webhook dos chatbots tem uma cota própria, também de 120 por minuto.
Envios em massa
Para disparar para muitos contatos, prefira as Campanhas do painel: elas respeitam o intervalo entre envios e protegem o número contra bloqueios do WhatsApp.Formato do erro#
Todo erro devolve JSON com a mensagem em error. Os bloqueios de conta trazem também um code estável, para seu sistema tratar sem depender do texto.
{
"error": "informe phone_number ou name"
}Códigos de status#
| Status | Quando | O que fazer |
|---|---|---|
200 / 201 / 202 | Deu certo (201 = criado, 202 = aceito e processando) | — |
400 | Corpo inválido, campo obrigatório faltando ou id mal formado | Corrija a chamada; não repita igual |
401 | Token ausente, inválido ou excluído | Confira o header e gere outro token se preciso |
403 | Conta bloqueada: workspace_suspended ou workspace_cancelled | Fale com o suporte do SOLAR.IA |
404 | O recurso não existe neste workspace | Confira o id (ids de outros workspaces também dão 404) |
422 | Pedido válido, mas impossível agora: sem canal conectado, chatbot não liberado, sequência sem passos | Ajuste no painel |
429 | Limite de requisições | Espere o Retry-After |
502 / 503 | Falha momentânea no motor de mensagens | Tente de novo com espera crescente (1s, 2s, 4s…) |