O cliente já tem a própria conta de negócios (BM) e a WhatsApp Business
Account (WABA) dentro dela. Você vai operar o número dele pelo seu painel, sem transferir
nada de dono. Os ativos continuam sendo dele — e a cobrança das conversas vai para o meio
de pagamento dele, direto com a Meta.
1. Peça acesso ao cliente
Ele precisa te adicionar como administrador na conta de negócios dele.
Copie o texto abaixo e mande para ele:
Oi! Para eu configurar o atendimento por WhatsApp, preciso de acesso à sua conta de negócios da Meta:
1. Acesse business.facebook.com
2. Engrenagem (Configurações do Negócio) → Usuários → Pessoas
3. Clique em Adicionar
4. Informe o e-mail: robson@agenciatrp.com
5. Marque a função Administrador
6. Em "Ativos", conceda acesso à sua conta do WhatsApp (WABA)
7. Envie o convite
Confirma também, por favor:
- A conta de negócios está verificada?
- O número já está cadastrado e verificado no WhatsApp Manager?
- Você tem o PIN de 6 dígitos desse número?
2. Aceite o convite
Chega um e-mail da Meta. Aceite e confirme que você consegue ver a BM do cliente em
business.facebook.com — o seletor de contas fica no topo.
3. Crie um app dentro da BM do cliente
Este é o passo que decide tudo. O app precisa pertencer à BM do cliente,
a mesma onde está a WABA. Se você usar o app da TRP para acessar a WABA dele, aí sim
a Meta exige a designação de Tech Provider, com App Review e verificação de acesso.
Criando o app na BM dele, nada disso é necessário.
Em developers.facebook.com → Meus Apps → Criar app.
Escolha o tipo Empresa / Negócios.
No campo de conta de negócios, selecione a BM do cliente — não a da TRP.
Dentro do app, adicione o produto WhatsApp.
Se o cliente já tiver um app com WhatsApp na BM dele, pode reaproveitar — pule para o passo 4.
4. Gere o token na BM do cliente
Nas Configurações do Negócio da BM dele → Usuários → Usuários do sistema → Adicionar.
Nome: disparador-trp, função Administrador do sistema.
Adicionar ativos duas vezes: o app criado no passo 3, e a WhatsApp Account do cliente. Controle total nos dois.
Gerar novo token → escolha o app → expiração Nunca → marque
whatsapp_business_messaging e whatsapp_business_management.
Copie o token na hora — ele não aparece de novo.
5. Aponte o webhook do app dele para cá
No app do cliente → WhatsApp → Configuração:
Verify token: invente um novo, diferente de todas as outras contas. Guarde — vai no cadastro.
Clique em Verificar e salvar.
Logo abaixo, assine o campo messages.
6. Junte as 5 credenciais
phone_number_id e waba_id — no app dele, em WhatsApp → API Setup
access_token — o do passo 4
app_secret — no app dele, Configurações → Básico
verify_token — o que você inventou no passo 5
Tudo do cliente. Nenhuma credencial da TRP entra aqui.
7. Cadastre no painel
+ Nova conta — use um apelido que identifique o cliente.
Testar — precisa voltar o nome verificado do número dele.
Registrar nº — com o PIN de 6 dígitos que o cliente informou.
Inscrever app — sem isso nenhuma mensagem chega.
8. Dê acesso ao cliente (opcional)
Em Admin → + Novo usuário, crie a pessoa como Atendente
e vincule somente à conta dela. Ela vai ver o inbox do próprio número e
nada dos outros clientes — o bloqueio é no banco, não só na tela.
Antes de fechar o primeiro contrato
Se o cliente te remover da BM, o token gerado lá para de funcionar e aquele
número sai do ar no painel. Os ativos são dele — isso é o correto, mas precisa estar claro
no acordo.
LGPD: ao guardar as conversas dos clientes do seu cliente no seu banco,
a TRP passa a ser operadora de dados de terceiros. Isso pede um contrato de
tratamento de dados entre vocês. Vale conversar com um advogado antes do primeiro contrato.
Escala: este caminho é manual, um cliente por vez. Funciona bem até uns
10–15. Acima disso, compensa avaliar a designação de Tech Provider com Embedded
Signup — que exige App Review e é uma decisão permanente do app.
Antes de tudo: o número precisa estar livre
O número não pode estar em uso num WhatsApp comum nem no WhatsApp Business
do celular. Se estiver, apague a conta daquele número no aplicativo antes
(no app: Configurações → Conta → Apagar minha conta) e espere alguns minutos.
Ele também precisa receber SMS ou ligação para a verificação.
1. Cadastrar o número na Meta
Em business.facebook.com → WhatsApp Manager → Números de telefone:
Clique em Adicionar número de telefone.
Preencha o nome de exibição — é o que o cliente vê. Passa por aprovação da Meta e precisa ter relação com o seu negócio.
Escolha categoria e descrição do negócio.
Verifique o número por SMS ou ligação.
Defina o PIN de 6 dígitos (verificação em duas etapas) e anote — você vai precisar dele no passo 3 aqui do painel.
2. Pegar as 5 credenciais
Campo
Onde encontrar
phone_number_id
developers.facebook.com → seu app → WhatsApp → API Setup. Selecione o número novo no seletor From e copie o "Phone number ID".
waba_id
Mesma tela, ao lado: "WhatsApp Business Account ID".
access_token
Se o número está na mesma BM das contas que você já tem: use o mesmo token de System User. Se for outra BM: Business Settings → Usuários do sistema → novo usuário → adicionar o App e a WABA como ativos → Gerar token com expiração Nunca e os escopos whatsapp_business_messaging e whatsapp_business_management.
app_secret
developers.facebook.com → app → Configurações → Básico → "App secret" (botão Mostrar). É o mesmo para todos os números do mesmo app.
verify_token
Você inventa. Use um diferente para cada conta —
a verificação do webhook casa por esse token, e dois iguais criam ambiguidade.
3. Cadastrar aqui no painel
Clique em + Nova conta e cole as 5 credenciais.
Testar — deve voltar o nome verificado e o número. Se falhar aqui, o problema é o token ou o phone_number_id; não siga adiante.
Registrar nº — informe o PIN de 6 dígitos do passo 1. Sem isso, o envio falha com (#133010) Account not registered.
Inscrever app — sem esse passo nenhuma mensagem chega. Configurar a URL no painel da Meta não substitui.
4. Só se o número estiver em outro app da Meta
Se o número novo pertence a outro app (não ao DisparadorTRP), configure o webhook daquele app
apontando para a mesma URL, com o verify_token que você escolheu, e assine o campo messages:
Números do mesmo app já usam este webhook — não precisa reconfigurar.
Se der errado
(#131005) Access denied
O token é de usuário comum ou não tem os ativos. Precisa ser de System User, com o App e a WABA adicionados. Confira o tipo do token no Graph API Explorer → Debug.
(#133010) Account not registered
Faltou o passo Registrar nº com o PIN.
(#131030) Recipient not in allowed list
Isso só acontece com número de teste. Em número de produção não existe lista de permitidos. Se aparecer num número de produção, na prática costuma ser problema de token.
Testou tudo e a mensagem não chega no inbox
Quase sempre é o Inscrever app que não foi feito, ou o campo messages que não foi assinado no webhook.
Depois de conectar
Números novos começam com limite de 250 mensagens por dia, que sobe conforme
qualidade e volume. Faça um primeiro disparo pequeno (20–30 contatos) antes de escalar:
denúncias logo no início derrubam a qualidade do número, e recuperar é difícil.
Lembre também de vincular o número aos atendentes em Admin.