Em duas linhas: conecte um anúncio com formulário e seus formulários alimentam sozinhos sua Caixa de prospectos. Em Configurar fonte você mapeia seus campos, revisa o webhook e faz um backfill para trazer leads históricos (a janela depende da plataforma) — e o backfill nunca cria duplicados.

Um anúncio com formulário (do Facebook, Google, TikTok ou LinkedIn) é uma das fontes que alimentam sua caixa. Ao conectar uma página ou conta de anúncios, seus formulários publicados começam a enviar leads para CRM > Prospectos. Veja A Caixa de prospectos: receber, qualificar e converter em negócio para o que acontece quando um lead chega.

Conectar a fonte e escolher seus formulários

Conecte a página ou conta de anúncios e abra-a com Configurar fonte (por exemplo, Configurar fonte do Facebook).
Em Formulários, escolha de quais formulários você quer receber leads. Por padrão chegam os de todos os formulários publicados; restrinja a um subconjunto se quiser apenas alguns.

Mapear os campos do formulário

Em Mapeamento de campos, o mapeamento automático já detecta para você nome, email, telefone, site e país. Use Personalizar mapeamento para mapear perguntas adicionais do formulário: o menu oferece os campos padrão do CRM e seus campos personalizados reais (os que você definiu em CRM > Configurações > Campos personalizados), agrupados por entidade — Pessoa, Empresa, Negócio ou Prospect — com o tipo ao lado de cada um.

Quando você mapeia uma pergunta para um campo personalizado, a resposta é salva com o seu tipo na entidade à qual o campo pertence (um número como número, uma seleção cotejada com as opções do campo) e aparece nas colunas e filtros dessa entidade — em Empresa, apenas em campos que continuam vazios, assim um lead nunca sobrescreve dados que você carregou manualmente. Se uma resposta não corresponde ao tipo do campo, o campo tipado simplesmente fica vazio — a resposta bruta nunca se perde: todas as respostas ficam visíveis em Respostas do formulário do prospect. A última opção, Salvar como resposta do formulário, mantém uma pergunta apenas ali, sem campo tipado.

Se você excluir um campo personalizado em CRM > Configurações, os mapeamentos que apontavam para ele continuam aparecendo no editor marcados como excluídos e deixam de gravar um valor tipado. A resposta continua sendo salva em Respostas do formulário; aponte o mapeamento para outro campo para que volte a ser gravado com o seu tipo.

Revisar o webhook (para que os leads continuem chegando)

Estado do webhook mostra se a fonte está conectada e sua última verificação. Se parou de receber, use Re-inscrever webhook para reconectá-la. No mesmo diálogo você também pode Pausar a fonte (parar de receber leads novos sem excluí-la) ou Excluir a fonte.

Se você desconectar a integração, suas fontes são pausadas

Uma fonte de leads funciona com as credenciais da sua integração. Por isso, quando você desconecta Meta, Google Ads, TikTok Ads ou LinkedIn em Configuração > Integrações, cada fonte que dependia dessa conexão é pausada automaticamente — em vez de ficar ativa e quebrada. Nada se perde: a fonte conserva seus formulários, seu mapeamento de campos e os leads que já trouxe.

Antes de você confirmar, o diálogo de desconexão lista exatamente quais fontes ficarão pausadas — incluindo as das Contas filhas que herdam a conexão do workspace. Depois, na fonte pausada você verá o motivo: A conexão de {plataforma} foi desconectada.

Reconectar a integração não reativa as fontes sozinho. Depois que a plataforma estiver conectada novamente, abra cada fonte pausada com Configurar fonte e use Reativar para que ela volte a receber leads.

Isso funciona assim apenas quando você decide desconectar. Se foi a plataforma que cortou o acesso (por exemplo, você removeu o MB Suite nas configurações de aplicativos do Facebook), a fonte não é pausada: fica como está e volta a receber sozinha quando você reconecta.

Trazer leads históricos (backfill)

Em Leads históricos, use o botão de backfill para importar os leads passados dessa fonte para sua caixa. O botão mostra a janela exata daquela plataforma (por exemplo, Fazer backfill (90 dias) na Meta). Até onde você pode voltar é definido por cada plataforma — é tudo o que ela conserva — não pela MB Suite:

Meta (Facebook / Instagram): 90 dias. A Meta apaga o lead 90 dias após o envio do formulário.
Google: 60 dias. É o máximo que a API do Google Ads retorna (a interface do Google Ads só deixa baixar 30 — a API dobra essa janela).
LinkedIn: 365 dias. O LinkedIn apaga os dados do lead de seus servidores automaticamente após 365 dias.
TikTok: sem backfill por API. O TikTok não nos expõe os leads passados, então eles só chegam em tempo real pelo webhook. Para trazer os anteriores, exporte-os do TikTok Ads Manager e importe o CSV — veja Importe seus contatos e negócios atuais.

O backfill duplica os leads que já haviam entrado?

Não. O backfill deduplica pelo ID único que a Meta atribui a cada lead. Para cada lead ele verifica se já existe um prospecto ou negócio com esse mesmo ID antes de criar qualquer coisa. Se já existia — porque entrou pelo webhook, por um backfill anterior, ou porque você apertou o botão duas vezes — nada novo é criado: conta como atualizado, não como ingerido.

Por isso, apertar backfill duas vezes — ou fazê-lo depois que os leads já entraram sozinhos pelo webhook — é totalmente seguro. Também serve para reparar leads antigos que na época não salvaram bem sua atribuição ou suas respostas.

O que acontece com os leads que editei manualmente?

Quando o backfill encontra um lead que já existia, ele o toca sim — mas apenas em campos "de sistema". Nunca sobrescreve o nome, o email nem o telefone, então as correções manuais do seu vendedor ficam intactas. O que ele de fato reescreve é: as respostas do formulário (campos personalizados), a atribuição (campanha / conjunto de anúncios / anúncio) e as respostas brutas; além disso reenriquece a empresa e só define o país se estava vazio.

O outro lado: se você editou manualmente um campo personalizado ou a atribuição de um lead, um backfill os reverteria à versão original da Meta. O nome, o email e o telefone sempre ficam intactos — mas não faça um backfill esperando que suas respostas ou sua atribuição editadas manualmente sobrevivam.

Assim que os leads estiverem na sua caixa, veja a campanha que trouxe cada um em Conecte cada venda fechada à sua campanha (atribuição e ROAS). Se os leads não aparecem de forma alguma, revise Os leads não chegam ao CRM: causas e soluções.

Ainda tem dúvidas?

Pergunte à MIA, o assistente de IA do MB Suite: abra-o com o botão MB AI (⌘J) na barra superior. A MIA conhece a seção em que você está, então você pode consultá-la sobre o que vê na tela e também tirar dúvidas de como usar o MB Suite.

Fontes de leads: mapeamento, webhook e backfill de leads históricos (sem duplicar)