Skip to main content

WhatsApp - Meta

Documentação das API's Oficiais da Meta

Os canais do tipo WhatsApp Meta são integrados diretamente com a API oficial da Meta, utilizando o Login do Facebook para autenticação e escolha do número de telefone a ser utilizado.

✅ Requisitos para Integração

Para integrar o WhatsApp via API da Meta, é necessário atender aos seguintes requisitos:

  • Conta no Facebook Business Manager

    • É obrigatório possuir uma conta no Facebook Business Manager.
    • O número de telefone a ser utilizado deve estar associado a essa conta.

  • Conta de Desenvolvedor na Meta

    • A conta deve estar cadastrada no Meta for Developers.
    • É necessário criar um App na Meta para gerenciar permissões e autenticações.

  • Número de Telefone Válido

    • O número não pode estar vinculado ao WhatsApp pessoal ou WhatsApp Business App.
    • Deve ser verificado e aprovado pela Meta antes da ativação.

  • Permissões e Autenticação

    • O usuário que realizar a integração precisa ter permissões administrativas no Business Manager.
    • O processo de login e autenticação é feito via OAuth, utilizando o Login do Facebook.

  • Aprovação da Meta

    • O business precisa estar verificado pela Meta para uso da API oficial.
    • Dependendo do caso, pode ser necessário passar pelo processo de Revisão de Aplicação.

Funcionalidades​

✅ Implementadas​

  • Envio de Mensagens
    • Envie mensagens de texto, imagens, vídeos, áudios e documentos para seus clientes.
    • Utilize HSM's (Highly Structured Messages) para mensagens padronizadas (Necessita de Revisão ⚠).
  • Recebimento de Mensagens
    • Receba mensagens de clientes em tempo real, com notificações instantâneas.
    • Responda rapidamente e mantenha a comunicação ativa.
  • Gerenciamento de Conversas
    • Visualize todas as conversas em aberto, com histórico de mensagens.
  • Gerenciamento de Templates (Necessita de Revisão ⚠)
    • Crie e gerencie templates de mensagens padronizadas.
    • Utilize variáveis dinâmicas para personalizar as mensagens.

🕤 Não implementadas​

  • Componente de Menu
    • Ainda não é possível criar menus interativos para navegação através do nosso componente do builder.
  • Componente de Carrossel
    • Ainda não é possível criar carrosséis de imagens e vídeos para exibição de produtos.
  • Responder Mensagens
    • Ainda não é possível responder mensagens recebidas na tela de atendimento.

Facebook Developers​

O Facebook Developers é a plataforma oficial da Meta para desenvolvedores criarem e gerenciarem aplicativos que interagem com os serviços da empresa, como Facebook, Instagram, Messenger e WhatsApp. Através dessa plataforma, é possível obter credenciais, acessar APIs e configurar permissões para diferentes tipos de aplicações.

Criando um Aplicativo​

Para criar um aplicativo na plataforma Facebook Developers, siga os passos abaixo:

  1. Acesse Facebook for Developers.
  2. Faça login com sua conta do Facebook.
  3. Clique em Meus Apps e selecione Criar App.
  4. Escolha o tipo de aplicativo (exemplo: Negócios, Consumidor, Jogos, etc.).
  5. Preencha as informações básicas como nome do app, email de contato e caso necessário, associe a uma conta do Business Manager.
  6. Após a criação, você terá acesso ao App ID e App Secret, usados para autenticação nas APIs da Meta.

APIs Disponíveis​

A Meta oferece diversas APIs para integração com seus serviços. Algumas das principais são:

  • Graph API: API principal para acesso a dados do Facebook e Instagram.
  • Marketing API: Usada para criação e gerenciamento de anúncios.
  • WhatsApp Business API: Permite a automação e integração de mensagens do WhatsApp Business.
  • Messenger API: Facilita a comunicação via chatbots e mensagens automatizadas.
  • Instagram Graph API: Fornece acesso a métricas, publicações e interações do Instagram.

Permissões e Revisão de App​

Para acessar dados de usuários ou realizar certas operações, é necessário solicitar permissões específicas. Algumas permissões exigem revisão por parte da Meta, garantindo conformidade com as políticas da plataforma.

Exemplos de permissões:

  • email: Acessa o email do usuário.
  • pages_manage_posts: Permite gerenciar publicações de uma Página.
  • whatsapp_business_messaging: Habilita envio de mensagens via WhatsApp Business API.
  • instagram_basic: Dá acesso a dados básicos do Instagram.

A revisão de app é um processo onde a Meta verifica se o uso das permissões está de acordo com as diretrizes da plataforma. Para isso, é necessário fornecer uma demonstração e justificativa do uso dos dados.

Gerenciador de Negócios da Meta​

O Gerenciador de Negócios da Meta é uma ferramenta essencial para empresas que utilizam o WhatsApp Business de forma profissional. As principais funcionalidades relacionadas ao WhatsApp incluem:

  • Conexão com a API do WhatsApp Business: Permite integrar sistemas e automatizar comunicações com clientes.
  • Gerenciamento de Números de WhatsApp: Associar e administrar múltiplos números à conta de negócios.
  • Gerenciamento de Templates de Mensagens: Criar, editar e enviar mensagens padronizadas aprovadas pela Meta (Já é possível fazer o mesmo direto pelo Suite).
  • Configuração de Contas Verificadas: Solicitar a verificação do número comercial para exibição do selo de autenticidade.
  • Monitoramento de Estatísticas: Acompanhar métricas sobre interações, tempo de resposta e desempenho das mensagens.
  • Controle de Permissões e Acessos: Definir níveis de acesso para diferentes usuários da equipe no gerenciamento do WhatsApp Business.

Informações Adicionais​

Fluxo de Mensagens​

No NX Suite, quando um canal é cadastrado, um número é registrado em um aplicativo Meta que pertence a SNX, que a partir daí passa escutar as mensagens enviadas para esse número.

O gerenciamento dessas mensagens é feito através do nosso Meta SBC, que é responsável por gerenciar tais mensagens tanto do Whatsapp Meta quanto do Instagram e do Facebook.

HSM's e Gerenciamento de Templates​

O Disparo massivo e manual de mensagens, junto com o gerenciamento de templates são feitos pela nossa Meta API.

Rotas Utilizadas​

  • Meta SBC:
    • GET /meta-sbc/webhook: Rota utilizada para cadastrar o webhook do Meta SBC no aplicativo Meta.
    • POST /meta-sbc/webhook: Rota utilizada para receber as mensagens enviadas aos números que estão associados ao nosso aplicativo Meta.
      • Esta rota contempla além dos webhooks de mensagens de Facebook, Instagram e WhatsApp, também o webhooks de status de templates de HSM criados.
  • Meta API: Em construção 🚧

Histórias Relacionadas​

  • NXS-11672 - CRUD de Canais WhatsApp Meta
  • NXS-11869 - Integração com WhatsApp Meta
  • NXS-12066 - Gestão de Templates de Mensagens para WhatsApp Meta

Branch de Desenvolvimento​

  • NXS-12168 - Branch que possui as últimas alterações feitas pra funcionamento do Disparo de HSM.