Muita coisa no BotoZap acontece nos bastidores: entregar os avisos aos seus webhooks, guardar as fotos e os documentos das conversas, acompanhar a saúde das suas contas do WhatsApp. Configurações › Operação mostra se esse trabalho está andando, avisa quando algo travou e deixa você reenviar o que falhou. É também onde você investiga, com detalhe, envios de mensagem que deram errado.
É uma tela técnica. Você vai usá-la pouco, em geral a pedido do suporte ou do desenvolvedor da integração.
A tela abre com o título Operação e o botão Atualizar. Logo abaixo fica o painel Investigar envios, seguido dos quadros de saúde, avisos e tarefas esgotadas.
Antes de começar
- A tela é da conta inteira. A investigação de envios começa preenchida com o cliente escolhido no seletor do topo, mas você pode ampliar para a conta toda.
Como o BotoZap organiza o trabalho
O BotoZap guarda cada tarefa numa fila e vai executando uma por uma. Se uma tarefa falha, ele tenta de novo sozinho. Se ela falha em todas as tentativas, fica esgotada: guardada à parte, sem se perder, até você decidir reenviar.
Saúde das filas
No alto, Saúde das filas traz uma situação geral e um quadro para cada fila da sua conta:
- Entregas aos webhooks: a entrega dos avisos aos seus webhooks.
- Arquivos das conversas: a cópia das fotos, vídeos, áudios e documentos das conversas para o armazenamento do BotoZap.
Cada quadro mostra a situação (Saudável, Degradado, Crítico ou Indisponível) e quatro números:
- Na fila: tarefas esperando a vez.
- Em andamento: tarefas sendo executadas agora.
- Tentando de novo: tarefas que falharam e vão ser tentadas de novo.
- Esgotadas: tarefas que falharam em todas as tentativas e esperam reenvio.
Abaixo aparecem Espera mais longa (há quanto tempo a tarefa mais antiga espera), Última passada (a última vez que o BotoZap passou pela fila) e Último sucesso. Quando algo está fora do normal, o motivo aparece em destaque logo embaixo, em frases como "A tarefa mais antiga espera há 10 minutos; o normal é até 5 minutos."
Indisponível quer dizer que a leitura da fila falhou naquele momento, não que a fila está vazia. Clique em Atualizar, no alto da tela, para ler de novo.
Alertas
Em Alertas:
- Avisos ativos: o que precisa de atenção agora. Cada aviso tem um nome, a parte afetada (por exemplo, Entregas aos webhooks) e uma frase dizendo o que é e o que fazer. Quando o aviso é de uma transmissão, o link Ver transmissão → abre a transmissão.
- Últimas 24h: os avisos do último dia, marcados como ativo ou resolvido.
Sem nada pendente, aparece Nenhum aviso ativo.
Os avisos mais comuns:
- Fila atrasada ou Fila parada: há tarefas esperando mais do que o normal. O BotoZap tenta de novo sozinho; se continuar, fale com o suporte.
- Tarefas esgotadas: algumas tarefas falharam em todas as tentativas. Corrija a causa e reenvie em Tarefas esgotadas (reenviar).
- Avisos retidos: há avisos guardados para um webhook pausado ou desativado. Corrija o endereço e use Testar e ativar em Webhooks: os retidos voltam a ser entregues.
- Transmissão bloqueada ou Transmissão parada: abra a transmissão pelo link para ver o motivo.
- Entrega bloqueada pela Meta, Violação de política na Meta ou Conexão do WhatsApp incompleta: confira e, se preciso, reconecte em Configurações › Canais.
- Muitos erros na API: uma integração está recebendo muitos erros. Peça ao desenvolvedor para conferir em Logs de API.
- Verificação indisponível: não foi possível verificar aquela parte agora. Não quer dizer que está tudo bem; confira de novo em instantes.
Cada aviso tem também Detalhe para o suporte, recolhido: é o texto técnico que ajuda o suporte a localizar o caso. Se precisar de ajuda, copie esse detalhe na conversa com o suporte.
Passo a passo: reenviar tarefas esgotadas
Em Tarefas esgotadas (reenviar) há um quadro por fila:
- Esgotadas · Entregas aos webhooks: avisos que não chegaram ao seu webhook depois de todas as tentativas. Cada item mostra o tipo de aviso e o motivo resumido, como o destino falhou (erro 5xx) ou sem resposta a tempo.
- Esgotadas · Arquivos das conversas: arquivos que não foram copiados.
Antes de reenviar, corrija a causa. Um aviso de webhook, por exemplo, só vai chegar se o sistema de destino estiver funcionando: confira em Webhooks.
- Marque os itens que quer reenviar. Dá para marcar até 20 de cada vez.
- Clique em Reprocessar no alto do quadro.
- Confirme em Confirmar.
Para um item só, use o botão Reprocessar da própria linha, sem confirmação.
O item volta para a fila com as tentativas zeradas, e a mensagem diz quantos itens foram reenviados. Se aparecer Nada a reprocessar: itens já reprocessados ou com estado alterado., alguém já reenviou esses itens ou eles mudaram de situação. Nada foi duplicado.
O quadro Esgotadas · Recebimento da Meta não tem botão: reenviar o que chega da Meta é uma operação da plataforma. A própria tela traz o e-mail do suporte para esse caso.
Envios de transmissão não aparecem aqui. Uma mensagem de transmissão com resultado incerto é tratada na própria transmissão, em Transmissões.
Respostas de transmissões
Atribuição das respostas mostra como o BotoZap ligou as respostas dos contatos às transmissões que eles receberam:
- Responderam em cima da mensagem: o contato usou "Responder" em cima da mensagem da transmissão. O vínculo é certo.
- Escreveram uma mensagem nova: o contato escreveu uma mensagem nova em até 7 dias depois da transmissão, e o BotoZap ligou a resposta a ela pelo prazo.
Conexões provisórias do WhatsApp
Às vezes a conexão com a Meta não termina do jeito normal. Para você não ficar parado, o BotoZap liga a conta do WhatsApp com a própria credencial de parceiro da Meta. O número envia e recebe normalmente, mas a conexão é provisória.
O quadro Credencial de parceiro, em Conexões provisórias do WhatsApp, lista essas contas com o selo Conexão provisória e a data. Para trocar pela sua própria autorização:
- Abra Configurações › Canais.
- Clique em Conectar meu WhatsApp e conecte a mesma conta.
- Volte a Operação: a conta sai da lista.
Sem nenhuma conta nessa situação, o quadro diz que todas foram conectadas com a sua própria autorização.
Investigar envios
O painel Investigar envios junta, para um período, tudo o que o BotoZap sabe sobre as tentativas de envio de mensagem: o estado atual das conexões e dos números, as tentativas de envio pela API, as falhas que a Meta avisou depois e os avisos de saúde da conta do WhatsApp. Use quando o suporte pedir ou quando uma integração estiver com envios recusados.
- Em Cliente, deixe o cliente já escolhido ou selecione Todos os clientes para consultar a conta toda.
- Em Número, escolha um número pelo nome ou deixe Todos os números.
- Em De (UTC) e Até (UTC, inclusive), escolha as datas. O período pode ter até 31 dias. As datas seguem o horário universal (UTC), três horas à frente de Brasília.
- Em Ambiente, escolha Produção, Sandbox ou Não coletado (logs antigos).
- Clique em Consultar evidências.
Se a tela não conseguir carregar a lista de clientes e números, ela avisa e a consulta continua valendo para a conta toda.
O resultado mostra:
- Conexões e Números agora: a situação atual de cada número e da conexão com a Meta, com o link Abrir Canais da Conta atual. Atenção: é o estado de agora, não o do momento de um erro antigo.
- Tentativas síncronas · POST /api/v1/messages: cada tentativa de envio pela API, com o código de resultado e o próximo passo sugerido.
- Eventos da Conta · falhas assíncronas da Meta: mensagens que a Meta aceitou e depois avisou que falharam.
- Eventos da Conta · saúde da WABA: avisos da Meta sobre restrições e bloqueios da conta do WhatsApp.
- Como verificar a recuperação: os passos para confirmar que o problema foi resolvido. Quando o problema é de conexão, o passo manda reconectar em Configurações › Canais.
Cada lista mostra até 200 itens. Se o recorte tiver mais, a tela avisa: diminua o período ou escolha um número.
Importante: a tela lembra que um envio aceito não prova que a mensagem foi entregue. A recuperação só está confirmada quando uma mensagem real, enviada depois da correção, aparece como entregue ou lida em Mensagens. Se o resultado de um envio for desconhecido, confira antes de reenviar, para o contato não receber em dobro.
Para mandar ao suporte, anote o período, o cliente, o número, o ambiente e os códigos dos registros. Não copie conteúdo de mensagens nem chaves. Veja Registros de API, Meta e webhooks.
Exclusão da conta
Se houver um pedido de exclusão da conta em andamento, aparece o quadro Exclusão da conta, com a situação, a etapa atual e a data da solicitação.
Problemas comuns
Aparece "Máximo de 20 itens por reprocessamento." Reenvie em lotes de até 20.
Aparece "Muitos reenvios seguidos. Aguarde um instante e tente novamente." Há um limite de reenvios seguidos. Espere um pouco.
A investigação responde "Consulta indisponível ou recorte inválido." Confira se o período tem até 31 dias. Se a conta tiver muitos números, escolha um cliente ou um número.