Falhas, filas e avisos de saída
Quando um disparo falha
Cada disparo tem um estado: entrou na fila, saiu para o fornecedor, aceito, entregue, lido — ou Falhou, Bloqueado (blacklist), Inválido. Na aba Disparos da campanha, a coluna O que houve traz o motivo em uma frase curta (ex.: Destinatário sem WhatsApp) e a coluna Código de erro, ao lado, o código do fornecedor (ex.: 131026). Disparo que saiu aparece como Envio confirmado. A mensagem original do fornecedor fica na dica da célula e no Exportar, na coluna DescricaoErro.
Código | O que houve |
|---|---|
131026, 1002 | Destinatário sem WhatsApp |
131049 | Não foi enviado para manter o ecossistema saudável |
130472 | O número do usuário faz parte de um experimento |
131050 | Destinatário optou por não receber marketing |
4003 | Modelo não confere com o aprovado |
132000 | Variáveis do modelo não conferem |
132001 | Modelo inexistente ou não aprovado |
131047 | Fora da janela de 24 horas |
130429 | Limite de vazão do fornecedor atingido |
471 | Limite de envio do número atingido |
blacklist | Destinatário na lista de bloqueio |
invalid | Telefone inválido |
Código fora da lista aparece como Falha no envio, com o código e a mensagem do fornecedor.

Clique na linha para ver a linha do tempo do disparo. Reenviar cria um disparo novo para o mesmo número — o original continua no histórico como está.

Processamento
Disparos › Processamento junta, num lugar só, o que explica um disparo parado:
- Provedores — os números e a saúde de cada um (cota de 24 h, qualidade, vazão).
- Campanhas em andamento.
- Filas de processamento — as filas do motor deste tenant: campanha_lancar (largadas), disparo (mensagens), fonte_executar (buscas em fonte via API) e webhook_saida (avisos), com aguardando, processando, agendado, falhas e finalizados.
- Fila sem saída (DLQ) — os disparos que esgotaram as tentativas. Reprocessar devolve o disparo à fila; Descartar apaga da fila sem saída e ninguém recebe.
- Por que falharam — os códigos de erro e quantos disparos cada um derrubou.
- Avisos de saída — para onde a plataforma avisa que a mensagem andou.


Avisos de saída (webhook para outro sistema)
Se o seu sistema precisa saber que a mensagem foi aceita, entregue, lida ou falhou, inscreva-o em Avisar outro sistema: nome, endereço público (rede interna é recusada — é a plataforma que faz o POST, de dentro) e quais eventos mandar.

Ao criar, a tela mostra o segredo uma única vez: é com ele que o seu lado confere a assinatura X-Aura-Signature de cada aviso. Testar manda um evento de exemplo; a coluna última entrega mostra a data e o HTTP devolvido. Desligar pausa sem apagar.

Cada aviso é um POST JSON com event (sent, delivered, read, failed), data (telefone, campanha, disparo, id no fornecedor, código de erro) e timestamp. Destino fora do ar não bloqueia os outros: a entrega tenta de novo com espera e, depois de falhas seguidas, pausa a inscrição.
Trilha de onboarding
A aba Trilha mostra o que sai sozinho: um marco por dia corrido ao colaborador recém-admitido, lido no RH todo dia às 9 h. Próximos lista quem recebe qual marco nos próximos dias (consulta o RH na hora); Histórico lista o que já saiu, com falha e retentativa. As entregas de cada mensagem ficam na campanha "Disparos do fluxo ·
Para ligar, o painel de configuração pede três coisas e recusa sem elas: a fonte via API do RH (em Contatos › Fontes via API; se a API exige login, use a autenticação "Login e token"), o assistente cujo fluxo tem os marcos (um bloco "Início por API" em modo proativo por dia, com o slug cissa-dia-NN, seguido de "Enviar template") e a data de corte (admitidos a partir dela). Horários de envio e de retentativa também ficam ali.