# Incidentes, notificações e busca

> Acompanhe os problemas dos grupos em Incidentes, escolha por onde receber cada aviso em Notificações e encontre telas, grupos e campanhas pela busca rápida.

- URL: https://botdoafiliado.com/docs/whatsapp/incidentes-e-alertas/
- Publicado em: 2026-09-16
- Atualizado em: 2026-10-31
- Índice da documentação para IA: https://botdoafiliado.com/llms.txt

**Incidentes** lista os problemas dos grupos e campanhas do WhatsApp, com o que fazer em cada um, e **Notificações** escolhe por onde cada aviso chega: e-mail, Telegram ou webhook. Incidentes é uma aba da tela **WhatsApp**; Notificações fica em **Configurar**.

## Incidentes

Abra **WhatsApp → Incidentes**. A aba exige o módulo WhatsApp; sem ele, a tela WhatsApp mostra o cadeado do módulo. Com incidente aberto, a aba mostra quantos são. O botão **Configurar alertas** leva a Notificações. O endereço antigo `/incidentes` abre esta aba.

Na aba **Visão geral** do WhatsApp, o cartão **Saúde dos grupos** mostra a **Última sonda**, quantos grupos estão **saudáveis**, **com problema** e **sem sonda**. Quando a última rodada registra erros, o cartão avisa que a saúde exibida pode estar desatualizada. Um grupo sem verificação ainda não é apresentado como saudável.

Em **Histórico de incidentes**, use **Abertos**, **Fechados** ou **Todos**. A lista mostra os mais recentes primeiro, 20 por página; troque em **Itens por página** (10, 20, 50 ou 100) e ande com **Anterior** e **Próximo**. O número na aba conta todos os abertos. Cada registro traz o estado (**Aberto** ou **Fechado**), o tipo, o **Grupo**, a **Campanha**, **Aberto em**, o detalhe e a orientação, com os atalhos **Ver grupo no WhatsApp** e **Ver campanha**.

Os tipos e o que fazer:

- **Convite inválido:** gere um novo convite no grupo pelo WhatsApp e confira se o número continua administrador.
- **Grupo suspenso:** abra o grupo no celular e confira a orientação do WhatsApp. O grupo volta à distribuição quando a sonda confirmar a recuperação.
- **Sem acesso:** confira se o número ainda participa do grupo e é administrador. Reponha o acesso e aguarde a próxima sonda.
- **Número desconectado:** um número caiu e o grupo ficou sem nenhum número conectado, então os envios para ele falham. Reconecte o número em **WhatsApp → Números** e confira os grupos que dependem dele. O incidente abre junto do aviso de queda, depois de alguns minutos fora, e só nos grupos que ficaram sem número: se outro número segue enviando no grupo, sai só o aviso.
- **Campanha sem grupo aberto:** confira os grupos da campanha: reabra um grupo saudável com vagas ou adicione outro. A próxima entrada com destino disponível encerra o incidente.
- **Número que cria os grupos indisponível:** o número escolhido para criar os grupos da campanha estava desconectado, pausado ou fora da organização, e o grupo novo saiu pelo automático. Troque **Número que cria os grupos** no Link de entrada da campanha (ou volte ao **Automático**) e salve. Desligar a criação automática ou arquivar a campanha também encerra o incidente.
- **Edição que não chegou ao WhatsApp:** o post foi editado no Telegram depois dos 15 minutos em que o WhatsApp aceita editar uma mensagem de grupo, e esses grupos ficaram com o texto antigo (o canal do WhatsApp aceita a edição por 30 dias e não cai aqui). Há um registro por post, com quantos grupos ficaram para trás. **Apagar nos grupos** apaga a mensagem para todos nesses grupos, o que o WhatsApp permite até 2 dias depois do envio; **Deixar como está** só encerra o registro. Os dois botões são do dono e dos administradores, e o resultado de cada grupo aparece em **Envios**. Passados os 2 dias, o registro se encerra sozinho. Para a edição chegar, edite o post nos primeiros minutos.

O fechamento é automático quando a recuperação é confirmada: pela sonda nos problemas de grupo, pela próxima entrada com destino disponível na campanha sem grupo, pela volta do número no número desconectado, ou pelo salvamento da campanha no número que cria os grupos. Registro fechado mostra **Fechado em**; confira a situação atual antes de agir.

## Notificações

Abra **Configurar → Notificações**. A tela exige o módulo WhatsApp ou o módulo de API. Cada mudança é salva na hora; aguarde a confirmação **Preferência salva.** Somente o dono ou administrador pode alterar as opções. As preferências são separadas por organização.

### Avisos por canal

A tabela mostra cada aviso com uma coluna para **E-mail**, **Telegram** e **Webhook**. Um traço indica que o aviso não sai por aquele canal. Os avisos começam ligados.

| Aviso | Canais |
|---|---|
| Convite inválido | E-mail, Telegram, Webhook |
| Grupo suspenso | E-mail, Telegram, Webhook |
| Sem acesso ao grupo | E-mail, Telegram |
| Grupo recuperado | E-mail, Telegram, Webhook |
| Número desconectado | E-mail, Telegram, Webhook |
| Número reconectado | E-mail, Telegram, Webhook |
| Falha de envio | E-mail, Telegram, Webhook |
| Aquecimento pausado | E-mail, Telegram |
| Campanha sem grupo aberto | Webhook |
| Campanha pausada por conteúdo repetido | E-mail, Telegram, Webhook |
| Webhook desativado por falhas | E-mail, Telegram |

Os dez primeiros aparecem com o módulo WhatsApp; **Webhook desativado por falhas**, com o módulo de API.

E-mail e Telegram vão para o dono do workspace. Quando um canal está indisponível, a linha diz o que falta: e-mail do dono ou remetente indisponível; bot com dono e token não configurado; ou, no webhook, o módulo de API e um webhook ativo que assine aquele evento. Os webhooks se cadastram em **Organização**, pelo atalho **Gerenciar destinos e eventos dos webhooks em Organização** ([webhooks](/docs/api/webhooks/)).

Desligar um webhook por tipo afeta novos eventos. Entregas já na fila conservam suas tentativas. Alertas de segurança e autenticação ficam sempre ligados.

### Prévia do e-mail de incidente

Mostra o assunto e o texto que a sonda usa, com nomes de exemplo. **Ver aparência do e-mail** abre a versão com o visual real. Abrir a prévia não envia mensagem.

### Relatório diário

Resumo do dia anterior por e-mail. O acesso acompanha a liberação de Tráfego e campanhas, que ainda está em acesso restrito: para as outras contas, o cartão mostra **Indisponível para esta conta enquanto Tráfego e campanhas estiver restrito.**

## Busca global

Use **Ctrl+K** no Windows ou **⌘K** no Mac, ou o botão **Buscar** no topo do painel. A busca abre as telas do bot, troca de bot e encontra campanhas, grupos, números e incidentes do workspace selecionado. Use as setas para escolher, Enter para abrir e Esc para fechar.

Na busca também ficam os atalhos de telas que não estão no menu, como **Ir para Bots** e **Ir para Organização**.

A busca só consulta os módulos disponíveis e apaga os resultados anteriores quando você troca de conta ou de workspace. Incidentes na busca se limitam aos 200 mais recentes; use a tela Incidentes para consultar abertos ou fechados separadamente.

## Perguntas frequentes

### Onde ficam Incidentes e Notificações?

Incidentes é uma aba da tela WhatsApp (WhatsApp → Incidentes) e exige o módulo WhatsApp. Notificações fica em Configurar → Notificações e exige o módulo WhatsApp ou o módulo de API.

### Quem pode mudar as notificações?

Só o dono ou um administrador da organização. Os outros membros veem as opções sem poder alterar.

### Para quem vão os avisos por e-mail e Telegram?

Para o dono do workspace.

### Preciso fechar um incidente à mão?

Não, exceto a edição que não chegou ao WhatsApp, em que você escolhe entre apagar nos grupos e deixar como está. Os outros fecham sozinhos quando a recuperação é confirmada.
