Guia de Integração: API Oficial da Meta no OmniEdu

Modificado em Qui, 19 Nov na (o) 4:28 PM

Este guia orienta, passo a passo, como realizar a integração de um número de telefone com a API Oficial da Meta dentro da plataforma OmniEdu.

 

 

ATENÇÃO - REGRA CRÍTICA DA META:


O número que você utilizar para a integração com a API Oficial NÃO DEVE possuir nenhuma conta ativa no WhatsApp (seja Business ou pessoal). Caso o número já esteja sendo usado no aplicativo de celular, você deve deletar a conta antes de iniciar o processo.


Parte 1: Cadastro Inicial no OmniEdu


O processo começa com a preparação do número dentro do ambiente do OmniEdu.


  1. Acesse o painel do OmniEdu e navegue até a seção Números.
  2. Clique no botão + Adicionar número no canto superior direito.
  3. Preencha os campos solicitados:
    Número de telefone: Insira o número de telefone.
    Rótulo: Insira um nome para identificar o telefone adicionado.
    Tipo de integração: Selecione a opção Meta oficial.
  4. Clique em Criar número.

 

Parte 2: Configurações no Meta Business Suite


Com o número criado no OmniEdu, o próximo passo é realizar as configurações necessárias no painel da Meta.

  1. Acesse a página do Facebook que a sua instituição utiliza.
  2. Acesse o Meta Business Suite e, no menu lateral esquerdo, clique em Configurações (ícone de engrenagem).


Passo 2.1: Criação da Conta de Mensagens e Conta do WhatsApp


  1. No menu lateral das Configurações do Negócio, vá em Contas e selecione Contas de Mensagens.
  2. Clique no botão + Adicionar no canto superior direito.
  3. Escolha a opção Crie uma nova conta do WhatsApp e insira o número de telefone que você cadastrou previamente no OmniEdu.

 

 

Passo 2.2: Criação do Aplicativo (App) na Meta

  1. No mesmo menu lateral esquerdo, navegue até Contas e clique em Apps.
  2. Clique no botão + Adicionar e selecione Criar um novo ID do app.
  3. Na etapa de Casos de uso, preste muita atenção: filtre por Business Messaging e selecione obrigatoriamente a opção Conectar-se com clientes pelo WhatsApp.
  4. Siga as instruções da tela e avance para concluir a criação.

 

Passo 2.3: Configuração do Webhook e Liberações no App

  1. Na listagem de Apps, localize o aplicativo que acabou de criar, clique no ícone de três pontos (...) e selecione Abrir no Painel de Apps. 
  2.  Dentro do Painel do App, acesse o menu Casos de uso no menu esquerdo e clique no botão Personalizar localizado no card do WhatsApp.
  3. No menu lateral esquerdo que se abrir, clique em Configuração de produção e depois em Configurar Webhook. Neste momento, você precisará preencher a URL de callback e o Verificar token.
  4. Onde encontrar esses dados? Deixe a aba da Meta aberta, vá até o painel do OmniEdu, clique em Conectar Meta ao lado do seu número e acesse a aba Integração Meta. Copie os campos da seção Webhook.

 

 

Retorne ao painel da Meta, cole as informações nos respectivos campos e clique em Verificar e salvar.

 

 

 

Ainda na mesma página, role a tela para baixo até a listagem de campos do Webhook, localize o campo messages e certifique-se de fazer a liberação clicando para que ele fique com o status de Assinado.

 

 

Passo 2.4: Criação do Usuário de Sistema e Atribuição de Ativos


Para garantir que a integração funcione por tempo indeterminado, é necessário gerar um token que nunca expira por meio de um Usuário de Sistema.

  1. Retorne às Configurações do Negócio da Meta (no painel principal do Business Suite).
  2. No menu esquerdo, em Usuários, clique em Usuários de sistema.
  3. Clique em + Adicionar, defina um nome para o usuário e mude a função do usuário de sistema para Admin.
  4. Após criar o usuário, selecione-o na lista e clique no botão Atribuir ativos.

 

 

Você deve atribuir dois ativos específicos a este usuário:


Apps: Selecione o aplicativo criado anteriormente, marque a opção Gerenciar app (Acesso total) e salve.

 

 

 

Contas de Mensagens: Selecione as contas de WhatsApp e de mensagens criadas, marque a opção de Acesso total (Gerenciar conta) e salve. 

 


 

Parte 3: Vinculação Final no OmniEdu


Com todas as permissões concedidas no gerenciador da Meta, agora vamos consolidar as informações dentro do OmniEdu.


3.1 Copiar o WABA ID (ID da Conta do WhatsApp)


Nas Configurações do Negócio da Meta, vá em Contas de Mensagens, selecione a sua conta e copie o número de identificação exibido logo abaixo do nome (WABA ID). Cole essa informação no campo correspondente dentro do OmniEdu e clique em “validar WABA” para verificar se o código está correto


3.2 Gerar e Copiar o Token de Acesso



  1. Volte na aba Usuários de sistema, selecione o usuário administrador que você criou e clique no botão Gerar token.
  2. No modal que abrir, selecione o seu aplicativo e, no campo de expiração do token, mude obrigatoriamente para a opção Nunca.
  3. Na seção de permissões, selecione todas as opções disponíveis que iniciem com whatsapp_business_ (ex: whatsapp_business_management, whatsapp_business_messaging, etc.) e clique em Gerar token.

 

 

MUITO IMPORTANTE: Após finalizar, o token aparecerá na sua tela na sequência, é muito importante você copiá-lo ANTES DE FECHAR, ele só aparece esta única vez e não poderá ser visualizado novamente após fechar a janela.

 

 

 

Cole este token no campo Access Token dentro da página de configuração do número no OmniEdu.

 

 


3.3 Sincronização do Número


Logo abaixo dos campos preenchidos no OmniEdu, clique no botão azul Buscar na Meta.
Se as credenciais estiverem corretas, o sistema trará os números disponíveis. No campo de seleção "Escolha o número da conta WhatsApp Business", selecione o seu número.


Assim que o campo Phone Number ID for preenchido de forma automática pelo sistema, a integração estará concluída com sucesso!

 

 

 

 

 

Parte 4: Validação e Testes de Funcionamento


Após finalizar o preenchimento, realize os seguintes testes práticos para certificar a estabilidade da ferramenta:


Teste de Recebimento: Pegue um celular pessoal e envie uma mensagem de texto para o número que acabou de ser integrado. Abra a plataforma OmniEdu e verifique se a mensagem chegou corretamente no painel de conversas.


Teste de Envio: Responda à mensagem diretamente por dentro do OmniEdu e valide se o celular pessoal recebeu o texto enviado.

 

Resolução de Problemas


Se o número não estiver enviando ou recebendo mensagens, verifique duas causas muito comuns:
Conta de WhatsApp ativa no chip: Verifique novamente se o número adicionado não possui aplicativos de WhatsApp ativos em aparelhos físicos.


Falta de Verificação da Organização: A Meta exige que a empresa passe pelo processo de verificação de segurança para liberar o uso contínuo da API de mensagens. Certifique-se de acessar 

Configurações do Negócio > Informações da empresa / Centro de segurança e iniciar a verificação da organização.


Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo