Como integrar sua imobiliária ao Canal Pro (ZAP, Viva Real e OLX), passo a passo

Integrar ao Canal Pro é mais simples do que parece e mais fácil de errar do que deveria. O trabalho todo é publicar um arquivo e cadastrá-lo no painel do portal — mas entre "cadastrei" e "meus imóveis estão no ar" existem algumas horas, um relatório de validação e dois ou três tropeços que todo mundo dá.

Este é o caminho inteiro, na ordem.

Antes de começar

• Contrato ativo no Canal Pro e acesso ao painel. O Canal Pro é o painel único do Grupo OLX: o que entra ali aparece no ZAP, no Viva Real e no OLX Imóveis, conforme o seu contrato.

• Saber a sua cota. Quantos anúncios no total e quantos em cada nível (padrão, destaque, super destaque). É esse número que decide o que o feed vai mandar.

• A URL do seu feed. Quem gera é o seu sistema. Se ele não gera, não há integração: sobra cadastrar imóvel a imóvel no painel do portal.

Passo 1 — Publique o feed e abra ele no navegador

Antes de entregar o endereço ao portal, abra você mesmo. É um teste de dez segundos que evita um dia de espera:

• Abriu e apareceu um monte de texto com etiquetas? Está no ar.

• Pediu senha, deu erro ou veio página em branco? O robô do portal vai encontrar a mesma coisa.

• Conte os imóveis. O número tem que ser o que você espera anunciar.

Passo 2 — Decida o que entra, e em que nível

Feed não é vitrine: é o que você está pagando para anunciar. Mandar a carteira inteira quando a cota é menor entrega ao portal a decisão de quais imóveis aparecem.

O critério que funciona: primeiro os que têm foto boa, preço definido e endereço completo; os destaques pagos reservados para o que tem mais chance de gerar visita, não para o mais caro.

Passo 3 — Cadastre a URL no painel do Canal Pro

No painel, procure a área de integrações — o nome do menu muda de tempos em tempos, mas é ali que se cadastra o XML. Você informa o endereço do feed e o portal faz uma primeira leitura.

Se a sua URL tem token, confira caractere por caractere. Token quase certo é a causa número um de integração que "não funcionou" sem nenhuma mensagem clara.

Passo 4 — Leia o relatório de validação

Esta é a etapa que quase todo mundo pula. O portal devolve, imóvel a imóvel, o que aceitou e o que recusou. As recusas mais comuns:

• Tipo de imóvel fora da tabela deles. Cada portal tem o próprio vocabulário; o seu sistema precisa traduzir antes de mandar.

• Foto que não abre. O endereço da imagem precisa responder para qualquer um, sem cookie e sem sessão.

• Preço ausente ou zerado.

• Endereço incompleto para o nível de exibição que você escolheu.

Corrigir é no seu cadastro, não no portal: o feed espelha o que o sistema tem. Corrigiu, espere a próxima leitura.

Passo 5 — Confira o primeiro ciclo completo

Um ciclo é uma leitura inteira do arquivo. Depois dele, três números têm que bater: o que você publicou, o que o feed anuncia e o que o painel do portal diz que recebeu.

Se os três batem, acabou — daí em diante é automático. Imóvel novo aparece sozinho, preço alterado atualiza sozinho, imóvel vendido sai sozinho.

Os tropeços mais comuns depois que já está funcionando

• O token girou. Trocou a chave do feed e não atualizou no portal: o robô leva 401 e conclui que não há imóveis. É o único erro desta lista que derruba a carteira inteira de uma vez.

• A carteira passou do limite de linhas de quem monta o arquivo. Os últimos imóveis param de sair, sem erro nenhum. Conte os imóveis do feed de vez em quando.

• Alguém despublicou o imóvel no sistema. Fora do site, fora do feed — e é assim que deve ser. Só que quem despublicou raramente sabe que mexeu no portal também.

O que muda quando a integração está boa

Some o retrabalho de cadastrar duas vezes e, com ele, some a divergência: o preço que caiu no seu site e continuou antigo no portal, o imóvel vendido que segue anunciado, a foto nova que só existe num lugar. O cliente que liga citando um anúncio passa a estar falando do mesmo imóvel que você tem na tela.