Ajuda / Conectar o WhatsApp

Conectar o WhatsApp

O GrowthOS fala pelo WhatsApp somente pela API oficial da Meta (Cloud API). Este guia lista o que preparar e como o número chega ao seu SDR.

Não use QR Code, WhatsApp Web, extensão de navegador nem qualquer API não oficial. O produto não aceita, e o risco é perder o número.

É seu

Portfólio de negócios e verificação da empresa na Meta
Número dedicado ao SDR
Nome de exibição e modelos de mensagem
Forma de pagamento na Meta

É da Luby

Ligar o número, o ID da conta e o token ao SDR
Manter o webhook e a assinatura
Ativar a conta (contrato e DPA)

Depende de terceiros

Meta: verificação, aprovação do nome e dos modelos, limites de envio

Estado atual. No painel, o número de WhatsApp de cada SDR é ligado pela equipe da Luby. O cadastro pela sua própria conta Meta (Embedded Signup, com a Luby como Tech Provider) está previsto e ainda depende da Meta. Até lá, você prepara os itens abaixo e entrega os dados à Luby por um canal seguro.

O que preparar

Portfólio de negócios no Meta Business, com você como administrador.
Verificação da empresa no portfólio (documento, CNPJ e domínio). Sem ela o limite de envio fica baixo. Pode levar de alguns dias a algumas semanas.
Um número novo, só para o SDR. Ele não pode estar ativo em nenhum WhatsApp, nem no app comum nem no WhatsApp Business do celular. Um número já usado perde o histórico ao ser liberado.
Nome de exibição que o lead vai ver, com relação clara com a empresa. A Meta aprova.
Forma de pagamento no portfólio, antes de enviar modelos.

Passo a passo

Crie o app. Em developers.facebook.com/apps, crie um app do tipo Empresa vinculado ao seu portfólio e adicione o produto WhatsApp.
Registre o número. Em WhatsApp → Configuração da API, adicione o número, informe o nome de exibição e confirme por SMS ou ligação.
Anote dois identificadores. O ID do número de telefone e o ID da conta do WhatsApp Business (WABA). São os dois dados que o painel guarda por SDR.
Crie o token permanente. Em Configurações do negócio → Usuários do sistema, crie um usuário Administrador, atribua o app e a conta do WhatsApp e gere um token sem validade com as permissões whatsapp_business_messaging, whatsapp_business_management e business_management. O token aparece uma única vez.
Entregue os dados à Luby. Envie o ID do número, o ID da conta e o token por um canal seguro combinado com a equipe. Nunca por e-mail comum, chat aberto ou documento compartilhado.
A Luby liga o número ao SDR. Isso registra o número, o ID da conta e o token (guardado cifrado) no cadastro do SDR, que deixa de ser rascunho. Na tela do SDR, o campo Número deixa de mostrar “Aguardando conexão”.
Webhook. O webhook é da plataforma (/webhooks/whatsapp) e a Luby o mantém. Você confirma na Meta que a conta assina os campos messages e message_template_status_update.
Crie os modelos de mensagem. Fora da janela de 24 horas só saem modelos aprovados. Crie-os no WhatsApp Manager, em pt-BR e en-US conforme o seu público.
Teste em copiloto. Mande uma mensagem de um celular de teste para o número e aprove a resposta no painel.

Modelos de mensagem

Modelo	Quando sai
Primeiro contato após formulário	Lead que pediu contato e marcou o opt-in
Segundo follow-up	Depois de alguns dias úteis sem resposta, conforme a política
Lembrete de reunião	Antes da reunião marcada
Aviso de handoff ao account	Para o número do account, com botões de aceite

A Meta reprova texto genérico, variável no começo ou no fim da frase, promessa enganosa e categoria errada. A aprovação costuma sair em minutos ou horas.

Limites, qualidade e custo

O limite de conversas iniciadas pela empresa começa baixo e sobe com a verificação e com boa qualidade. Confira o valor real no WhatsApp Manager.
A nota de qualidade (verde, amarelo, vermelho) cai com bloqueios e denúncias. O painel mostra a nota e para os envios iniciados pelo bot quando ela piora.
A Meta cobra por modelo entregue, conforme categoria e país. A tabela muda a cada trimestre. Consulte a tabela oficial da Meta.

Se der errado

Sintoma	Causa provável	O que fazer
A Meta não aceita registrar o número	O número ainda está ativo em um WhatsApp	Apague a conta do número no app e tente de novo
Nome de exibição reprovado	Sem relação clara com a empresa	Use o nome da empresa ou da marca verificada
SDR continua em “Aguardando conexão”	A Luby ainda não ligou o número	Confirme com a equipe que recebeu os três dados
Mensagem não sai fora da janela	Falta modelo aprovado	Crie e aprove o modelo no WhatsApp Manager
Envios iniciados pelo bot pararam	Nota de qualidade ruim (freio automático)	Reduza o volume, revise os textos e aguarde a nota voltar
Token deixou de funcionar	Token revogado ou usuário do sistema sem acesso	Gere outro token e entregue à Luby pelo canal seguro

Referência oficial: documentação da Cloud API da Meta, em developers.facebook.com/docs/whatsapp/cloud-api.

← Todos os guias