Manual de Configuração

Configurar novo número WhatsApp no RB Leads

Passo a passo simples para conectar um número novo da API oficial da Meta ao painel do cliente. Siga na ordem — cada etapa depende da anterior.

Antes de começar

  • Você precisa de uma conta no Meta Business aprovada
  • O número de telefone não pode ter WhatsApp ativo (App normal ou Business). Se tiver, desinstale primeiro
  • Tenha em mãos o acesso ao painel do RB Leads do cliente (Settings → Secrets)
1

Criar o App na Meta

Acesse o painel de desenvolvedores da Meta e crie um app para o cliente:

Abrir Meta for Developers

Clique em "Criar App" → escolha "Business" → dê um nome (ex: "WhatsApp Cliente X") → conclua.

2

Pegar o Token de Acesso

No app criado, vá no menu lateral em WhatsApp → API Setup.

Role até a seção "Permanent access token" e copie o token que aparece. Ele começa com EAAG…

⚠️ Guarde esse token em local seguro — ele dá acesso à API do WhatsApp do cliente.

3

Pegar o Phone Number ID

Na mesma tela WhatsApp → API Setup, logo abaixo do token, você verá o campo "Phone number ID".

Copie esse número — é um ID único do número de telefone que será usado para enviar mensagens.

4

Configurar o Webhook na Meta

Agora vá no menu lateral em WhatsApp → Configuration.

No campo "Callback URL", cole a URL abaixo:

URL do Webhook

https://rbleads.rbhub.com.br/functions/aliceWhatsApp

No campo "Verify Token", você precisa usar o token que está guardado no painel do RB Leads:

Vá em Settings → Secrets no painel do RB Leads → copie o valor do secret WHATSAPP_VERIFY_TOKEN → cole no campo "Verify Token" da Meta.

Clique em "Verify and Save". Se aparecer ✓ verde, deu certo.

5

Assinar os campos do Webhook

Ainda em WhatsApp → Configuration, após salvar o webhook, aparecerá uma lista de campos para assinar.

Clique em "Manage" e ative (subscribe) o campo messages. Isso é o que permite o RB Leads receber as mensagens que chegam.

6

Adicionar forma de pagamento (Billing Hub)

Para que o número consiga iniciar conversas (follow-ups automáticos do RB Leads em D+1, D+3, D+7 e D+15), a Meta exige uma forma de pagamento cadastrada. Sem isso, o número só responde a mensagens que o lead enviar primeiro.

Acesse o WhatsApp Manager da conta Business do cliente:

Abrir Billing Hub

Clique em "Adicionar forma de pagamento" → cadastre o cartão de crédito do cliente → conclua. Esse passo é feito por conta própria do cliente, no painel Meta dele — o RB Leads nunca tem acesso aos dados do cartão.

💡 Você tem 1.000 mensagens de serviço gratuitas por mês (respostas a leads). O cartão só é cobrado quando ultrtrapassar esse limite ou para mensagens iniciadas pela empresa (follow-ups).

7

Pegar o App Secret

Vá no menu lateral em App Settings → Basic (ou "Configurações do App → Básico").

Procure o campo "App Secret" e copie o valor. Ele é usado para validar que as mensagens realmente vêm da Meta (segurança).

8

Cadastrar tudo no RB Leads

Agora volte ao painel do RB Leads do cliente e vá em Configurações da IA. Preencha os campos do WhatsApp com os valores copiados da Meta:

Token do WhatsApp → o "Permanent access token" (passo 2)

Phone Number ID → o "Phone number ID" (passo 3)

App Secret → o "App Secret" (passo 6)

Clique em "Salvar configurações". Pronto! 🎉 O número está conectado e a IA já pode atender os leads.

📋 Resumo do que você precisa

Token de acesso permanente
Phone Number ID
App Secret
Verify Token (já no RB Leads)

Em caso de dúvida, o suporte do RB Leads está à disposição. 😊