Skip to main content
Sumário
< Todos os artigos
Imprimir

Associação do número via QR CodeComo conectar o BlocoPro à API Oficial do WhatsApp (Meta)


Introdução

A integração do BlocoPro com a API Oficial da Meta (WhatsApp Business Platform) permite que sua empresa realize atendimentos automatizados e profissionais com total segurança e rastreabilidade.

Antes de iniciar a configuração, é essencial possuir uma conta no Facebook e acesso administrativo à página da sua empresa.
Caso ainda não possua, será necessário criar ambos para seguir o processo.


Pré-requisitos

Antes de configurar a API Oficial, verifique se todos os pré-requisitos abaixo foram concluídos:

  • Cartão de crédito internacional para pagamentos à Meta.
  • Permissão de administrador na página empresarial do Facebook.
  • Perfil empresarial verificado no Meta Business Manager.
  • Número de telefone sem conta WhatsApp ativa.
    • Se o número estiver vinculado, é necessário excluir a conta antes da integração.
  • Logotipo da empresa (1024×1024 px, formato PNG e sem fundo).
  • Página com políticas de privacidade publicada no site da empresa.

⚠️ Todos esses itens são obrigatórios para que a Meta aprove a conexão da sua conta com o WhatsApp Business API.


Verificação do perfil empresarial

Para verificar sua empresa no Meta Business Manager, siga o passo a passo:

  1. Acesse developers.facebook.com.
  2. Vá até Meus Apps › Início rápido e verifique se o status está como Verificado.
  3. Caso não esteja, clique em Iniciar verificação.
  4. Preencha os dados da empresa, como razão social, CNPJ, endereço e site.
  5. Envie os documentos solicitados e aguarde a análise da Meta (pode levar até 48h).
  6. Após a aprovação, o status aparecerá como Empresa verificada.

💡 Somente após essa confirmação é possível prosseguir com a criação do canal.


Cadastro da forma de pagamento

  1. Acesse developers.facebook.com.
  2. No menu lateral, clique em Configuração da API › Configurações de pagamento.
  3. Clique em Adicionar forma de pagamento.
  4. Insira os dados do cartão de crédito internacional e confirme.
  5. A Meta fará uma pré-autorização do cartão para validação.

Criando o aplicativo no Facebook Developer

  1. Acesse Facebook for Developers.
  2. Faça login com sua conta do Facebook.
  3. Clique em Criar aplicativo.
  4. Escolha o tipo Empresa e avance.
  5. Insira:
    • Nome do aplicativo.
    • E-mail de contato.
    • Página empresarial (portfolio).
  6. Clique em Criar aplicativo e confirme com sua senha.

Configurando o WhatsApp Business API

  1. Dentro do aplicativo criado, role até encontrar a opção WhatsApp e clique em Configurar.
  2. No menu lateral, selecione Configuração da API.
  3. Clique em Adicionar telefone.
  4. Preencha os campos:
    • Nome de exibição do WhatsApp Business (nome visível aos clientes).
    • Categoria da empresa.
    • Descrição (opcional).
  5. Insira o número de telefone (DDI + DDD + número).
  6. Confirme via SMS ou ligação.

⚠️ O número não pode ter conta ativa no WhatsApp — caso tenha, exclua antes de prosseguir.


Criando o canal no BlocoPro

  1. No BlocoPro, acesse Configurações › Meus Canais.
  2. Clique em Adicionar canal (+).
  3. Selecione o tipo API Oficial.
  4. Após criar, clique em Editar credenciais da API Oficial.

Gerando e configurando o token

  1. Acesse business.facebook.com/settings/system-users.
  2. Escolha um usuário do sistema e clique em Gerar token.
  3. Associe o aplicativo criado e selecione Controle total.
  4. Configure:
    • Validade: Nunca expira.
    • Permissões:
      • whatsapp_business_management
      • whatsapp_business_messaging
  5. Clique em Gerar token e copie imediatamente (não será possível visualizá-lo novamente).

🚨 Certifique-se de copiar apenas o token, sem incluir a URL acidentalmente.


Inserindo credenciais no BlocoPro

Na tela de Edição de credenciais no BlocoPro, preencha:

  • Token permanente (gerado na Meta).
  • Phone Number ID (identificação do número).
  • WhatsApp Business Account ID (WABA).
  • App ID (ID do aplicativo Meta).
  • URL de retorno (Callback URL).
  • Verificar Token (Verify Token).

Clique em Salvar.


Configurações finais

  1. Na Meta, vá até o painel do app e acesse Webhook.
  2. Adicione a URL de retorno e o Verify Token configurados no BlocoPro.
  3. Marque os eventos relevantes (por exemplo: messages).
  4. Clique em Verificar e salvar.
  5. No BlocoPro, vincule o canal ao fluxo de atendimento e aos departamentos desejados.

✅ Pronto! Seu canal está conectado à API Oficial da Meta e pronto para uso.


Recursos disponíveis após a conexão

  • Envio e recebimento de mensagens via WhatsApp Business API.
  • Integração com fluxos de atendimento automáticos.
  • Métricas e relatórios centralizados no BlocoPro.
  • Suporte a templates e mensagens personalizadas.