Impullso Connectorpor Impullso
Integração

Integração com o Grupo OLX

Como o Impullso Connector publica a carteira de imóveis nos portais do Grupo OLX — ZAP, Viva Real e OLX — e como os contatos gerados nesses anúncios voltam ao funil de vendas da imobiliária.

Versão 1.0 · Última atualização em 31/07/2026

Nesta página
  1. O que a integração faz
  2. Publicação de imóveis
  3. Recebimento de leads
  4. Dados trafegados
  5. Segurança
  6. Ativação pela imobiliária
  7. Dados para homologação
  8. Documentos

1. O que a integração faz

A integração é feita pelo Canal PRO do Grupo OLX e atende os três portais do grupo de uma só vez: ZAP, Viva Real e OLX. Em quais deles o anúncio aparece depende do plano contratado pela imobiliária junto ao grupo.

Ela tem dois sentidos, independentes entre si:

  • Publicação — a carteira cadastrada no sistema da imobiliária é disponibilizada em um arquivo XML que o Grupo OLX busca periodicamente.
  • Leads — quando alguém demonstra interesse em um anúncio, o Grupo OLX envia esse contato para um endereço do Connector, que o insere no funil de vendas da imobiliária identificando portal, imóvel e canal de origem.

O ganho operacional é acabar com o cadastro duplicado e com o contato que se perde: o imóvel é cadastrado uma vez, no sistema, e o interessado chega no funil já ligado ao imóvel que ele viu.

2. Publicação de imóveis

O Connector gera e mantém atualizado um arquivo XML com os imóveis que a imobiliária marcar como publicáveis, disponibilizado em endereço próprio e exclusivo de cada cliente, sobre HTTPS. O Grupo OLX baixa esse arquivo por um processo automático de leitura periódica.

  • São enviados fotos, título, descrição, características, endereço, CEP e valores.
  • Alterações de preço, situação e disponibilidade entram na carga seguinte.
  • Imóveis retirados da carteira ou marcados como vendidos deixam de constar no arquivo.
  • O arquivo respeita o limite de anúncios do plano contratado pela imobiliária.

Sobre a periodicidade: a leitura do arquivo é feita pelo Grupo OLX a cada 12 horas, duas vezes por dia. A publicação, portanto, não é instantânea — uma alteração feita de manhã pode aparecer no portal só no período seguinte. Esse comportamento é da plataforma, não do Connector, e é informado à imobiliária na implantação.

  • Endereço do arquivo: https://SISTEMA-DO-CLIENTE/integracoes/olx/{TOKEN}.xml
  • Protocolo: HTTPS, com certificado válido
  • Endereço exclusivo por cliente, não indexável e não compartilhado

3. Recebimento de leads

Quando um interessado entra em contato por um anúncio da imobiliária, o Grupo OLX envia esse lead ao Connector por meio de uma requisição POST sobre HTTPS, um lead por requisição, em formato JSON.

  • Endereço do endpoint: https://api.impullso.com.br/olx/lead/{TOKEN}
  • Endereço exclusivo por imobiliária — é o identificador na URL que direciona o lead à instância correta.
  • O Connector confirma o recebimento pelo código HTTP e processa a inserção em seguida.
  • Leads repetidos são identificados pelo identificador único de origem e não geram duplicidade no funil.

Cada lead entra no funil com:

  • nome, e-mail, DDD e telefone do interessado, e a mensagem que ele escreveu;
  • o imóvel de interesse, ligado ao cadastro correspondente no sistema;
  • o canal de origem: formulário, WhatsApp, chat, visualização de telefone, pedido de visita ou agendamento;
  • o tipo de interesse: venda ou locação;
  • a temperatura do lead, quando informada pelo portal;
  • um corretor responsável, conforme a regra de distribuição definida pela imobiliária.

4. Dados trafegados

Sistema → portal: apenas dados do imóvel e de identificação da imobiliária anunciante. Nenhum dado pessoal de cliente ou interessado trafega nesse sentido. Dados do proprietário do imóvel permanecem restritos ao sistema da imobiliária e nunca são enviados.

Portal → sistema: os dados que o próprio interessado forneceu ao demonstrar interesse no anúncio — nome, e-mail, telefone e mensagem — mais a identificação do anúncio, do canal e do tipo de interesse.

5. Segurança

  • Todo o tráfego, em ambos os sentidos, ocorre sobre HTTPS/TLS com certificado válido.
  • As requisições de lead são autenticadas por chave enviada no cabeçalho pelo Grupo OLX. Requisições sem a chave correta são recusadas com código 401 e nada é gravado.
  • O endereço de cada cliente contém um identificador aleatório, sem relação com dados da empresa.
  • Instância e banco de dados separados por cliente, sem base compartilhada.
  • Backup diário do banco de dados.
  • Acesso da equipe Impullso restrito a manutenção e suporte, com registro.

6. Ativação pela imobiliária

A ativação é feita pelo próprio anunciante, dentro da conta dele, e pode ser desfeita por ele a qualquer momento:

  1. A Impullso informa à imobiliária o endereço do arquivo de anúncios e o endereço de recebimento de leads, ambos exclusivos dela.
  2. No Canal PRO, o responsável cadastra o arquivo de anúncios na configuração de integração.
  3. Em Configurações › Integrações › Leads, ativa o recebimento de leads no CRM informando o endereço correspondente.
  4. Para encerrar, basta remover essas configurações no Canal PRO ou solicitar à Impullso pela tela de integrações do sistema.

A Impullso não solicita, não armazena e não tem acesso à senha do anunciante no Canal PRO ou em qualquer portal do grupo.

7. Dados para homologação

  • Integrador: Impullso Marketing Imobiliário
  • CNPJ: 23.035.412/0001-62
  • Nome da aplicação: Impullso Connector
  • Website: impullsoconnector.com.br
  • Contato técnico: [email protected]
  • Endereço: Av. dos Holandeses, 15 — Quadra 11, Olho D'Água, São Luís/MA, CEP 65065-180
  • Segmento: Imóveis
  • Imobiliárias atendidas: LISTAR OS CLIENTES

8. Documentos