Preparar a conta Meta

Tipo

Como fazer

Para

Administrador do Tenant, Parceiro whitelabel

Na tela

Meta for Developers e Gerenciador de Negócios

Para enviar alertas pela conta oficial, você precisa de um número de WhatsApp registrado na Cloud API e das cinco credenciais que a aba WhatsApp oficial pede. Todo o trabalho acontece no ambiente Meta da sua empresa: o número, a conta e a fatura ficam com você, e a Meta cobra as conversas direto no seu cartão.

O aplicativo é criado no seu ambiente porque a Meta exige revisão demorada (Advanced Access) de aplicativo que acessa conta de terceiros. Com app e conta seus, essa revisão não se aplica, e cortar o acesso do Lumo é apagar o usuário do sistema que gerou o token.

Os títulos seguem a numeração das etapas do console da Meta.

Antes de começar

• Portfólio Empresarial no Gerenciador de Negócios, com acesso de administrador.
• Número de telefone sem WhatsApp ativo (veja abaixo).
• Cartão de crédito para a conta de WhatsApp.
• URL de Política de Privacidade, exigida para publicar o aplicativo.

Abra a verificação da empresa (passo 7) logo no começo: ela corre em paralelo e o prazo é da Meta.

O número precisa estar livre

Número com WhatsApp é recusado com "Esse número de telefone já está registrado em uma conta do WhatsApp".

Saída	Consequência
Usar outro número, sem WhatsApp	Nenhuma
Excluir a conta do número atual (WhatsApp › Configurações › Conta › Excluir minha conta)	Perde o histórico de conversas e sai dos grupos, sem volta. A liberação leva até três minutos
Manter número e histórico	Só pelo fluxo de Coexistence da Meta, que este caminho não cobre

WARNING

Excluir a conta apaga o histórico de conversas do número para sempre. Se o número atende clientes hoje, use outro.

Linha fixa só verifica por chamada de voz: o pedido por SMS retorna sucesso e o código nunca chega. Depois de uma tentativa falha, a Meta bloqueia novos pedidos por cerca de uma hora, em qualquer canal.

1. Criar o aplicativo

1. Entre em developers.facebook.com/apps com a conta que administra o Portfólio Empresarial.
2. Clique em Criar aplicativo, dê um nome (como Conector WhatsApp) e vincule ao Portfólio.
3. Em casos de uso, marque Conectar-se com clientes pelo WhatsApp e aceite os termos do WhatsApp Business.

Se o app já existe e mostra Sem casos de uso neste app, use + Adicionar casos de uso e marque o mesmo item.

Na tela dos termos, confira o portfólio selecionado: ele vira o dono da conta de WhatsApp, e mover depois dá trabalho.

Anote o App ID, no topo do painel. Em https://developers.facebook.com/apps/<APP_ID>/settings/basic/, clique em Mostrar ao lado de Chave Secreta do Aplicativo e anote o App Secret.

O token (passo 5) envia mensagens; o App Secret confere que as mensagens recebidas vieram da Meta. Um não substitui o outro.

2. Pular a Etapa 1

A Etapa 1, Experimente cria uma conta de WhatsApp de teste, separada da sua, com um número emprestado pela Meta. Os identificadores que aparecem nela são dessa conta descartável. Vá direto para a Etapa 2, Configuração da produção.

3. Adicionar o número

1. Clique em Adicionar número de telefone.
2. Informe o número, o nome de exibição e a categoria da empresa.
3. Escolha a verificação: chamada de voz para fixo, SMS para celular.
4. Digite o código.
5. Defina o PIN de seis dígitos. Sem ele o número não envia.

O nome de exibição passa por aprovação da Meta; use o nome comercial da empresa. Guarde o PIN: ele fica só com você e é necessário para migrar o número depois.

O WABA ID e o Phone Number ID aparecem juntos nesta tela e são números diferentes. Confira que são da sua conta, e não da conta de teste da Etapa 1.

4. Cadastrar o cartão

Ainda na Etapa 2, adicione um cartão de crédito à conta de WhatsApp. Sem cartão, a conta só envia para cinco números cadastrados à mão.

5. Gerar o token

O token precisa vir de um usuário do sistema, porque token de pessoa expira quando ela troca de senha ou sai da empresa.

1. Abra Configurações do negócio › Usuários › Usuários do sistema.
2. Adicionar, com um nome como lumo-api e papel Administrador.
3. Adicionar ativos › Contas do WhatsApp › sua conta, com Controle total.
4. Gerar novo token, escolhendo o aplicativo do passo 1.
5. Expiração Nunca; permissões whatsapp_business_messaging e whatsapp_business_management.
6. Gerar token e copie.

IMPORTANT

O token aparece uma vez só. Trate como senha: quem tem o token envia mensagem em nome da empresa.

Token gerado em outro aplicativo não lê a sua conta, e o Lumo recusa a conexão com O token não administra esta conta.

6. Publicar o aplicativo

Aplicativo em modo de desenvolvimento envia, mas só recebe eventos de teste: nem resposta de cliente, nem confirmação de entrega. Em Configurações do aplicativo › Básico, preencha ícone, categoria e a URL de Política de Privacidade, e mude o app para Ativo no topo do painel. Como o app só acessa a sua conta, publicar não exige App Review.

7. Verificar a empresa

Na Etapa 3, envie os documentos da empresa para a Meta. Enquanto a verificação não sai, o número fica no limite de teste.

O que levar para o Lumo

Credencial	Onde está
WABA ID	Etapa 2, tela do número
Phone Number ID	Etapa 2, ao lado do WABA ID
Token permanente	Passo 5
App Secret	Configurações do aplicativo › Básico
App ID	Topo do painel do app

WABA ID, Phone Number ID e token bastam para conectar e enviar. App ID e App Secret são necessários para receber confirmações e respostas e para criar template pelo Lumo, então leve os cinco.

O webhook não precisa ser configurado na Meta: o Lumo liga o recebimento por API com o App ID e o App Secret, desde que o app esteja publicado. Com os valores, siga para conectar no Lumo.

Problemas conhecidos

Sintoma	Causa
O token não administra esta conta ao conectar	Token de outro aplicativo, ou a conta não está entre os ativos do usuário do sistema. Refaça o passo 5
Erro 133010 ao enviar	Número sem registro. Volte ao passo 3 e defina o PIN
Erro 132001 ao enviar	O template não existe nessa conta, ou nome e idioma não batem com o aprovado
Envia e nunca recebe	App em modo de desenvolvimento. Volte ao passo 6
As primeiras mensagens somem	Conta nova costuma ter os primeiros envios descartados sem erro. Peça para alguém mandar uma mensagem para o número antes
Template aprovado vira MARKETING	A Meta reclassifica por conta própria, e MARKETING custa mais que UTILITY. Template com PDF no cabeçalho e texto curto no corpo tende a ficar em UTILITY