Configurando a API Oficial do WhatsApp (WABA)

Esta documentação detalha o processo completo para configurar a API Oficial do WhatsApp (também conhecida como WABA ou Cloud API) e conectá-la à plataforma Mediar Conversas.

Seguir os passos na ordem correta é fundamental para garantir uma instalação bem-sucedida.

Documentação das etapas:

Etapa 1: Pré-requisitos e Preparação

Antes de começar, você precisará de dois itens essenciais:

  1. Uma conta no Facebook.
  2. Um número de telefone (pode ser virtual ou um chip físico).


AVISO SOBRE O NÚMERO DE TELEFONE

  • Você não pode usar o mesmo número no aplicativo normal do WhatsApp e na API Oficial.
  • Se você deseja usar um número que já possui uma conta de WhatsApp, é obrigatório excluir permanentemente a conta de WhatsApp associada a ele antes de continuar. Não basta apenas deletar o aplicativo.
  • Para testes, recomendamos fortemente a compra de um número virtual.

Etapa 2: Criação e Configuração do Aplicativo na Meta

Nesta etapa, vamos criar o aplicativo no ambiente da Meta que será responsável por gerenciar a API.

  1. Acesse o Facebook for Developers: Faça o login com sua conta do Facebook em https://developers.facebook.com/
  1. Crie um Novo Aplicativo:
  • Clique em “Criar Aplicativo”.
  • Selecione “Outros”
  • Selecione o tipo “Business”.
  • Dê um nome ao seu aplicativo (ex: “Waba Cloud API”) e associe-o à sua conta do Gerenciador de Negócios (BM).
  1. Adicione o Produto WhatsApp: No painel do seu novo aplicativo, encontre e adicione o produto “WhatsApp”.
  1. Configure as Informações Básicas:
  • Acesse “Configurações do app” > “Básico”.
  • Preencha os campos “URL da Política de Privacidade” e “URL dos Termos de Serviço”.
  1. Ative o Aplicativo: No topo da página, mude o status do aplicativo de “Em desenvolvimento” para “Ao vivo”.

Etapa 3: Cadastrando e Verificando seu Número de Telefone

Agora, vamos adicionar e verificar o número de telefone que será usado pela API.

  1. No menu do seu aplicativo, vá para “WhatsApp” > “Configuração da API”.
  1. Adicione um Número de Telefone: Clique no botão para adicionar um novo número.
  1. Preencha os Dados: Insira as informações da sua empresa e o número de telefone que você preparou na Etapa 1.
  2. Verifique o Número: Escolha receber o código de verificação por SMS ou ligação telefônica e insira o código recebido.
  3. Adicione a forma de pagamento
  1. Registre o Número com PIN (Passo Obrigatório):
  • Após a verificação, a Meta exige um registro de segurança com um PIN de 6 dígitos. Este passo é realizado via API. (token provisório)

Etapa 4: Gerando um Token de Acesso Permanente

O token gerado pelo painel do desenvolvedor é temporário e expira em 24 horas. Para uma conexão estável com o Mediar Conversas, você precisa de um token permanente.

  1. Acesse as Configurações do Negócio: Navegue até seu Gerenciador de Negócios (BM).
  2. Vá para “Usuários” > “Usuários do sistema”.
  1. Crie um Usuário do Sistema: Adicione um novo usuário do sistema com a função de “Admin”.
  2. Atribua Ativos: Com o novo usuário selecionado, clique em “Atribuir Ativos”.
  3. Selecione “Aplicativos”, escolha o aplicativo que você criou na Etapa 2 e conceda a permissão de “Gerenciar App”.
  4. Gere o Token: Ainda com o usuário selecionado, clique em “Gerar novo token”.
  • Selecione o seu aplicativo.
  • Defina a expiração como “Nunca”.
  • Marque as permissões necessárias (pelo menos whatsapp_business_management e whatsapp_business_messaging).
  • Clique em “Gerar Token”, copie o código e guarde-o em um local seguro, pois ele não será exibido novamente.

Etapa 5: Conectando a API no Mediar Conversas e Ativando Webhooks

Com tudo pronto no ambiente da Meta, o passo final é configurar a conexão dentro do Mediar Conversas.

  1. Conecte o Canal no Mediar Conversas (Para Enviar Mensagens):
  • No painel Admin do Mediar Conversas, acesse “Canais” e adicione um novo canal do tipo “WABA”.
  • Preencha os campos com as informações obtidas no painel da Meta: Whatsapp – Configuração da API
    • ID do número de telefone
    • ID da conta do WhatsApp Business
    • O Token Permanente que você gerou na Etapa 4.
  • Clique em Salvar. Neste momento, você já estará apto a enviar mensagens.
  1. Ative os Webhooks no Mediar Conversas (Para Receber Mensagens):
  • No painel Admin do Mediar Conversas, vá para “Configurações” > “Integração Meta”.
  • Copie a URL do Webhook e o Token de Verificação.
  • Volte ao painel do seu aplicativo na Meta, em “WhatsApp” > “Configuração da API”.
  • Clique em “Editar” na seção de Webhooks.
  • Cole a URL e o Token copiados do Mediar Conversas e clique em “Verificar e Salvar”.
  • Após verificar, clique em “Gerenciar” e assine (subscribe) todos os eventos de webhook disponíveis (especialmente messages).

Encerramento

Com os webhooks ativos, sua plataforma está pronta para enviar e receber mensagens através da API Oficial do WhatsApp. Esta é a conexão mais estável e segura, recomendada para todas as operações.