Como integrar o portal Meta (Facebook) na Veploy

Envie seu catálogo de imóveis para a Meta via XML e receba os leads das campanhas de Lead Ads direto no CRM da Veploy, já vinculados ao imóvel correto.

A integração com a Meta tem duas funções principais:

Enviar o seu catálogo de imóveis para a Meta via XML, permitindo criar campanhas dinâmicas e vitrines interativas no Catálogo da Meta.
Receber os leads das campanhas de Lead Ads direto no CRM da Veploy, já vinculados ao imóvel correto.

As duas integrações são independentes e complementares — você pode configurar uma, a outra, ou as duas. Neste tutorial você vai aprender o passo a passo completo de ambas.

⚠️ Pré-requisitos: Para concluir a integração, você precisa ser administrador da Página do Facebook e do Meta Business Suite da sua imobiliária e ter campanhas de Lead Ads ativas.

A integração de leads é válida para campanhas feitas com formulários da Meta.

No painel da Veploy, vá até o menu lateral esquerdo e, na seção Divulgação, clique em "Portais".

Na lista de portais, localize Meta (Facebook) e clique em "Ativar".

Passo 2 – Configure o portal

Ao abrir o modal de configurações, ajuste as opções desejadas:

Status do portal: mantenha como Ativo para que a integração funcione.
Como o endereço será exibido? escolha entre:
- Rua e número (completo)
- Rua com número fictício
- Apenas a rua
- Apenas o bairro
Inserir vídeo quando não houver: ative essa opção caso queira usar um vídeo padrão nos imóveis que não tiverem vídeo cadastrado.

Plano contratado: ative o plano padrão e defina a quantidade limite de imóveis como ilimitada, para que todos os imóveis do seu portfólio sejam enviados para a Meta.

Após realizar os ajustes, clique em "Salvar alterações".

No topo da tela do portal, clique no botão "Integração". A bolinha ao lado do nome fica verde quando está tudo certo e âmbar quando falta algo, como conectar a Página do Facebook.

Será aberta a janela "Integração com Meta (Facebook)", dividida em duas seções:

Catálogo de imóveis (XML) – usado para enviar o catálogo de imóveis para a Meta.
Recebimento de leads – usado para conectar a Página do Facebook e receber os leads das campanhas de Lead Ads.

A partir daqui, siga a Parte A, a Parte B, ou ambas, conforme a sua necessidade.

Parte A – Enviar o catálogo de imóveis para a Meta (via XML)

Essa integração permite que o seu estoque de imóveis seja exibido no Catálogo da Meta, viabilizando anúncios dinâmicos no Facebook e Instagram.

Passo A1 – Copie o link do XML

Na seção Catálogo de imóveis (XML) do modal, clique em "Copiar" ao lado do link. Esse é o endereço onde a Meta buscará automaticamente o seu catálogo de imóveis. Logo abaixo, o modal mostra quando o XML foi atualizado pela última vez.

Passo A2 – Configure o catálogo no Gerenciador de Comércio da Meta

Com o link copiado, vá até o painel da Meta para cadastrar o catálogo:

Acesse o Gerenciador de Comércio da Meta e clique em "Criar um catálogo".
Selecione a categoria Imóveis (ou Home Listings) e avance.
No menu lateral, vá em Itens → Adicionar Itens → Feed de dados.
Escolha a opção Feed programado e cole a URL do XML que você copiou da Veploy.
Defina a frequência de atualização (diária ou a cada hora), para que o seu estoque de imóveis fique sempre sincronizado.

💡 Dica: Recomendamos a atualização a cada hora para imobiliárias com alto volume de movimentação de imóveis (vendas, pausas, novos cadastros).

Pronto! Após a primeira sincronização, seus imóveis estarão disponíveis no catálogo da Meta e poderão ser usados em campanhas dinâmicas no Facebook e Instagram.

Parte B – Receber leads das campanhas de Lead Ads

Essa integração conecta a sua Página do Facebook à Veploy, fazendo com que os leads das campanhas de Lead Ads cheguem automaticamente ao seu CRM.

Passo B1 – Inicie a conexão com a Meta

Ainda no modal "Integração com Meta (Facebook)", na seção Recebimento de leads, você tem dois caminhos possíveis:

Fluxo padrão: clique no botão "Conectar Página do Facebook". Use este caminho se a sua Página do Facebook já está em um Portfólio Empresarial.
Fluxo alternativo: clique no link "Minha Página não está num portfólio empresarial", logo abaixo do botão. Use este caminho se a sua Página ainda não faz parte de um Portfólio Empresarial.

⚠️ Importante: No momento, o fluxo padrão está temporariamente indisponível. Recomendamos seguir pelo fluxo alternativo por enquanto — ele funciona normalmente para qualquer página do Facebook, mesmo as que estão em um portfólio empresarial.

Fluxo padrão – Página em um Portfólio Empresarial

🚧 Disponível em breve. Por enquanto, siga o fluxo alternativo descrito abaixo.

Fluxo alternativo – Página fora de um Portfólio Empresarial

Use este fluxo se a sua Página do Facebook não faz parte de um Portfólio Empresarial. O caminho de autorização é um pouco diferente, pois a Meta exige que você libere o acesso à página de forma individual.

Passo Alt-1 – Acesse o fluxo alternativo

No modal "Integração com Meta (Facebook)", clique no link "Minha Página não está num portfólio empresarial", logo abaixo do botão "Conectar Página do Facebook".

Passo Alt-2 – Edite as configurações de conexão

Uma janela do Facebook será aberta. Caso você já tenha conectado a Veploy CRM anteriormente, a Meta exibirá uma tela de reconexão.

Clique em "Editar configurações" para ajustar quais páginas serão compartilhadas.

Passo Alt-3 – Selecione a página a ser compartilhada

Na próxima tela, você verá a lista de páginas que pode compartilhar com a Veploy CRM:

Selecione a opção "Aceitar apenas os(as) Páginas atuais" — isso evita que páginas criadas no futuro sejam compartilhadas automaticamente.
Marque o checkbox da página da sua imobiliária na lista de ativos.
Clique em "Continuar".

Passo Alt-4 – Revise e salve as permissões

A Meta exibirá um resumo das permissões que a Veploy CRM terá sobre a sua Página, como:

Acessar leads para suas Páginas
Ler o conteúdo postado na Página
Gerenciar contas, configurações e webhooks
Mostrar uma lista das Páginas que você gerencia

Confira a lista e clique em "Salvar".

Passo Alt-5 – Confirme a conexão

A Meta exibirá uma tela confirmando que o usuário foi conectado(a) à Veploy CRM. Clique em "Entendi" para finalizar e voltar ao painel da Veploy.

Continuação (para ambos os fluxos)

Após concluir o fluxo padrão ou o alternativo, os próximos passos são os mesmos.

Passo B3 – Libere o acesso aos leads no painel da Meta

Além da conexão que você acabou de fazer, a Meta exige uma autorização manual dentro do próprio painel dela para que os dados dos leads cheguem até a Veploy.

Clique no botão "Abrir painel da Meta" e, na nova janela, siga os três passos abaixo:

Selecione a página correta na coluna da esquerda.
Selecione a aba "CRMs" na seção de permissões.
Clique em "Assign CRM", atribua o Veploy CRM e salve.

💡 Se a integração não funcionar mesmo após esse passo, entre em contato com o suporte da Veploy.

Passo B4 – Mapeie os formulários

Após a liberação, o modal de integração mostra a sua Página com o status "Recebendo leads", indicando que a conexão com a Meta está ativa.

Com a Página conectada, aparece no topo da tela do portal, ao lado de "Integração", o botão "Formulários". A bolinha dele fica âmbar enquanto houver formulário ativo sem mapeamento e verde quando todos estão mapeados. Clique nele para dizer como os leads de cada formulário de Lead Ads entram na Veploy.

No modal "Mapear formulários":

À esquerda está a lista dos formulários de Lead Ads da sua Página. Ao lado de cada nome, uma bolinha mostra a situação: verde para mapeado (com o resumo, por exemplo Venda · AP0123), âmbar para A mapear e azul para alterado e ainda não salvo. A situação na Meta e o total de leads aparecem no topo do formulário selecionado. Use a busca ou as abas Todos, Mapeados e A mapear para achar o formulário e clique nele.
À direita, em três blocos, você diz como os leads daquele formulário entram na Veploy:
- Dados de contato: de qual pergunta do formulário vêm o Nome, o E-mail e o Telefone do lead. Já vêm preenchidos com as perguntas padrão da Meta (nome completo, e-mail, telefone). Se o seu formulário pede o WhatsApp em uma pergunta própria, escolha essa pergunta em Telefone. O nome é obrigatório, e o formulário precisa de pelo menos um contato: e-mail ou telefone. Sem pergunta de telefone, o lead entra sem telefone, e o painel avisa.
- Tipo da negociação: escolha Venda, Locação, Captação ou Indefinido para todos os leads do formulário. Se o formulário tem uma pergunta de múltipla escolha que separa os leads (por exemplo, "Você quer comprar ou alugar?"), escolha "Depende da resposta do lead", depois a pergunta que decide, e diga o tipo de quem dá cada resposta. Essa opção só aparece quando o formulário tem pergunta de múltipla escolha. Resposta sem tipo entra como indefinido.
- Imóvel: escolha Nenhum imóvel, Sempre o mesmo imóvel (digite o código ou parte do título e escolha na lista), "Depende da resposta do lead", com um imóvel para cada resposta da pergunta que decide (resposta sem imóvel fica sem vínculo), ou "Automático (enviado pela Meta)", para anúncio de catálogo (carrossel): o lead entra com o imóvel em que a pessoa clicou. Com o catálogo enviado pela Veploy (Parte A), esse imóvel também define se o lead é de venda ou de locação. Se o imóvel escolhido está anunciado só para venda ou só para locação, o tipo da negociação fica definido por ele. Captação nunca tem imóvel.
No fim do painel aparecem as perguntas que vão para a observação do lead: todas as que não viraram campo.
Repita para os outros formulários e clique em "Salvar". Só o que mudou é gravado, e o mapeamento vale para os próximos leads (os que já chegaram não mudam).

💡 A comparação da resposta não diferencia maiúsculas nem acentos. Nome, e-mail e telefone escolhidos aqui valem mesmo que a Meta mude o nome da pergunta padrão.

💡 Se a lista de formulários não carregar, reconecte com a Meta em "Integração" ou digite o ID do formulário no campo abaixo da lista e clique em "Adicionar".

💡 Formulários de "trabalhe conosco", "fale conosco" e afins não precisam ser mapeados: sem mapeamento, o lead entra no CRM como contato, que já é o que você quer.

💡 Por que mapear formulários? Ao vincular um formulário a um imóvel, todos os leads que chegarem por aquele formulário serão atribuídos automaticamente ao imóvel correspondente, facilitando o atendimento e o acompanhamento no funil. E o tipo da negociação faz o lead já nascer classificado como venda, locação ou captação: é o mesmo campo que você usa para filtrar a lista de leads e para montar as regras de distribuição, então o lead já cai na regra certa assim que chega.

Pronto! A integração está concluída

Com tudo configurado:

O catálogo de imóveis da sua imobiliária estará sendo sincronizado com a Meta via XML, pronto para uso em anúncios dinâmicos no Facebook e Instagram.
Os leads das campanhas de Lead Ads chegarão direto no CRM da Veploy, já vinculados aos respectivos imóveis (quando mapeados).

Precisa ajustar a conexão depois?

No topo da tela do portal:

Formulários – para atualizar ou mapear formulários novos. Fique de olho na bolinha âmbar: ela avisa quando surge formulário sem mapeamento.
Integração – no modal, "Trocar Página" conecta outra Página ou renova a conexão, caso ela expire, e "Desconectar" encerra a integração com a Meta. Quando aparece, o link "Não está recebendo?" abre de novo a liberação de acesso no painel da Meta.

Em caso de dúvidas, entre em contato com o suporte da Veploy.