Integração com a Meta
Como o Impullso Connector se conecta ao Facebook e ao Instagram, quais permissões solicita, por que precisa de cada uma e o que faz com os dados.
Versão 1.0 · Última atualização em 31/07/2026
1. O que a integração faz
A integração atende às imobiliárias que investem em anúncios no Facebook e no Instagram e hoje perdem o vínculo entre a verba investida e a venda fechada.
- Quando um interessado preenche um formulário de cadastro (Lead Ad) em um anúncio da imobiliária, o Connector é notificado por webhook e insere esse cadastro no funil em segundos.
- O contato entra no CRM já com a campanha, o conjunto de anúncios e o criativo que o originou, para que a imobiliária consiga apurar custo por contato e retorno por campanha.
- Um corretor responsável é atribuído no momento da entrada, segundo a regra de distribuição que a própria imobiliária configurou.
A velocidade é o ponto central. Um cadastro que chega em segundos ao corretor certo é atendido; um que chega no dia seguinte, por exportação manual de planilha, normalmente já comprou em outro lugar.
2. Fluxo de conexão
- O responsável pela imobiliária acessa Configurações › Integrações na instância de sistema dela.
- Escolhe conectar a Meta e é levado à tela de autorização oficial da plataforma.
- Autentica-se diretamente na Meta. A Impullso nunca vê a senha.
- Seleciona explicitamente qual Página e qual conta de anúncios deseja conceder.
- A Meta devolve as credenciais ao Connector, válidas apenas para os ativos selecionados.
- O Connector assina o webhook de novos cadastros daquela Página.
Outras Páginas, contas de anúncio ou ativos da mesma conta de usuário permanecem inacessíveis ao Connector.
3. Permissões e justificativa
Solicitamos o conjunto mínimo necessário. Cada permissão corresponde a uma etapa concreta — sem ela, aquela etapa deixa de existir.
| Permissão | Para que é usada | O que acontece sem ela |
|---|---|---|
pages_show_list | Exibir ao responsável a lista de Páginas que ele administra, para que escolha qual conectar. | Não há como selecionar a Página; a conexão não pode ser iniciada. |
pages_read_engagement | Ler nome e identificação da Página selecionada, para exibir no sistema qual está conectada. | O sistema mostraria apenas identificadores numéricos. |
pages_manage_metadata | Assinar o webhook de novos cadastros da Página e cancelar a assinatura na desconexão. | Não haveria notificação de cadastro novo; a captura em tempo real deixa de funcionar. |
leads_retrieval | Obter os dados do formulário preenchido pelo interessado e inseri-los no funil. | O aplicativo perde a sua função principal. |
ads_read | Ler, somente em leitura, nomes de campanha, conjunto e anúncio, para registrar a origem do contato. | O contato entra sem origem e a imobiliária volta a não saber o que gerou a venda. |
business_management | Identificar os ativos do Gerenciador de Negócios durante a seleção na conexão. | Contas organizadas em Business Manager não concluem a conexão. |
O Connector não solicita permissões de publicação de conteúdo, de gestão de campanhas nem de envio de mensagens, porque não executa nenhuma dessas ações.
4. Dados tratados
| Dado | Finalidade | Retenção |
|---|---|---|
| Nome, telefone, e-mail e demais campos do formulário do anúncio | Permitir que o corretor responda a quem pediu contato | Definida pela imobiliária, que é a controladora |
| Campanha, conjunto de anúncios e anúncio | Registrar a origem do contato | Mesma do contato |
| Identificação da Página e da conta de anúncios | Direcionar cada cadastro à instância correta | Até a desconexão |
| Token de acesso | Autenticar as chamadas do Connector | Revogado e apagado na desconexão |
| Registro técnico de operações | Diagnóstico de falhas e auditoria | 12 meses |
Não coletamos perfil pessoal, lista de amigos, publicações, mensagens privadas, fotos ou curtidas.
5. Uso restrito
Os dados obtidos por meio das APIs da Meta são usados exclusivamente para inserir e qualificar contatos no CRM da imobiliária que autorizou a conexão. Não são usados para treinar modelos, não são combinados com dados de outras imobiliárias, não são vendidos, licenciados ou cedidos a terceiros, e não alimentam nenhuma base de dados comum da Impullso.
Cada imobiliária tem instância e banco de dados próprios, no CNPJ dela. Não existe base compartilhada entre clientes.
6. Endpoints declarados
- Domínio do aplicativo: impullsoconnector.com.br
- Política de privacidade: impullsoconnector.com.br/meta-privacidade
- Termos de serviço: impullsoconnector.com.br/meta-termos
- Instruções de exclusão de dados: impullsoconnector.com.br/meta-exclusao-de-dados
- Webhook de novos cadastros: https://api.impullsoconnector.com.br/webhooks/leadgen
- Retorno de chamada de desautorização: https://api.impullsoconnector.com.br/desautorizacao
7. Revogação
- Pelo sistema Impullso: Configurações › Integrações › Desconectar. Revoga o token, cancela as assinaturas de webhook e apaga as credenciais.
- Pelo Facebook: Configurações e privacidade › Configurações › Aplicativos e sites, remova o Impullso Connector.
- Pelo Instagram: Configurações › Segurança › Aplicativos e sites, remova o Impullso Connector.
A revogação interrompe a entrada de novos cadastros imediatamente, mas não apaga por si só o histórico já registrado no CRM, que pertence à imobiliária.