Integração de anúncios de leads do Facebook via Zapier
Com a integração do Facebook Lead Ads via Zapier, você pode importar seus leads do Facebook para a Braze e rastrear um evento personalizado quando os leads forem capturados.
O Facebook Lead Ads é um formato de anúncio que permite que as empresas coletem informações de leads diretamente no Facebook. Esses anúncios são projetados para tornar o processo de geração de leads fácil e prático. Ao utilizar uma integração com o Zapier e a Braze, você pode automatizar a transferência de dados de leads do Facebook para a Braze, possibilitando engajamento em tempo real e ações de acompanhamento personalizadas.
Pré-requisitos
| Requisitos | Descrição |
|---|---|
| Conta Zapier | É necessário ter uma conta Zapier para aproveitar essa parceria. Essa integração exige o uso de apps premium do Zapier, então confira se o seu plano do Zapier tem acesso a apps premium. |
| Acesso ao Facebook Leads | É necessário ter acesso ao Facebook Leads para cada conta de anúncios que você planeja usar com a Braze. |
| Facebook Business Manager | Como parte desta integração, você usará o Facebook Business Manager, uma ferramenta centralizada para gerenciar os ativos do Facebook da sua marca (por exemplo, contas de anúncios, páginas e apps). |
| Conta de anúncios do Facebook | Você precisará de uma conta de anúncios do Facebook ativa vinculada ao gerenciador de negócios da sua marca. Confira se você tem a permissão “Gerenciar contas de anúncios” para cada conta de anúncios que planeja usar com a Braze e se aceitou os termos e condições da sua conta de anúncios. |
| Página do Facebook | Você precisará de uma página do Facebook ativa vinculada ao gerenciador de negócios da sua marca. Confira se você tem as permissões “Gerenciar páginas” para cada página do Facebook que planeja usar com a Braze. |
| Endpoint REST da Braze | Confira se você sabe a URL do seu endpoint REST. Seu endpoint de API corresponde à URL do dashboard da sua instância da Braze. Por exemplo, se a URL do seu dashboard for https://dashboard-03.braze.com, seu endpoint será dashboard-03. |
| Chave da API REST da Braze | Confira se você tem uma chave da API REST da Braze com permissões users.track. Ela pode ser criada no dashboard da Braze em Configurações > Chaves de API. |
Integração
Etapa 1: Criar uma campanha de anúncios de cadastro com um formulário instantâneo
No Gerenciador de Anúncios do Facebook, crie uma campanha de cadastros do Facebook e um formulário de anúncios de cadastro do Facebook.
Você pode usar um endereço de e-mail ou um número de telefone ao fazer uma solicitação ao endpoint /users/track para atualizar ou criar o perfil de usuário. Por isso, inclua um Contact field para email ou phone no seu formulário de anúncio de cadastro. Se você estiver coletando nomes ou sobrenomes, colete esses dados separadamente no formulário, em vez de usar nomes completos.
Etapa 2: Conectar sua conta do Facebook ao Zapier
Etapa 2a: Selecionar o método de conexão no Zapier
No Zapier, acesse Apps para pesquisar os apps do Facebook disponíveis. Selecione Facebook Lead Ads ou Facebook Lead Ads (for Business admins).
Para saber mais sobre esses dois métodos de conexão da sua conta do Facebook ao Zapier, consulte:

Etapa 2b: Adicionar o Zapier ao Leads Access no Facebook Business Manager
No seu Facebook Business Manager, acesse Integrations > Leads Access no menu de navegação. Selecione sua Página do Facebook e clique em CRMs. Na guia CRM, selecione Assign CRMs e adicione o Zapier.

Para ver as etapas de como atribuir o Zapier como integração de CRM, consulte a documentação do Facebook.
Etapa 3: Criar seu Zap
Etapa 3a: Criar o gatilho
Depois de conectar sua conta do Facebook, você já pode criar um Zap. Em Trigger, selecione Facebook Lead Ads ou Facebook Lead Ads (for Business Admins), de acordo com a opção escolhida na etapa 2.

Em Event, selecione New Leads > Continue.

Selecione sua conta do Facebook e clique em Continue.

Selecione a Página do Facebook e o formulário instantâneo que você criou anteriormente e clique em Continue.

Em seguida, teste esse gatilho. Depois de validar a saída do formulário, selecione Continue with selected record.
Etapa 3b: Criar uma ação
Adicione uma nova etapa e selecione Webhooks by Zapier. Depois, selecione Custom Request no campo Event e clique em Continue.

Por fim, configure sua solicitação personalizada inserindo os campos na carga útil. O snippet de código a seguir mostra um exemplo de carga útil.
{
"attributes": [
{
"email": "<insert_email_field>",
"first_name": "<insert_first_name_field>",
"last_name": "<insert_last_name_field>",
"lead_form": "<insert_form_name_field>",
"fb_campaign": "<insert_campaign_id_field>",
"fb_ad_set": "<insert_campaign_id_field>",
"fb_ad": "<insert_campaign_id_field>",
"email_subscribe": "subscribed",
"subscription_groups" : [{
"subscription_group_id": "<subscription_group_id>",
"subscription_state": "subscribed"
}
]
}
],
"events": [
{
"email": "<insert_email_field>",
"name": "<insert_custom_event_name>",
"time": "<insert_timestamp_field>",
"_update_existing_only": false
}
]
}`
Veja um exemplo de como isso fica no Zapier:

Depois de configurar seu webhook, selecione Continue and test. Se o teste for bem-sucedido, você poderá publicar seu Zap.
Etapa 4: Testar seu Zap do Facebook Lead Ads
Para testar de ponta a ponta, use a ferramenta de teste de anúncios de cadastro (Leads Ads Testing Tool) no seu console de desenvolvedor do Facebook. Para saber mais, consulte Testing and Troubleshooting.
Gerenciamento de identidade do usuário
Essa integração permite atribuir seus leads do Facebook por e-mail usando o endpoint /users/track.
- Se o e-mail corresponder a um perfil de usuário existente, a Braze atualizará o perfil com os dados de leads do Facebook.
- Se houver vários perfis de usuário com o mesmo e-mail, a Braze priorizará nas atualizações o perfil atualizado mais recentemente que tenha um ID externo.
- Se o ID externo não existir, a Braze priorizará o perfil atualizado mais recentemente que tenha o e-mail correspondente.
- Se não houver nenhum perfil com o e-mail informado, a Braze criará um novo perfil, e um novo perfil de usuário com alias será criado. Para identificar os perfis de usuário com alias recém-criados, use o endpoint
/users/identify.

Você também pode usar um número de telefone ou ID externo na solicitação para a Braze, se esses campos estiverem disponíveis e forem o identificador principal que você quer usar na integração. Para isso, modifique a carga útil da sua solicitação conforme indicado no endpoint /users/track.
Solução de problemas
Testei o Trigger e a Action com sucesso. Por que não consigo publicar meu Zap no Zapier?
Para usar essa integração, você precisa ter um plano do Zapier que ofereça suporte a apps premium.
Por que os leads do Facebook não estão sendo sincronizados com a Braze?
- Confira se você tem acesso de administrador à sua página do Facebook, à conta de anúncios e ao acesso aos leads. Depois, reconecte sua conta no Zapier.
- Verifique se o formulário instantâneo que você criou no Facebook corresponde ao formulário selecionado na sua etapa de Trigger.
- Confira se você atribuiu o Zapier ao acesso aos leads em Facebook Business Manager > Integrations > Lead Access.
Por que estou vendo perfis de usuário duplicados com o mesmo e-mail?
A Braze cria e gerencia perfis de usuário de formas específicas, com base no ciclo de vida do perfil de usuário.
Dependendo dos seus processos internos e do momento em que você dispara a criação de clientes na Braze, podem aparecer perfis de usuário duplicados. Isso acontece por causa de uma condição de corrida entre a criação do perfil pela integração e a criação do usuário pelo seu sistema. Você pode mesclar perfis de usuário na Braze.
Não tenho uma conta no Zapier. Como posso disparar webhooks do Facebook Lead Ads para a Braze?
Se você não usa e não pretende usar o Zapier, pode criar a integração diretamente do Facebook para a Braze. Para saber mais, consulte a documentação do Lead Ads.
Para recuperar leads do Facebook, use webhooks. Consulte a documentação de webhooks para começar a usar webhooks no Facebook.
Depois de definir o URL dos webhooks no Facebook, trabalhe com sua equipe para decidir a melhor maneira de encaminhar os dados para o endpoint /users/track. Assim como na abordagem com o Zapier, faça uma solicitação por e-mail pelo endpoint users/track.

Para ver mais dicas de solução de problemas, consulte o guia de solução de problemas de leads do Facebook do Zapier.