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 Z-PRO.

Seguir os passos na ordem correta é fundamental para garantir uma instalação bem-sucedida. O processo é dividido em cinco etapas principais: preparação, criação do aplicativo na Meta, registro do número, geração do token e, por fim, a conexão e configuração no Z-PRO.

Vídeo completo no Canal: https://www.youtube.com/watch?v=sLp5P9Qb50w

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).

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.

2. Preencha os Dados: Insira as informações da sua empresa e o número de telefone que você preparou na Etapa 1.

3. 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.

4. 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)

   

   • Utilize uma ferramenta como o Postman e o endpoint "Registrar Fone" (disponível em nossa coleção) para enviar o PIN de 6 dígitos ao seu número. https://www.postman.com/meta/whatsapp-business-platform/request/kkn2spv/register-phone

   • Este passo é crucial para que o número seja ativado com sucesso.

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 Z-PRO, 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 Z-PRO e Ativando Webhooks

Com tudo pronto no ambiente da Meta, o passo final é configurar a conexão dentro do Z-PRO.

Vídeo detalhado na nossa área de membros: https://app.greenn.club/curso/30288/modulo/217545/aula/774651

1. Conecte o Canal no Z-PRO (Para Enviar Mensagens):

   • No painel Admin do Z-PRO, 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.

2. Ative os Webhooks no Z-PRO (Para Receber Mensagens):

   • No painel Admin do Z-PRO, 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 Z-PRO 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.