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:
- Acesse developers.facebook.com.
- Vá até Meus Apps › Início rápido e verifique se o status está como Verificado.
- Caso não esteja, clique em Iniciar verificação.
- Preencha os dados da empresa, como razão social, CNPJ, endereço e site.
- Envie os documentos solicitados e aguarde a análise da Meta (pode levar até 48h).
- 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
- Acesse developers.facebook.com.
- No menu lateral, clique em Configuração da API › Configurações de pagamento.
- Clique em Adicionar forma de pagamento.
- Insira os dados do cartão de crédito internacional e confirme.
- A Meta fará uma pré-autorização do cartão para validação.
Criando o aplicativo no Facebook Developer
- Acesse Facebook for Developers.
- Faça login com sua conta do Facebook.
- Clique em Criar aplicativo.
- Escolha o tipo Empresa e avance.
- Insira:
- Nome do aplicativo.
- E-mail de contato.
- Página empresarial (portfolio).
- Clique em Criar aplicativo e confirme com sua senha.
Configurando o WhatsApp Business API
- Dentro do aplicativo criado, role até encontrar a opção WhatsApp e clique em Configurar.
- No menu lateral, selecione Configuração da API.
- Clique em Adicionar telefone.
- Preencha os campos:
- Nome de exibição do WhatsApp Business (nome visível aos clientes).
- Categoria da empresa.
- Descrição (opcional).
- Insira o número de telefone (DDI + DDD + número).
- 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
- No BlocoPro, acesse Configurações › Meus Canais.
- Clique em Adicionar canal (+).
- Selecione o tipo API Oficial.
- Após criar, clique em Editar credenciais da API Oficial.
Gerando e configurando o token
- Acesse business.facebook.com/settings/system-users.
- Escolha um usuário do sistema e clique em Gerar token.
- Associe o aplicativo criado e selecione Controle total.
- Configure:
- Validade: Nunca expira.
- Permissões:
whatsapp_business_managementwhatsapp_business_messaging
- 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
- Na Meta, vá até o painel do app e acesse Webhook.
- Adicione a URL de retorno e o Verify Token configurados no BlocoPro.
- Marque os eventos relevantes (por exemplo:
messages). - Clique em Verificar e salvar.
- 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.