Como Configurar o WhatsApp Business API do Zero

Introducao

O WhatsApp Business API e a ferramenta mais poderosa para empresas que desejam escalar sua comunicacao com clientes. Diferente do app WhatsApp Business, a API permite automacao, integracao com sistemas e envio de mensagens em grande volume.

Neste tutorial completo, vamos guia-lo desde a criacao da conta ate o envio da sua primeira mensagem programatica. Ao final, voce tera um ambiente funcional pronto para integrar com seu sistema.

Pre-requisitos

Antes de comecar, certifique-se de ter:

• Uma conta no Meta Business Suite (antigo Facebook Business Manager)
• Um numero de telefone que nao esteja vinculado a nenhuma conta WhatsApp
• Documentacao da empresa para verificacao (CNPJ, site, etc.)
• Conhecimentos basicos de APIs REST

Passo 1: Criando a Conta no Meta Business Suite

Acesse o Meta Business Suite e crie uma conta empresarial. Voce precisara fornecer informacoes basicas sobre sua empresa, como nome, endereco e site. Apos a criacao, navegue ate a secao de WhatsApp nas configuracoes do negocio.

E importante que os dados estejam corretos, pois a Meta verificara as informacoes. Inconsistencias podem atrasar ou impedir a aprovacao da sua conta.

Passo 2: Verificando seu Negocio

A verificacao do negocio e obrigatoria para usar a API em producao. O processo envolve:

1. Upload de documentos oficiais da empresa (contrato social, CNPJ)
2. Verificacao do dominio do site da empresa
3. Confirmacao via email ou telefone corporativo

O processo de verificacao pode levar de 2 a 7 dias uteis. Enquanto aguarda, voce pode usar o ambiente de testes com um numero temporario.

Passo 3: Configurando o App e Obtendo o Token

Com o negocio verificado, crie um novo aplicativo no Meta for Developers. Selecione o tipo Business e adicione o produto WhatsApp. Voce recebera um token de acesso temporario para testes.

Para producao, gere um System User Token permanente atraves das configuracoes do Business Manager. Este token sera usado em todas as chamadas a API.

Dica: Nunca exponha seu token de acesso em codigo frontend ou repositorios publicos. Armazene-o em variaveis de ambiente no servidor.

Passo 4: Registrando o Numero de Telefone

Registre o numero de telefone que sera usado para enviar mensagens. O numero precisa ser capaz de receber um SMS ou ligacao para verificacao. Apos o registro, o numero ficara vinculado a sua conta da API e nao podera ser usado no app WhatsApp convencional.

Passo 5: Configurando Webhooks

Webhooks sao essenciais para receber mensagens e notificacoes de status. Configure um endpoint HTTPS no seu servidor que receba requisicoes POST da Meta. Os eventos principais sao:

• messages — quando um cliente envia uma mensagem
• message_status — confirmacoes de entrega e leitura
• message_template_status — aprovacao/rejeicao de templates

Passo 6: Enviando sua Primeira Mensagem

Com tudo configurado, envie sua primeira mensagem de teste. Use um template pre-aprovado (como o hello_world que vem por padrao) e faca uma chamada POST para a API:

POST https://graph.facebook.com/v18.0/{PHONE_NUMBER_ID}/messages
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "template",
  "template": {
    "name": "hello_world",
    "language": { "code": "pt_BR" }
  }
}

Se tudo estiver correto, voce recebera um 200 OK com o ID da mensagem enviada.

Conclusao

Parabens! Voce configurou o WhatsApp Business API com sucesso. A partir daqui, voce pode criar templates personalizados, configurar chatbots e integrar com seu CRM. Nos proximos tutoriais, abordaremos cada um desses topicos em detalhes.