---
title: Falhas, filas e avisos de saída
slug: aura/falhas-filas-e-avisos-de-saida
createdAt: 2026-11-19T14:33:14.645Z
---

## 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.

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/q6nKmeIaF9MP3aOAGlgDS_e1f278593bd4f08c0c110c437dabbcd3.jpg" size="160" alt="Aba Disparos da campanha com um disparo entregue e outro que falhou" isUploading="false" initialPath="../images/e1f278593bd4f08c0c110c437dabbcd3.jpg" githubPath="images/e1f278593bd4f08c0c110c437dabbcd3.jpg" width="1600" height="1000" showCaption="false"}

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á.

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/17EiSd54jb6PRdpmqhl-W_8ba134f37790813f5be6887ffaea9537.jpg" size="160" alt="Linha do tempo de um disparo que falhou, com o motivo e o botão Reenviar" isUploading="false" initialPath="../images/8ba134f37790813f5be6887ffaea9537.jpg" githubPath="images/8ba134f37790813f5be6887ffaea9537.jpg" width="1600" height="1000" showCaption="false"}

## 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.

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/sYtVklRx-ERfbd6Ug2_8Q_f5361b7d2b0dd13717c24af2fc6040d7.jpg" size="160" alt="Tela Processamento com as filas de processamento e a fila sem saída (DLQ)" isUploading="false" initialPath="../images/f5361b7d2b0dd13717c24af2fc6040d7.jpg" githubPath="images/f5361b7d2b0dd13717c24af2fc6040d7.jpg" width="1600" height="1000" showCaption="false"}

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/edIXSxlD6Y1kcMa-Mre_B_e505537ec6f22cd82d13c23ecce88253.jpg" alt="Reprocessar tenta de novo; se falhar, volta para a DLQ" caption size="160" width="1600" height="1000"} *Reprocessar tenta de novo; se falhar, volta para a DLQ*

## 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.

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/UEpbKun_qTwPl4ZBcfbBO_452d47330ee890afb33816e70cc52410.jpg" size="160" alt="Formulário Avisar outro sistema, com nome, endereço e eventos" isUploading="false" initialPath="../images/452d47330ee890afb33816e70cc52410.jpg" githubPath="images/452d47330ee890afb33816e70cc52410.jpg" width="1600" height="1000" showCaption="false"}

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.

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/pqS_qvFTnjElBWlTLQRL1_8fe7b758bb42ce59e6d2d59a8a75400a.jpg" size="160" alt="Janela Inscrição criada, que mostra o segredo uma única vez" isUploading="false" initialPath="../images/8fe7b758bb42ce59e6d2d59a8a75400a.jpg" githubPath="images/8fe7b758bb42ce59e6d2d59a8a75400a.jpg" width="1600" height="1000" showCaption="false"}

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 · ".

:::Iframe{code="<assistente>"}

:::

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.
