Whatsapp Oficial via API Cloud WABA

Como criar um app no facebook developers para usar a api oficial da Meta

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

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

Live - Criação de App no facebook developers e integração com a API Oficial, Instagram e Facebook

Tutorial passo-a-passo:

Vídeo 1: Criar número de telefone

Vídeo 2: Configurando número na Meta

Vídeo 3: Configurando WABA no Fullchat

Vídeo 4: Configurando Webhook de callback

Vídeo 5: Registrar o número e criar templates de mensagens

---

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

---

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

Ampliar

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

2. 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".

2. Adicione um Número de Telefone: Clique no botão para adicionar um novo número.

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

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

5. Adicione a forma de pagamento

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

• 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 Fullchat, 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".

3. Crie um Usuário do Sistema: Adicione um novo usuário do sistema com a função de "Admin".

4. Atribua Ativos: Com o novo usuário selecionado, clique em "Atribuir Ativos".

5. Selecione "Aplicativos", escolha o aplicativo que você criou na Etapa 2 e conceda a permissão de "Gerenciar App".

6. 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 Fullchat e Ativando Webhooks

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

Vídeo detalhado na nossa área de membros:

1. Conecte o Canal no Fullchat (Para Enviar Mensagens):

   • No painel Admin do Fullchat, 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 Fullchat (Para Receber Mensagens):

   • No painel Admin do Fullchat, 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".

Ampliar

• Clique em "Editar" na seção de Webhooks.
• Cole a URL e o Token copiados do Fullchat 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.

Possíveis erros

Solução de Problemas: Evite falhas de comunicação com o Webhook da Meta (Erro ETIMEDOUT)

Os erros AxiosError do tipo "ETIMEDOUT" registrados no log indicam que a comunicação com o servidor da Meta (Webhook) está sofrendo atraso de resposta — geralmente causado por alta latência de rede.

1. Acesse o painel da Hostinger.
2. Vá até Configurações → Rede → DNS.
3. Defina um DNS fixo recomendado, como:
   • 1.1.1.1 (Cloudflare)
   • 8.8.8.8 (Google)

Links de apoio - Meta API

Guia Verificação do app (tech provider)

Guia Configuração coexistência:

Configuração login incorporado:

Configuração instagram nativo:

Configuração facebook messenger nativo:

Guia da Meta para configuração do login incorporado:\

Central de ajuda e suporte técnico meta:

---