Como Ativar a API Oficial do WhatsApp

Processo simplificado. Se precisar de ajuda durante a implementação entre em contato com o suporte. As configurações da Meta são consideravelmente confusas.

Este é um guia direto e prático para criar e ativar a API Oficial do WhatsApp (Cloud API / WABA).

Pré-requisitos:

• Conta no Facebook
• Um número de telefone (novo ou existente, mas que não esteja no app WhatsApp)

A Cloud API oferece alta estabilidade e nenhum risco de banimento, desde que usada corretamente.

Passo 1: Obter um Número de Telefone

Você tem duas opções:

Opção 1: Comprar um número virtual (recomendado)

• Ideal para testes
• Custo baixo
• Exemplo: Salvy
• As ligações/SMS de verificação podem ser encaminhadas para seu celular pessoal

Opção 2: Usar um número existente

• Se o número já tiver WhatsApp (pessoal ou Business), é obrigatório excluir a conta
• Caminho:
• Configurações → Conta → Excluir minha conta
• Apenas apagar o app NÃO funciona

⚠️ Atenção

• Um número ativo na API Oficial não pode ser usado no WhatsApp do celular
• Você pode utilizar a nossa plataforma de mensagens
• Para testes, use sempre um número virtual

Passo 2: Criar o Aplicativo na Meta

1. Acesse o Meta for Developers (opens in a new tab)
2. Faça login com sua conta do Facebook
3. Clique em Criar aplicativo
4. Selecione:

• Tipo: Outro
• Categoria: Business

5. Defina um nome (ex: Rishi API)
6. Vincule ao Business Manager

• Se não tiver, será necessário criar seguindo os passos exibidos

7. Conclua o processo de criação do app

Passo 3: Ativar o App para Produção

Antes de adicionar o número, o app não pode estar em modo desenvolvimento.

1. No painel do app, vá em:

• Configurações do app → Básico

2. Preencha:

• URL da Política de Privacidade
• URL dos Termos de Serviço

3. Salve
4. No topo da página ou na barra esquerda, altere o status de:

• Em desenvolvimento → Ativo

Passo 4: Adicionar e Verificar o Número

1. No menu lateral, vá em:

• WhatsApp → Configuração da API

2. Role até a Etapa 5
3. Clique em Adicionar número de telefone
4. Preencha os dados do negócio
5. Informe o número com DDI

• Ex: 55 para Brasil

6. Escolha o método de verificação:

• SMS ou ligação

7. Informe o código de 6 dígitos recebido

✅ Número conectado com sucesso

Passo 6: Gerar um Token Permanente (Produção)

O token temporário expira em 24 horas. Para uso em produção, é obrigatório gerar um token permanente.

Criar um Usuário do Sistema

1. Acesse o (Gerenciador de Negócios)[https://business.facebook.com (opens in a new tab)] da Meta
2. Vá em:

• Usuários → Usuários do sistema

3. Clique em Adicionar
4. Crie um usuário com função Administrador

Atribuir o Aplicativo ao Usuário

1. Com o usuário criado, clique em Atribuir ativos
2. Selecione:

• Tipo de ativo: Aplicativos

3. Escolha o aplicativo criado anteriormente
4. Marque a permissão:

• Controle total

5. Confirme

Gerar o Token Permanente

1. Ainda no usuário do sistema, clique em Gerar novo token
2. Selecione:

• Aplicativo: o app criado
• Expiração: Nunca

3. Marque as permissões:

• whatsapp_business_management
• whatsapp_business_messaging

4. Clique em Gerar token
5. Copie o token e armazene em local seguro

Importante

• Esse token não expira
• Ele será usado pelo app Rishi

✅ Pronto! Agora você tem um token permanente para usar a API Oficial do WhatsApp em produção.