Conectar o WhatsApp manualmente (configuração avançada)

A Meta divide as configurações em dois lugares distintos. É isso que causa a maior parte da confusão:

• developers.facebook.com/apps — onde fica o app, o número de WhatsApp, o App Secret e o webhook.
• business.facebook.com — onde você gera o Access Token permanente (Usuários do sistema).

Cada passo abaixo começa dizendo qual dos dois abrir.

Se você ainda não tem um app criado, comece aqui. Se já tem, pule para o passo 2.

1. Abra developers.facebook.com/apps e clique em Criar app.
2. Escolha o tipo Negócios e avance.
3. Dê um nome ao app (pode ser o nome da sua empresa), escolha sua conta de negócios e clique em Criar app.
4. Na tela de produtos, encontre WhatsApp e clique em Configurar.
5. Siga o assistente da Meta para registrar o seu número de WhatsApp Business nesse app. Quando terminar, você cai na tela de Configuração da API.

Em developers.facebook.com/apps, abra seu app e vá em WhatsApp → Configuração da API. Nessa tela aparecem dois IDs que você precisa copiar:

• “ID do número de telefone” — código numérico longo (ex.: 749184494943476). Não é o número de telefone em si, que aparece logo ao lado.
• “ID da Conta do WhatsApp Business” (WABA ID) — outro código numérico, na mesma tela, logo acima ou abaixo do número. É o identificador da sua conta de negócios no WhatsApp. Copie os dois antes de sair dessa página.

Agora mude de site. Abra business.facebook.com e vá em Configurações do Negócio.

Na tela de Configuração da API do desenvolvedor existe um token temporário que parece prático, mas ele expira em 24 horas. Não use esse. Gere um permanente assim:

1. No menu lateral, clique em Usuários do sistema.
2. Crie um novo usuário (ou selecione um existente) e clique em Adicionar ativos. Dê acesso ao seu app e à conta do WhatsApp Business.
3. Clique em Gerar novo token, escolha o seu app e marque as duas permissões: whatsapp_business_messaging e whatsapp_business_management.
4. Copie o token e guarde. Ele não aparece de novo.

As duas permissões são obrigatórias: a primeira deixa a Nora enviar e receber mensagens, e a segunda deixa ela preparar os modelos de mensagem para contatos fora das 24h. Sem a segunda, a conexão falha.

Volte para developers.facebook.com/apps, abra seu app e vá em Configurações do app → Básico. No campo Chave Secreta do App, clique em Mostrar (a Meta pede sua senha do Facebook). Copie o valor.

Essa chave fica nas configurações gerais do app, fora da seção do WhatsApp. É por isso que parece difícil de achar.

Ainda no painel do desenvolvedor, vá em WhatsApp → Configuração → Webhook. Cole a Callback URL e o Verify token que aparecem na tela de conexão da Nora, e inscreva o campo “messages”. Isso faz as mensagens chegarem até a Nora.

Volte para a Nora em Configurações → Canais. Cole os quatro valores no formulário:

• Phone Number ID
• WhatsApp Business Account ID (WABA ID)
• Access Token
• App Secret

Clique em Conectar. Se tudo estiver certo, a Nora valida, conecta, e já começa a preparar os modelos de mensagem para contatos fora das 24h.

“O Access Token expirou ou é inválido”: você usou o token temporário da tela de Configuração da API (expira em 24h) ou copiou incompleto. Gere um token permanente de Usuário do Sistema, conforme o passo 3.

“O Phone Number ID não foi encontrado”: você colou o número de telefone em vez do ID. Volte ao passo 2 e copie o código numérico.

“Não identificamos a conta WhatsApp Business”: falta a permissão whatsapp_business_management no token. Gere o token de novo com as duas permissões marcadas.

Se esse processo parece trabalhoso, use o botão Conectar com Meta na tela de Canais. Ele abre o login da Meta, você escolhe o número, e a Nora cuida do resto. Sem token, sem App Secret, sem webhook.

Travou em algum passo? Fale com o suporte da Nora e a gente conecta junto com você.