Entregas e novas tentativas

Cada envio — de um webhook, de uma ação Enviar para outro sistema ou de um gatilho do Atendimento — vira uma entrega, registrada em Processos › Central de Automações › Webhooks › Entregas com o que foi enviado e o que o seu sistema respondeu.

Entregue, tenta de novo ou desiste

Resposta do seu sistema	O que a TAI faz
2xx	Entregue
Falha de rede, tempo esgotado, 5xx, 408, 425 ou 429	Vai tentar de novo
Outro 4xx (400, 401, 403, 404…) ou 3xx	Não entregue na hora — repetir não resolve. O motivo aparece em português

As novas tentativas esperam 1 min, 5 min, 30 min, 2 h, 6 h e 12 h — sete tentativas em cerca de 21 horas. Depois disso a entrega fica Não entregue. Corrigido o problema, Reenviar põe a mesma entrega de volta na fila, com o mesmo X-Tai-Entrega.

Processe uma vez só

A mesma entrega pode chegar mais de uma vez — por exemplo, quando o seu sistema gravou mas demorou a responder. Guarde o X-Tai-Entrega (ou o id do evento) e ignore o que já processou.

Webhook desligado sozinho

O webhook se desliga, e quem responde por ele e o dono da conta são avisados, quando:

• o seu sistema responde 410 Gone — sinal de que o endereço não existe mais; ou
• acontecem 50 falhas seguidas.

Religue pelo interruptor depois de corrigir.

Requisitos do endereço

Requisito	Motivo
HTTPS	Endereços http:// são recusados
Sem usuário e senha na URL	https://usuario:senha@… é recusado — use um cabeçalho
Endereço público	Hosts que resolvem para rede interna, loopback, link-local ou faixas privadas são bloqueados
Sem redirecionamento	Respostas 3xx não são seguidas

Tempo

Etapa	Limite
Conexão	10 segundos
Leitura e escrita	20 segundos
Chamada inteira	30 segundos

Responda rápido e com pouco conteúdo — um 200 ou 204 basta. Só o começo da sua resposta é guardado no registro da entrega.

Pausa geral

Desligar todas, no topo de Processos › Central de Automações, também para os webhooks: nada é enviado até alguém religar.

Reconciliação

As novas tentativas cobrem quedas de horas, não de dias. Uma integração que depende de estar em dia deve também reconciliar pela API de tempos em tempos — veja Da TAI para o seu sistema.