Envie leads do Facebook e Instagram para uma caixa de entrada do WhatsApp

Conecte uma Página do Facebook que roda Lead Ads a uma caixa de entrada do WhatsApp no Deskwoot. Cada preenchimento de formulário no Facebook ou Instagram chega como uma conversa nova no seu painel, com os dados completos do formulário de lead anexados, e uma Mensagem de Modelo do WhatsApp pré-aprovada é enviada no momento em que a Meta entrega o webhook, então a janela de resposta de 24 horas do cliente abre imediatamente.

O que você precisa antes de conectar

• Uma Página do Facebook que é dona dos Lead Ads.
• Um App da Meta com o webhook de Lead Ads assinado no nível do App.
• Um Token de Acesso da Página com estas permissões: pages_show_list, pages_read_engagement, pages_manage_metadata, leads_retrieval. Obtenha um de longa duração (60 dias) para não ter que renovar toda semana.
• O App Secret da Meta (Configurações, Básico, App Secret no seu App da Meta).
• Uma caixa de entrada da WhatsApp Cloud API já configurada no Deskwoot.
• Pelo menos um Modelo de Mensagem do WhatsApp aprovado no Meta Business Manager. Os modelos podem ter variáveis (os marcadores {{1}}, {{2}}, ...), e a nossa interface de configuração permite mapear essas variáveis para o primeiro nome do lead, o nome da sua conta, um texto fixo ou qualquer campo do formulário de lead.

Conecte a Página

1. Vá em Configurações, Integrações, Meta Lead Ads no Deskwoot.
2. Cole o ID da Página, o Token de Acesso da Página de longa duração e o App Secret.
3. Escolha a caixa de entrada da WhatsApp Cloud API onde as conversas devem chegar.
4. Digite o nome e o código de idioma do seu modelo de boas-vindas aprovado (ex.: lead_welcome + en_US).
5. Clique em Conectar Página.

Verificamos o seu Token de Acesso da Página contra a Graph API para confirmar que a Página existe, e então chamamos POST /<page_id>/subscribed_apps?subscribed_fields=leadgen do lado da Meta para que a Página de fato comece a entregar webhooks de leadgen. Sem essa adesão por Página, a assinatura no nível do App sozinha não entrega nada. Fazemos isso por você.

Configure o webhook no seu App da Meta

Depois de conectar, clique em Configurar no cartão da Página conectada. Dois valores aparecem:

• URL de callback como https://deskwoot.com/api/webhooks/meta-leadgen/<your-slug>
• Token de verificação, uma string aleatória por Página

Cole os dois no seu Painel do App da Meta, Webhooks, Página, Editar Assinatura. Cada Página conectada recebe o seu próprio slug e token de verificação, então um vazamento em uma Página nunca autoriza um webhook contra outra Página.

Descubra os campos do formulário de lead

Clique em Descobrir campos no painel de configuração. Chamamos o Graph /<page_id>/leadgen_forms?fields=questions e puxamos toda chave de pergunta de todo formulário ativo nesta Página. Essas chaves se tornam as opções de menu nos seletores de Mapeamento de Campos e Variáveis de Modelo abaixo.

Mapeamento de campos

Diga para nós qual pergunta do formulário de lead da Meta mapeia para qual campo de contato do Deskwoot. Os padrões são sensatos:

• email, EMAIL ou como quer que o seu formulário chame, mapeia para E-mail. O e-mail conduz a identidade do contato (primeiro buscamos ou criamos pelo e-mail, recorrendo ao telefone).
• full_name mapeia para Nome completo
• phone_number mapeia para Telefone, normalizado para apenas dígitos antes de ser armazenado como o ID do WhatsApp.

Você pode adicionar mapeamentos personalizados para Empresa ou Cargo se o seu formulário tiver essas perguntas.

Variáveis de modelo

Os modelos do WhatsApp usam os marcadores {{1}}, {{2}}, ... no corpo. O seletor de variáveis permite preencher cada um com:

• Primeiro nome do lead, derivado do mapeamento de full_name
• Nome da conta, o nome de exibição da sua conta Deskwoot
• Texto fixo, uma string literal
• Campo do formulário de lead, qualquer chave de campo que descobrimos acima

Adicione quantas linhas de variável o seu modelo espera, em ordem. Zero linhas é válido para modelos sem variáveis.

O que acontece quando um lead preenche o formulário

1. A Meta entrega um webhook de leadgen para a sua URL com escopo de slug com o HMAC x-hub-signature-256.
2. Verificamos a assinatura contra o seu App Secret e ignoramos o lead em silêncio se ela não bater.
3. Reivindicamos o lead em uma linha MetaLeadAdLead com UNIQUE(accountId, leadgenId). Entregas duplicadas de webhook (a Meta tenta de novo até 7 vezes ao longo de 5 dias) perdem a corrida aqui, nunca produzindo uma conversa duplicada.
4. Buscamos o lead completo pelo Graph GET /<leadgen_id>.
5. Buscamos ou criamos o contato, mapeando os campos do formulário conforme a sua configuração.
6. Abrimos uma conversa nova na sua caixa de entrada do WhatsApp com os dados completos do formulário em customAttributes.metaLeadAd.
7. Enviamos o modelo de boas-vindas pela WhatsApp Cloud API. A mensagem chega ao telefone do lead, abre a janela de resposta de 24 horas, e o seu agente (ou o Fynn, se ele for o responsável) assume a partir dali.

Desconectar

Clique em Desconectar no cartão da Página. Chamamos o Meta DELETE /<page_id>/subscribed_apps para interromper novas entregas de webhook e então removemos a linha local. Mesmo que a Meta retorne um erro (token expirado, Página excluída), ainda removemos a linha local, então você nunca fica preso a uma configuração que não consegue remover.