Buscar K
Aparência
Are you an LLM? You can read better optimized documentation at /dataviz/alertas/whatsapp-meta-conectar.md for this page in Markdown format
Conectar o WhatsApp oficial
- Tipo
- Como fazer
- Para
- Administrador do Tenant, Parceiro whitelabel
- Na tela
- HEC › Tenants › WhatsApp oficial (ou HEC › Clientes › WhatsApp Oficial)
As credenciais da conta Meta que envia os alertas ficam na aba WhatsApp oficial. Ela existe no cadastro do Tenant, para um Tenant com conta própria, e no cadastro do Cliente (WhatsApp Oficial), valendo para todos os Tenants dele que não tenham a sua. Cada um tem no máximo uma conexão, e a do Tenant vence a do Cliente. A ordem completa, incluindo as instâncias por QR code, está em WhatsApp.
As credenciais saem da preparação da conta Meta.
Quem vê a aba
A equipe da plataforma e a equipe do Cliente veem sempre. O administrador do Tenant vê quando a HorusBI liberou o recurso para o Tenant (veja recursos em beta).
Conectar
| Campo | O que é |
|---|---|
| WABA ID | Identificador da conta de WhatsApp Business |
| Phone Number ID | Aparece ao lado do WABA ID e é outro número |
| App ID | No topo do painel do aplicativo. Opcional para conectar; necessário para ligar o recebimento e criar template |
| Token permanente | Do usuário do sistema, com expiração Nunca |
| App Secret | Opcional para conectar. Sem ele o envio funciona e o recebimento não |
Conectar (depois da primeira vez, Salvar) testa a credencial na Meta antes de gravar; credencial recusada não é salva. Só testar confere sem trocar a conexão que está valendo. Conectar já põe o número em uso: não existe um passo separado de ativação. Pendência do lado da Meta (número sem registro, pagamento) não impede salvar, e o número passa a ser usado mesmo assim; resolva antes, ou os alertas falham.
O mesmo WABA ID e o mesmo Phone Number ID não podem estar conectados em dois lugares (dois Tenants, ou Tenant e Cliente).
Token e App Secret são gravados criptografados e não voltam à tela. Ao editar, deixar os dois campos como estão mantém os valores guardados.
Lista de prontidão
Com a conexão salva, a aba mostra quatro linhas que dizem se o número funciona de verdade:
| Linha | Responde |
|---|---|
| Enviar alertas | A conexão está ativa e a Meta não bloqueia o envio |
| Receber mensagens | Existe um aplicativo inscrito para receber os eventos da conta |
| Template dos alertas | Qual template os alertas usam, com o botão Escolher. Sem escolha: Usando o padrão da plataforma., que é o template alerta_bi_novo em pt_BR na sua conta |
| Conta na Meta | Pendências de pagamento ou de verificação. Sem nada: Sem pendências. |
Linha com problema traz o botão que resolve. A consulta à Meta roda ao abrir a aba; Verificar agora repete depois de você mexer no painel da Meta. Passando o mouse no ícone vermelho de uma linha, a tela diz Não funciona hoje. Enquanto não resolver, o alerta sai pelo número anterior. Isso só vale quando a conexão saiu da fila (credencial recusada ou número sem registro, veja WhatsApp); com a conta bloqueada pela Meta, o alerta continua tentando este número.
| Mensagem na verificação | Causa e conserto |
|---|---|
Número não registrado na Cloud API. Falta concluir o registro com o PIN de 6 dígitos. | Falta o PIN, do lado da Meta (passo 3 da preparação) |
O token não administra esta conta. Ele precisa ser gerado no app do dono da conta, com a conta de WhatsApp entre os ativos do usuário do sistema. | Token gerado em outro aplicativo, ou conta fora dos ativos do usuário do sistema. Gere outro no passo 5 |
Token inválido ou revogado. | Alguém apagou o usuário do sistema ou tirou a conta dos ativos dele. Gere um token novo e salve de novo |
| Linha Conta na Meta com o código e a descrição da Meta | Pendência de pagamento ou de verificação da empresa, resolvida no Gerenciador de Negócios |
Credenciais e Templates ficam recolhidos abaixo da lista; é onde se corrige o que ela aponta.
Ligar o recebimento
O envio funciona assim que a conexão salva. Para receber confirmação de entrega e leitura, respostas e avisos de template, clique em Ligar webhook na linha Receber mensagens (o botão aparece quando nenhum aplicativo está inscrito). O Lumo inscreve o aplicativo na URL https://webhook.horusbi.com.br/webhook/meta e a conta no aplicativo, usando o App ID e o App Secret guardados; sem App Secret, o botão recusa. O aplicativo precisa estar publicado (modo Ativo) na Meta.
Se a linha mostra mais de um aplicativo inscrito, ela fica em atenção: o outro aplicativo recebe os mesmos eventos e pode responder pelo número.
Templates
A seção Templates lista os templates da conta, com Idioma, Categoria e Situação (e o motivo, quando reprovado). Clique no nome para ver o texto. O template marcado como principal é o que os alertas usam; Usar nos alertas troca o principal. O principal não pode ser excluído.
WARNING
Salvar o formulário de Credenciais desfaz a escolha do template principal, e os alertas voltam para alerta_bi_novo. Depois de salvar credenciais, confira a linha Template dos alertas e escolha o template de novo.
Criar template pede o Nome do template (minúsculas, números e underscore; a sugestão é alerta_bi_novo) e o Corpo da mensagem, que começa com Olá, {{1}}. Aqui está seu relatório de alertas. O corpo precisa ter exatamente um {{1}} (o nome do destinatário), fora do começo e do fim, e até 1.024 caracteres. O template sai com anexo em PDF no cabeçalho, pedido na categoria UTILITY, e vai para aprovação da Meta. Usar nos alertas só aparece depois de aprovado.
CAUTION
A Meta decide a categoria na aprovação e pode reclassificar depois. MARKETING custa mais que UTILITY, e a fatura é de quem conectou a conta. Se um template cair em MARKETING, crie outro com outro corpo e exclua o que não serviu.
A Meta recusa nome repetido, mesmo de template excluído há pouco, e excluir um template apaga todos os idiomas dele.
Desconectar
Desconectar apaga as credenciais do Lumo, e os alertas passam a sair pelo próximo número da ordem: no Tenant, a confirmação diz Os alertas deste tenant deixam de sair por este número.; no Cliente, Os alertas voltam a sair pelo número da plataforma. Nada muda no ambiente Meta: número, conta, templates e histórico continuam lá, e reconectar é preencher o formulário de novo. Para cortar o acesso na hora, apague o usuário do sistema no Gerenciador de Negócios, o que invalida o token.