WhatsApp

Tipo

Conceito

Para

Administrador do Tenant, Parceiro whitelabel

Na tela

HEC › Tenants › Instâncias de Whatsapp / WhatsApp oficial

O alerta sai pelo WhatsApp de um entre dois tipos de número: uma instância conectada por QR code, como um WhatsApp comum num celular, ou a conta oficial da Meta, pela Cloud API. O destino é sempre o Telefone do perfil de cada destinatário, em minha conta.

	Instância (QR code)	Conta oficial da Meta
Onde se configura	Aba Instâncias de Whatsapp	Aba WhatsApp oficial
Formato da mensagem	Uma mensagem por item; acima de 4 anexos (gráfico, Dashboard ou relatório em PDF), um PDF consolidado	Sempre um PDF anexado a um template aprovado pela Meta
Cobrança da Meta	Não há	A Meta cobra as conversas no cartão da conta conectada

Qual número envia

Para cada envio, o Lumo procura um número nesta ordem e para no primeiro que encontrar:

1. Instância vinculada ao Tenant.
2. Instância vinculada ao Cliente do Tenant.
3. Conta oficial da Meta conectada no Tenant.
4. Conta oficial da Meta conectada no Cliente.
5. Número oficial da HorusBI, que vale para todo Tenant sem nada configurado.

Instância vence conta oficial em qualquer nível: um Cliente com instância faz todos os Tenants dele enviarem pela instância, mesmo o Tenant que tem conta Meta própria. Para um Tenant usar a conta Meta, nem ele nem o Cliente podem ter instância vinculada.

Instância encontrada e desconectada não cai para o próximo da lista: o envio falha com Canal temporariamente indisponível até alguém reconectar.

A conta Meta sai da fila quando um envio falha por credencial (token revogado, permissão perdida) ou por número sem registro na Cloud API. Esse envio falha, e os seguintes vão para o próximo número da lista. Pendência de pagamento ou bloqueio da Meta não tira a conta da fila. Depois de resolver do lado da Meta, salve as credenciais de novo para a conta voltar; Verificar agora não faz isso.

Se nada for encontrado, a entrega pelo WhatsApp fica registrada com erro para aquele destinatário, e os outros canais seguem.

Instância por QR code

Na aba Instâncias de Whatsapp do Tenant ou do Cliente, Nova instância WhatsApp pede um Nome e o Número com DDI e DDD (554399999999). Depois de Criar, o Lumo mostra um código: no celular do número, abra Aparelhos conectados › Conectar um aparelho › Conectar com número de telefone e digite o código. Para usar QR code, abra Preferir escanear QR Code.

O celular continua sendo o dono do número. Se ele ficar sem internet por muito tempo ou desconectar o aparelho, a instância cai e os alertas falham até reconectar.

Em Tenants em trial ou pré-pagos, a aba fica visível só para a equipe da plataforma.

Conta oficial da Meta

A conta oficial exige uma conta WhatsApp Business na Meta, com número dedicado, cartão de crédito e um aplicativo próprio. São dois passos:

1. Preparar a conta na Meta, do lado do Gerenciador de Negócios.
2. Conectar no Lumo, na aba WhatsApp oficial.

A mensagem sai num template aprovado pela Meta, com o conteúdo do alerta num PDF anexado. Sem template escolhido, o Lumo usa o template alerta_bi_novo, em pt_BR, que precisa existir na conta conectada. Fora da janela de 24 horas desde a última mensagem do destinatário, a Meta só aceita mensagem em template, por isso o formato é fixo.

Erros comuns

O Histórico de Envio mostra um texto curto por falha na lista e o erro técnico no detalhe da entrega.

Na lista	No detalhe	Causa
Seus dados de contato para este canal parecem incorretos		Destinatário sem telefone no perfil, ou o número não tem WhatsApp
Canal temporariamente indisponível	WhatsApp: instância <nome> desconectada	A instância do Tenant ou do Cliente está desconectada
Não foi possível enviar. Se persistir, contate o suporte.	Meta error 132001	O template não existe na conta Meta, ou o nome e o idioma não batem
Não foi possível enviar. Se persistir, contate o suporte.	Meta error 133010	O número da conta Meta não foi registrado na Cloud API

Relacionado

• Canais e entrega
• Tenants