Pular para o conteúdo principal

Configuração

Após instalar e ativar o módulo WhatsApp Cloud API Chat & Marketing, você precisa configurar a conexão entre o Perfex CRM e a Meta WhatsApp Cloud API. Isso envolve configurar um Meta Application, gerar credenciais de API, configurar webhooks e ajustar as configurações do módulo.

Configuração do Meta Application​

A WhatsApp Cloud API é acessada através de um App Meta (Facebook). Se você ainda não criou um, siga estas etapas.

Etapa 1 — Criar uma Conta de Desenvolvedor Facebook​

  1. Vá até developers.facebook.com.
  2. Faça login com sua conta Facebook.
  3. Se solicitado, registre-se como desenvolvedor aceitando os termos e verificando sua conta.

Etapa 2 — Criar um App Meta​

  1. No painel de Desenvolvedores Facebook, clique em Create App.
  2. Selecione Business como tipo de app (ou Other se Business não estiver disponível para seu tipo de conta).
  3. Insira um App Name (ex.: "Perfex CRM WhatsApp") e seu e-mail de contato.
  4. Selecione sua Business Account (ou crie uma se necessário).
  5. Clique em Create App.

Etapa 3 — Adicionar WhatsApp ao Seu App​

  1. No painel do seu novo app, encontre WhatsApp na lista de produtos e clique em Set Up.
  2. Siga a configuração guiada para vincular uma WhatsApp Business Account.
  3. Um número de telefone de teste é fornecido automaticamente para desenvolvimento. Você pode adicionar seu próprio número de telefone comercial verificado posteriormente.
informação

O número de telefone de teste permite enviar mensagens para até 5 números pré-registrados. Para uso em produção, adicione e verifique seu próprio número de telefone comercial nas configurações da WhatsApp Business Account.

Etapa 4 — Gerar um Token de Acesso Permanente​

O token temporário padrão expira após 24 horas. Para produção, gere um token permanente de System User:

  1. Vá até business.facebook.com e navegue até Business Settings > System Users.
  2. Crie um novo System User (ou use um existente) com acesso de Admin.
  3. Clique em Generate New Token, selecione seu app WhatsApp e conceda as seguintes permissões:
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. Copie o token gerado — este é seu token de acesso permanente.
aviso

O token permanente é exibido apenas uma vez. Armazene-o com segurança. Se perdido, você precisará gerar um novo e atualizar as configurações do módulo.

Configuração de Webhook​

Os webhooks permitem que o WhatsApp notifique sua instância do Perfex CRM sobre mensagens recebidas, recibos de entrega e atualizações de status em tempo real.

Configurando o Webhook​

  1. No painel de Desenvolvedores Facebook, vá até a página WhatsApp > Configuration do seu app.
  2. Em Webhook, clique em Edit.
  3. Insira a Callback URL fornecida pelo módulo (encontrada em WhatsApp Module > Settings no Perfex CRM). Ela normalmente segue este formato: 
    https://seu-dominio-perfex.com/whatsapp_cloud_api/webhook
  4. Insira o Verify Token exibido nas configurações do módulo.
  5. Clique em Verify and Save.
  6. Inscreva-se nos seguintes campos de webhook:
    • messages
    • message_template_status_update
dica

Sua instalação do Perfex CRM deve ser servida via HTTPS com um certificado SSL válido. A Meta rejeitará URLs de webhook que usem HTTP ou tenham certificados inválidos/autoassinados.

Configurações do Módulo​

Após completar a configuração do App Meta, configure o módulo dentro do Perfex CRM.

  1. Navegue até o módulo WhatsApp Cloud API na barra lateral do Perfex CRM.
  2. Vá até Settings e insira o seguinte:
ConfiguraçãoDescrição
Access TokenO token permanente de System User gerado acima
Phone Number IDEncontrado na página WhatsApp > Getting Started do seu App Meta
WhatsApp Business Account IDEncontrado nas configurações WhatsApp do seu App Meta
Webhook Verify TokenUma string personalizada que você define — deve corresponder ao que inseriu na configuração do webhook Meta
App IDO ID do seu App Meta (encontrado no painel do app)
  1. Clique em Save Settings.
  2. Use o botão Test Connection para verificar se o módulo consegue se comunicar com a WhatsApp Cloud API.

Configuração de Embed​

Para configurações avançadas, o módulo suporta incorporar o widget de chat WhatsApp em páginas externas ou portais de clientes. Navegue até WhatsApp Module > Settings > Embed para gerar um snippet de código de incorporação e personalizar a aparência do widget (cores, posição, mensagem de boas-vindas).

Verificação Comercial​

Para desbloquear capacidade total de mensagens e acesso a todas as categorias de templates, complete a verificação comercial da Meta:

  1. Vá até business.facebook.com > Business Settings > Security Center.
  2. Clique em Start Verification e siga o processo guiado.
  3. Envie seus documentos comerciais conforme solicitado pela Meta.
  4. A verificação normalmente leva de 2 a 5 dias úteis.
informação

Sem verificação comercial, suas mensagens são limitadas a 250 destinatários únicos por janela de 24 horas. Após a verificação, os limites aumentam progressivamente com base na qualidade e volume das mensagens.

Próximos Passos​

  • Guia de Uso — aprenda como usar a interface de chat, executar campanhas, configurar bots e gerenciar templates
  • Logs do WhatsApp — visualize registros abrangentes de todas as interações automatizadas