Integrar a Piperz ao CRM: guia de implantação 2026

A mídia que sai da produtora não cria cadastro no seu sistema: ela precisa encontrar um cadastro que já existe. Quem faz essa ligação é o código de referência do imóvel. Este guia resolve cinco decisões da implantação da Piperz: qual código escolher entre os que a ficha já tem, quem dentro da imobiliária responde por ele, para qual ficha vai cada tipo de arquivo que chega, o que esperar entre a mídia entrar na ficha e o anúncio subir no portal, e como virar a chave sem quebrar o cadastro que já funciona hoje.

---

O que precisa existir no seu sistema antes de a primeira foto chegar?

Duas coisas, e as duas são suas: a ficha do imóvel criada e o código de referência anotado. Mídia não cria cadastro — ela procura um cadastro que já está lá. Quando a ficha não existe no dia do ensaio, o arquivo chega e não tem onde aterrissar.

A ordem correta tem três passos e não admite inversão: cadastrar o imóvel no seu sistema, anotar a referência dele e só então agendar o ensaio informando essa referência no campo que a Piperz reserva para isso no agendamento. Se a sua operação ainda não centraliza mídia por imóvel, vale entender antes o que faz um gerenciador de mídia imobiliária.

Qual código do imóvel deve ir no campo de referência da Piperz?

A ficha tem mais de um identificador, então a resposta não é um nome de campo — é um critério de escolha. No payload da Piperz, o campo `referencia` é descrito como "o identificador de referência fornecido por você (ex: código do imóvel no seu CRM)": quem escolhe é a imobiliária, e está tudo em a documentação da API de integração da Piperz.

Os próprios sistemas mostram que há mais de um candidato na mesma ficha. Na documentação pública do Vista (consultada em 12/08/2026), a ficha expõe ao mesmo tempo campos distintos de código e de referência, incluindo um de referência externa. Na API de parceiros do Kenlo, o inGaia Imob v2 (consultada em 12/08/2026), o imóvel tem `property_reference` — "Referência do imóvel dentro do sistema de origem" — e a busca aceita referência e referência auxiliar. Escolher errado é o erro caro.

Um código bom atende a quatro critérios:

1. Único — não se repete em dois imóveis diferentes.
2. Estável — não muda quando o imóvel troca de corretor, muda de status ou volta ao mercado.
3. Legível por quem agenda — dá para ler e digitar sem consultar ninguém.
4. Igual ao que o corretor vê na tela — se a ficha e a planilha divergem, vale o da ficha.

Quem é o dono da chave — e o que acontece quando alguém digita errado?

Nomeie um dono. Uma pessoa com nome, não "a equipe": é ela quem define o critério acima, escreve onde a referência é lida e confere o que entrou. Chave sem dono vira campo preenchido de memória.

O motivo é duro. O Log de Envios da Piperz mostra, em tempo real, o status HTTP devolvido pelo seu servidor, com histórico de payload por tentativa e reenvio manual. Aí mora a frase que este artigo existe para dizer: 200 significa "seu sistema aceitou o envio", não "a mídia entrou na ficha certa".

Referência inexistente ou trocada produz mídia órfã com status verde no painel. O ensaio saiu, o servidor respondeu bem, e a foto não está na galeria de imóvel nenhum — ou está na do vizinho. A distinção não é particularidade da Piperz: na documentação da própria API do Kenlo (consultada em 12/08/2026), um POST aceito responde 202, "Inserido na fila com sucesso". Em qualquer ponto da cadeia vale a mesma leitura — aceite não é publicação.

Daí a única conferência que fecha o ciclo: o Log de Envios diz que o envio saiu; só a ficha aberta na tela diz que a mídia chegou.

Onde entram as fotos das áreas comuns do condomínio?

A pergunta não é "qual campo", é em qual ficha o arquivo aterrissa. O payload da Piperz traz `material[].empreendimento`, um campo de sim ou não, e no exemplo da própria documentação o serviço aparece como `"fotos empreendimento"` quando esse campo vem marcado como verdadeiro.

Do lado do CRM, a lógica é a mesma. A central de ajuda do Kenlo (consultada em 12/08/2026) diz que o imóvel em condomínio precisa ser vinculado ao condomínio e que "os detalhes referentes as áreas comuns deverão ser indicadas na ficha do condomínio"; a documentação do Vista (consultada em 12/08/2026) expõe grupos de foto separados para o imóvel e para o empreendimento. Na prática: foto de lazer é cadastrada uma vez, na ficha do empreendimento, e aparece nas unidades por vínculo — depois disso, a ordem das fotos é outra decisão. E como o Kenlo aceita JPEG/JPG até 5MB (consultado em 12/08/2026), qual versão do arquivo cada campo aceita é decisão do projeto de implantação.

Vídeo e tour 3D entram no mesmo lugar que as fotos?

Não, e por motivos diferentes. O vídeo é arquivo, mas mora fora da galeria: a documentação do Vista (consultada em 12/08/2026) descreve uma estrutura de vídeo independente das fotos. Já o tour 3D não é galeria: no exemplo de payload da documentação da Piperz, `"servico": "tour"` chega como um endereço só, e não como um conjunto de arquivos — o destino natural é um campo de link.

São as duas últimas linhas da tabela acima, e é ali que a implantação tropeça: o tour cai na galeria como se fosse imagem, o vídeo entra no meio das fotos e desarruma a sequência do anúncio. Definir esses dois campos no começo custa uma conversa; corrigir depois custa reabrir ficha por ficha.

Quando a mídia aparece de fato no anúncio: na ficha ou no portal?

São dois relógios encadeados, e "está na ficha" não é "está no portal". A Piperz entrega a mídia na ficha do imóvel no sistema (Kenlo ou Vista) em D+1 após a captação. Do CRM para o portal existe outro relógio, e ele é configuração da imobiliária: a central de ajuda do Kenlo (consultada em 12/08/2026) descreve o envio de carga para portais como Manual ou Automático diário, com a primeira carga recomendada manual. Vale checar antes como a foto precisa chegar ao portal.

captação → mídia tratada → ficha do imóvel no CRM → carga do portal → anúncio no ar

Como virar a chave sem parar a operação?

Implantação é projeto, não interruptor. O caminho que não derruba o cadastro tem quatro passos:

1. Lote-piloto — 5 a 10 imóveis reais, de tipologias diferentes, com pelo menos um em condomínio.
2. Conferência campo a campo — abrir cada ficha e olhar a galeria, o campo de vídeo e o campo de link, além do Log de Envios.
3. Critério de saída escrito — nenhuma mídia órfã, nenhuma foto de área comum na ficha errada, nenhum tour dentro da galeria.
4. Só então o corte — o fluxo antigo roda em paralelo até o critério ser atendido.

Você não faz isso sozinho: o time de desenvolvedores e engenheiros de suporte da Piperz auxilia no mapeamento do JSON e na configuração do webhook. O que roda dentro do seu sistema segue com você, como em qualquer produção de fotos e vídeos; o fluxo inteiro está na página da operação integrada.

---

Perguntas frequentes sobre integrar a Piperz ao CRM

Preciso ter o imóvel já cadastrado antes de agendar o ensaio?

Sim. Mídia não cria cadastro: ela procura um cadastro que já existe. A ficha do imóvel precisa estar criada e a referência anotada antes do agendamento, porque é esse código que o ensaio carrega até a entrega. Sem ficha, o arquivo chega sem destino.

Qual código do imóvel eu uso: o do CRM, o da planilha ou o da placa?

O que atender aos quatro critérios: ser único, estável, legível por quem agenda e igual ao que o corretor vê na tela. Se a planilha e a ficha divergirem, o desempate é sempre o código que aparece na ficha do imóvel dentro do seu sistema.

Se eu digitar o código errado no agendamento, dá para corrigir depois?

O Log de Envios guarda o histórico de payload por tentativa e permite o reenvio manual do envio, depois que a referência certa estiver acertada do seu lado. O que acontece dentro do seu sistema com o registro anterior é resolvido por você ou pelo suporte do CRM.

Meu CRM não é Kenlo nem Vista — quem responde pelo código de referência?

Você, e o critério não muda: o código continua sendo escolhido, escrito e conferido pela imobiliária. O que muda é quem grava a referência do outro lado — fora da integração nativa, quem recebe o envio da Piperz é o seu sistema, e é o seu fornecedor que define em qual cadastro aquele código aterrissa. Nomear um dono para a chave pesa ainda mais nesse cenário: sem mapeamento pronto, o erro de digitação só aparece quando alguém abre a ficha.

Quem faz essa configuração: eu, meu suporte do CRM ou a Piperz?

São três frentes. O endpoint você cadastra na tela de Integração. O time de desenvolvedores e engenheiros de suporte da Piperz auxilia no mapeamento do JSON e na configuração do webhook. O que acontece dentro do CRM é com você ou com o suporte dele. Contato: contato@piperz.io.

As fotos da área de lazer do prédio vão para cada apartamento ou só uma vez?

Só uma vez, na ficha do condomínio ou do empreendimento, e elas aparecem nas unidades por vínculo. A central de ajuda do Kenlo (consultada em 12/08/2026) indica que os detalhes das áreas comuns devem ser cadastrados na ficha do condomínio, não em cada imóvel.

Depois que a foto entra na ficha, ela vai automático para o ZAP e o VivaReal?

Depende da configuração de carga para portais do seu CRM, que pode ser Manual ou Automático diário (Kenlo, consultado em 12/08/2026). Estar na ficha não é estar no portal: são dois relógios diferentes, e o segundo é ajustado pela imobiliária.

A mídia só acha a ficha certa se a chave estiver certa

A sequência é curta e não tem atalho: ficha criada antes do ensaio, referência escolhida por critério e não por hábito, um dono nomeado para essa chave, cada tipo de mídia com destino definido, lote-piloto conferido campo a campo e só então o corte do fluxo antigo. Nessa ordem, a integração da Piperz deixa de ser risco para o cadastro e vira rotina. O resto é técnico, e está escrito na documentação.

Ainda não opera na plataforma? Veja como funciona a Piperz para imobiliárias.

Escrito pela Equipe Editorial Piperz

A Piperz é uma plataforma dedicada a simplificar a entrega segura de mídias imobiliárias, conectar fotógrafos e acelerar as vendas de imobiliárias e corretores através de imagens profissionais.