Como instalar a API Oficial do WhatsApp da Meta: passo a passo

Comece por aqui, não pela Meta: o assistente mostra a URL do webhook que você vai precisar no passo 5 e guarda os dados conforme você avança.

1. Ainda não tem conta? Crie em aystem.com/register e confirme o código enviado por e-mail.
2. Já tem conta? Entre em aystem.com/login.
3. No menu lateral, abra Comunicação › Chat WhatsApp Oficial.
4. A tela Conectar seu WhatsApp Oficial abre com os cinco passos seguintes.

O app é onde o seu WhatsApp vai funcionar. A Meta guia a criação em algumas telas — siga nesta ordem.

1. Acesse o Meta for Developers e clique em Criar app.
2. Detalhes do app: dê um nome (ex.: “WhatsApp da [sua empresa]”) e informe seu e-mail.
3. Casos de uso: escolha “Conectar-se com clientes pelo WhatsApp”.
4. Empresa: selecione ou crie seu portfólio comercial (Meta Business).
5. Requisitos e Visão geral: clique em Avançar e conclua a criação.

Aqui saem os dois identificadores que o assistente vai pedir. Eles aparecem um embaixo do outro, e trocá-los é erro silencioso — os dois são só dígitos.

1. No menu do app, clique em Casos de uso e abra “Conectar-se com clientes pelo WhatsApp” (ícone de lápis) — isso libera o menu do WhatsApp.
2. Abra WhatsApp › Configuração da API.
3. Na seção Enviar e receber mensagens, selecione ou adicione o número da sua empresa.
4. Copie a Identificação do número de telefone — o primeiro dos dois.
5. Copie a Identificação da conta do WhatsApp Business — logo abaixo do outro.

É o passo mais longo, e a ordem importa: sem atribuir pessoas ao app primeiro, ele não aparece na hora de gerar o token.

1. Primeiro, atribua pessoas ao app. Em Configurações do negócio › Contas › Apps, selecione o app criado. Se não estiver na lista, adicione-o.
2. Clique em Atribuir pessoas e marque, com Acesso total, quem vai administrar. O app precisa de pelo menos um administrador.
3. Depois crie o usuário do sistema. Vá em Usuários › Usuários do sistema e crie um com função Administrador.
4. Com ele selecionado, clique nos três pontinhos › Atribuir ativos, escolha o app e marque Controle total.
5. Repita o Atribuir ativos para a sua conta do WhatsApp, também com Controle total.
6. Clique em Gerar token e siga: Selecionar app → Definir expiração: Nunca → Atribuir permissões (whatsapp_business_management e whatsapp_business_messaging) → Continuar e Concluir.

O webhook é o que faz a mensagem do seu cliente aparecer no chat. Volte ao Meta for Developers — não é o Gerenciador de Negócios onde você gerou o token.

1. No assistente do Aystem, copie a URL de callback que aparece na tela.
2. No app, vá em Casos de uso › Conectar-se com clientes pelo WhatsApp › Configuração.
3. Na seção Webhook, clique em Editar.
4. Cole a URL no campo URL de callback.
5. Em Verificar token, digite qualquer palavra (ex.: aystem) e clique em Verificar e salvar. Essa palavra é livre — não precisa guardá-la.
6. Clique em Gerenciar e assine o campo messages.

Volte ao assistente do Aystem com os três dados em mãos. Ele confere tudo antes de finalizar.

1. Identificação do número de telefone — do passo 3.
2. Identificação da conta do WhatsApp Business — do passo 3.
3. Token de acesso permanente — do passo 4.
4. Clique em Conectar WhatsApp Oficial.