Pular para o conteúdo principal

Configurar Webhooks

Agora vamos informar ao Facebook onde enviar os dados dos leads. Isso é chamado de "webhook" - é como dar ao Facebook o endereço de correspondência do seu CRM.

O Que É um Webhook?​

Em termos simples:

Alguém preenche seu Formulário de Lead no Facebook/Instagram
         ↓
O Facebook diz: "Ei, recebi um novo lead!"
         ↓
O Facebook envia os dados do lead para a URL do SEU webhook
         ↓
Seu módulo recebe e cria o lead no Perfex CRM

Um webhook é apenas uma URL no seu servidor para a qual o Facebook envia dados. O módulo cria esta URL automaticamente - você só precisa informar o Facebook sobre ela.

Obtenha os Detalhes do Webhook no Perfex​

Antes de ir ao Facebook, vamos pegar os detalhes do seu módulo:

  1. Faça login no Perfex CRM
  2. Vá até Meta Leads → Settings na barra lateral
  3. Primeiro, insira seu App ID e App Secret (da Etapa 1) e clique em Save Settings
  4. Role até a seção Webhook Settings
  5. Você verá dois valores:
CampoExemploO Que É
Webhook Callback URLhttps://seucrm.com/facebookleadsintegration/webhookPara onde o Facebook envia os dados
Verify Tokena1b2c3d4e5f6g7h8i9j0Um código secreto para verificar a conexão
  1. Clique no botão Copy ao lado de cada valor
aviso

A Callback URL DEVE começar com https:// - o Facebook exige SSL! Se sua URL começa com http://, você precisa instalar um certificado SSL primeiro.

Adicionar Webhooks ao Seu App Meta​

1. Abra o Painel do Seu App Meta​

Vá até seu app em:

👉 https://developers.facebook.com/apps/

Clique no seu app para abri-lo.

2. Adicione o Produto Webhooks​

  1. Na barra lateral esquerda, procure por "Add Product" ou role para baixo no painel
  2. Encontre "Webhooks" na lista de produtos
  3. Clique em "Set Up" ou "Configure"
dica

Se você já vê "Webhooks" na barra lateral esquerda, clique diretamente nele - não é necessário adicioná-lo novamente.

3. Selecione "Page" como Tipo de Objeto​

  1. Na página de Webhooks, você verá um menu suspenso que diz "User" por padrão
  2. Mude este menu suspenso para "Page"
aviso

Isso é crítico! Você DEVE selecionar "Page" - não "User", não "Application", não qualquer outra coisa. Os dados de leads vêm através de inscrições de Page.

4. Inscreva-se no Webhook​

  1. Clique no botão "Subscribe to this object" (ou "Edit Subscription" se já configurado)
  2. Uma caixa de diálogo aparecerá pedindo dois valores:
CampoO Que Inserir
Callback URLCole sua URL do Webhook do módulo (ex.: https://seucrm.com/facebookleadsintegration/webhook)
Verify TokenCole seu Verify Token do módulo
  1. Clique em "Verify and Save"

5. O Que Acontece ao Clicar em "Verify and Save"​

O Facebook enviará imediatamente uma requisição de verificação para a URL do seu webhook:

Facebook: "Ei, esse é realmente o seu servidor?"
Seu Módulo: "Sim! Aqui está o token de verificação para provar!"
Facebook: "Ótimo, verificado!"

Se funcionar: Você verá uma mensagem de sucesso e a caixa de diálogo fecha.

Se falhar: Consulte a seção de Solução de Problemas para correções comuns.

6. Inscreva-se nos Eventos "leadgen"​

Após a verificação, você precisa informar ao Facebook quais eventos enviar:

  1. Você verá uma lista de tipos de eventos nas inscrições de "Page"
  2. Encontre "leadgen" na lista (pode ser necessário rolar)
  3. Clique no botão "Subscribe" ao lado de "leadgen"
dica

"leadgen" é o ÚNICO evento que você precisa. Não é necessário se inscrever em nenhum outro evento (como "messages" ou "feed"). Apenas "leadgen".

Verificação Bem-Sucedida!​

A configuração do seu webhook deve agora ficar assim:

Webhooks
├── Object: Page
├── Callback URL: https://seucrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Verificado
└── Subscriptions:
    └── ✅ leadgen (inscrito)

No módulo do Perfex CRM, o indicador de status do webhook deve agora mostrar verde/Verified!

Como Testar o Webhook​

Quer ter certeza de que o webhook está funcionando?

  1. Vá até seu Perfex CRM → Meta Leads → Settings
  2. Clique no botão "Test Connection"
  3. Você deve ver todos os marcadores verdes

Faremos testes mais completos posteriormente na seção Testando Leads.

Erros Comuns a Evitar​

ErroCorreção
Selecionou "User" em vez de "Page"Mude o menu suspenso para "Page"
Esqueceu de se inscrever em "leadgen"Encontre "leadgen" na lista e inscreva-se
Usando HTTP em vez de HTTPSInstale um certificado SSL no seu servidor
Erro de digitação na Callback URLCopie e cole diretamente das configurações do módulo
"Callback URL couldn't be validated"Verifique a Solução de Problemas

Webhook configurado? Conecte Suas Páginas