Por que a resposta do agente de IA não chega ao cliente
Se o fluxo retornar o texto da IA no corpo da resposta do webhook, o cliente não vai recebê-lo: a AnyLinga não lê esse corpo. Envie a resposta em uma requisição POST separada para callback_url. Se você já faz isso, confira o token, os campos da requisição e o código de resposta do callback.
Aceite a requisição de imediato e depois envie a resposta
O webhook no n8n deve responder com um código 2xx assim que receber a requisição, em até 10 segundos. Depois que sua IA terminar de processar, o fluxo envia a resposta em uma requisição POST separada para callback_url.
Se o webhook responder só depois que a IA terminar de processar, o fluxo corre o risco de ultrapassar os 10 segundos. A AnyLinga vai parar de esperar e não vai repetir a requisição, mas a resposta enviada depois para callback_url com esse correlation_id será entregue ao cliente.
O que acontece depois da chamada ao webhook
A repetição depende do resultado da chamada ao webhook. O fim do prazo de 10 segundos, por si só, não gera uma nova tentativa.
| Resposta do webhook | O que a AnyLinga faz |
|---|---|
2xx em até 10 segundos | A requisição foi aceita. A AnyLinga aguarda a resposta em callback_url. |
| Nenhuma resposta em 10 segundos | Não há nova tentativa; a resposta em callback_url continua sendo aceita. |
Erro de conexão ou 5xx | Até 5 novas tentativas, com pausas de 2, 5, 10, 20 e 30 segundos — cerca de um minuto. As próximas mensagens dessa conversa ficam aguardando. |
4xx | Não há nova tentativa. |
correlation_id. Só a primeira resposta é enviada ao cliente; as demais recebem {"ok": true, "duplicate": true} e não são enviadas. O correlation_id não expira: você pode enviar a resposta até uma hora depois.Confira o caminho da mensagem
1. Confira se o gateway está ativado e se a URL foi informada
- Em Gateway de IA, na página Conecte sua IA, confira Ativar gateway e URL do webhook do n8n. Apenas https é permitido.
2. Confira o endereço e a autorização do callback
- A resposta deve ser enviada para
callback_urlcom o cabeçalhoAuthorization: Bearer <Token do callback>. - Depois de clicar em Regenerar, o token antigo para de funcionar imediatamente. Até você atualizar o token no n8n, as respostas receberão
401.
3. Confira o corpo da resposta
- Envie o
correlation_idda requisição recebida ereply_texte/outemplate_ids.
4. Confira os filtros de acionamento
- Se houver filtros definidos, só serão enviadas ao n8n mensagens de clientes com um negócio aberto que atenda aos critérios. Confira os filtros por negócio.
5. Confira se a conta está bloqueada
- Verifique se o período de teste ainda está ativo ou se a conta está paga. Quando a conta está bloqueada, as mensagens não são enviadas ao n8n.
6. Teste a resposta com uma mensagem real
- O botão Testar conexão verifica apenas a resposta do webhook: n8n respondeu em N ms.
- A resposta via callback a uma mensagem de teste retornará
404«Unknown correlation_id»: a requisição de teste não é salva. Para testar a resposta ao cliente, envie uma mensagem real.
O que significa o código de resposta do callback
| Código | Significado |
|---|---|
200 — {"ok": true} | Aceito e enviado. |
200 com "duplicate": true | Esse correlation_id já recebeu uma resposta. A resposta repetida não foi enviada. |
400 | Falta correlation_id ou não há nem reply_text nem template_ids. |
401 | Token inválido. |
404 | correlation_id ou modelo desconhecido. |
410 | A conversa foi excluída. |
500 / 502 | Não foi possível entregar ao cliente. |
Perguntas relacionadas
como conectar um agente de IA pelo n8n · quais campos o fluxo recebe · o que acontece depois de clicar em «Regenerar»
Ficou com dúvidas?
Respondemos em horário comercial.