Campanhas, diagnóstico e segurança operacional
Rotina para campanhas, verificação de falhas, filas técnicas, logs, auditoria e governança de credenciais.
Acompanhar comunicação ativa
Campanhas devem ser operadas com acompanhamento de fila, falhas e histórico. Use volume controlado e revise regras do WhatsApp antes de disparos.
- Acesse Campanhas.
- Confira campanha, instância, status e volume planejado.
- Valide mensagem, público e critérios internos de consentimento.
- Acompanhe fila de envio e falhas.
- Exporte dados da campanha quando precisar auditar resultado.
Preparar campanha sem perder rastreabilidade
Campanha envolve comunicação ativa. Antes de enfileirar destinatários, confirme base, consentimento, opt-out, instância e capacidade diária.
Antes de ativar
- Defina objetivo, público e responsável pela campanha.
- Remova contatos sem base operacional ou com opt-out.
- Valide texto, mídia, links e dados variáveis.
- Confira se a instância está conectada e com fila saudável.
- Cheque limite diário do plano e cadência esperada.
Durante a execução
- Acompanhe enviados, enfileirados, bloqueados, falhas e cancelados.
- Pause se houver erro repetido, reclamação ou limite atingido.
- Não reimporte destinatário bloqueado sem revisar motivo.
- Exporte resultado somente para análise autorizada.
Status de campanha e destinatário
Entender status evita duplicar envio e ajuda a separar erro de validação, bloqueio e fila normal.
| Status | Onde aparece | Significado |
|---|---|---|
| Rascunho | Campanha ou destinatário | Ainda não entrou em processamento real. |
| Pronto | Destinatário | Registro validado e apto a entrar na fila. |
| Enfileirado | Destinatário e mensagem | Envio criado e aguardando worker ou provedor. |
| Enviado | Destinatário e mensagem | Provedor aceitou o envio. |
| Falhou | Destinatário e mensagem | Houve erro de validação, conexão, limite ou provedor. |
| Bloqueado | Destinatário | Contato não deve receber, geralmente por opt-out ou regra interna. |
| Pausado | Campanha | Execução interrompida sem cancelar registros. |
| Cancelado | Campanha ou destinatário | Envio interrompido e não deve seguir. |
Onde investigar falhas
Falhas de atendimento podem vir de conexão WhatsApp, webhook, fila de envio, automação, regra, permissão ou plano.
| Sintoma | Primeira tela | O que verificar |
|---|---|---|
| Mensagens não chegam | Instâncias | Status conectado, webhook ativo, eventos recentes e número correto. |
| Mensagens não enviam | Detalhe da instância | Fila assíncrona, limites, status remoto e erro de envio. |
| Conversa cai na fila errada | Roteamento | Departamento padrão, regra ativa, prioridade e filtros. |
| Chatbot parou | Execuções | Nó atual, timeout, fallback, erro de API, erro de IA ou handoff. |
| Webhook externo falhou | Entregas | Status HTTP, tempo de resposta, URL, segredo e payload. |
| Usuário não vê recurso | Usuários | Permissão, vínculo de departamento, workspace ativo e limite do plano. |
Checklist de investigação
Use esta sequência antes de alterar configuração sensível.
- Confirme se o problema acontece em uma instância, em um departamento ou no workspace inteiro.
- Verifique status da instância e últimos eventos de webhook.
- Abra a conversa afetada e confirme protocolo, instância, departamento e responsável.
- Revise logs de chatbot, regra ou entrega externa quando a falha envolver automação.
- Confirme se o plano permite a capacidade usada.
- Reproduza com um contato de teste antes de mexer em produção.
- Documente a alteração feita e o horário para auditoria posterior.
Governança de acessos e credenciais
Credenciais de instância, URLs privadas, segredos de webhook e dados pessoais não devem aparecer em documentação, prints, tickets públicos ou commits.
Não exponha
- Tokens de instância WhatsApp.
- Segredos de webhook ou assinatura.
- URLs com credenciais embutidas.
- Números de telefone e mensagens reais em prints públicos.
- Dados pessoais de clientes usados em testes.
Faça sempre
- Use usuários nominais, sem conta compartilhada.
- Remova acesso de usuários que saíram da operação.
- Restrinja administradores ao mínimo necessário.
- Revise webhooks e regras ativas periodicamente.
- Use clientes fictícios em prints de documentação.
Limites e capacidade
Quando uma função não aparece ou deixa de processar, verifique limites do plano antes de investigar código ou integração externa.