O que é a URL Padrão?
A URL padrão é o modelo de link que o sistema usa para montar o endereço correto de cada imóvel no seu site. Quando um lead chega ou um corretor envia uma mensagem automática com o link do imóvel, é essa URL que determina para onde o cliente será direcionado.
Exemplo:
Padrão configurado:
https://meusite.com.br/imovel/imovel-{propertyCode}Código do imóvel:
12345URL final gerada:
https://meusite.com.br/imovel/imovel-12345
O placeholder {propertyCode} é substituído automaticamente pelo código de cada imóvel.
Por que Configurar Corretamente?
Se a URL padrão estiver errada ou em branco:
Links de imóveis enviados por e-mail ou WhatsApp levarão a páginas inexistentes (erro 404)
Templates de mensagem com
{propertyUrl}exibirão links quebradosO cliente não conseguirá acessar o anúncio do imóvel pelo link recebido
Relatórios e integrações com portais podem ter URLs inválidas
Como Montar a URL Padrão
Passo 1 — Identifique o padrão do seu site
Acesse um imóvel no seu site e observe a estrutura da URL. Exemplos comuns:
Formato do site | URL padrão a configurar |
|
|
|
|
|
|
|
|
Dica: Abra 2-3 imóveis diferentes no site e compare as URLs. A parte que muda entre eles é o código do imóvel — substitua por {propertyCode}.
Passo 2 — Acesse a configuração do CRM
Na plataforma Harry, vá até as configurações de integração com o CRM e localize o campo "URL padrão do imóvel" (ou "Property URL Pattern").
Passo 3 — Preencha o campo
Insira a URL completa com o placeholder {propertyCode} no lugar do código:
<https://meusite.com.br/imovel/imovel-{propertyCode}>
Passo 4 — URL para imóveis de locação (opcional)
Se o seu site usa URLs diferentes para imóveis de venda e locação, preencha também o campo "URL padrão do imóvel - Locação":
Venda:
https://meusite.com.br/venda/{propertyCode}Locação:
https://meusite.com.br/aluguel/{propertyCode}
Se os imóveis de venda e locação usam o mesmo formato de URL, não é necessário preencher o campo de locação — o sistema usará o padrão de venda para ambos.
Normalização do Código do Imóvel (Avançado)
Alguns CRMs enviam códigos de imóveis com prefixos ou caracteres extras que não fazem parte da URL do site. Para esses casos, existe o campo "Regex de normalização".
Exemplo:
CRM envia código:
PROP-12345URL do site espera:
12345Regex configurado:
^PROP-(remove o prefixo "PROP-")
Situação | Regex | Código original | Resultado |
Remover prefixo "PROP-" |
| PROP-12345 | 12345 |
Manter apenas números |
| AP-2024-001 | 2024001 |
Remover tudo após "-" |
| 12345-A | 12345 |
Importante: Essa configuração é avançada. Na maioria dos casos, o código do CRM já é compatível com o site e esse campo pode ficar em branco.
Onde a URL Aparece no Sistema
Uma vez configurada corretamente, a URL do imóvel é utilizada em:
Local | Como aparece |
Mensagens automáticas | Placeholder |
E-mails de agendamento de visita | Link do anúncio enviado ao cliente |
Detalhe do atendimento | Link clicável para abrir o imóvel no site |
Integração com portais | URL enviada para VivaReal, Zap, etc. |
Exportações e relatórios | Coluna com link do imóvel |
Relação com Outras Funcionalidades
Funcionalidade | Como se relaciona |
Templates de mensagem | Usam |
Integração com CRM | URL é montada durante a importação/sincronização de imóveis |
Portais (VivaReal, Zap) | Recebem a URL gerada para exibir o link do imóvel |
Ações automáticas | Mensagens automáticas podem incluir link do imóvel |
Importação de Imóveis | Cada imóvel importado recebe sua URL baseada no padrão |
Integração Vista CRM | Usa a URL padrão para gerar links dos imóveis sincronizados |
CRMs que Já Enviam a URL Completa
Algumas integrações com CRM já fornecem a URL completa do imóvel diretamente. Nesses casos, não é necessário configurar a URL padrão — o sistema usará a URL que o próprio CRM informa.
Como funciona:
Se o CRM envia uma URL completa para o imóvel (ex:
https://meusite.com.br/imovel/12345), o sistema usa essa URL diretamente.A URL padrão só é aplicada quando o CRM não envia uma URL — nesse caso, o sistema monta o link usando o padrão configurado + o código do imóvel.
Resumo: Se ao sincronizar imóveis os links já estão corretos sem configurar a URL padrão, significa que o seu CRM já envia a URL completa. Nenhuma configuração adicional é necessária.
Configuração por Tipo de CRM
Tipo de CRM | O que preencher |
API (Vista, SI9, JetImobi, etc.) | URL base da API + URL padrão do imóvel (se o CRM não enviar URL completa) |
XML (Robust, Ingaia, TecImob, etc.) | URL do feed XML + URL padrão do imóvel (se o CRM não enviar URL completa) |
Se o CRM já fornece a URL completa de cada imóvel, o campo de URL padrão pode ficar em branco.
Erros Comuns
Erro | Causa | Solução |
Links levam a página 404 | URL padrão com formato errado | Verifique a URL de um imóvel no site e ajuste o padrão |
| Campo de URL padrão em branco | Configure a URL padrão na integração do CRM |
Link funciona para venda mas não para locação | URL de locação diferente e não configurada | Preencha o campo "URL padrão - Locação" |
Código do imóvel aparece com prefixo na URL | CRM envia código com caracteres extras | Configure a regex de normalização |
URL gerada com "undefined" ou código errado | Imóvel sem código no CRM | Verifique se o imóvel tem código cadastrado no CRM de origem |
Perguntas Frequentes
O que é o {propertyCode}?
É um placeholder (marcador de posição) que o sistema substitui automaticamente pelo código real de cada imóvel. Você não precisa trocar manualmente — basta colocar {propertyCode} onde o código apareceria na URL.
Preciso incluir o https:// na URL padrão?
Sim, recomendamos incluir a URL completa com protocolo e domínio para garantir que os links funcionem corretamente em todos os contextos (e-mail, WhatsApp, portais).
Posso usar a mesma URL padrão para venda e locação?
Sim. Se o seu site usa o mesmo formato para ambos, preencha apenas o campo de venda. O sistema usará o mesmo padrão para locação automaticamente.
Se eu alterar a URL padrão, os links antigos são atualizados?
Os imóveis sincronizados após a alteração receberão a nova URL. Imóveis existentes terão a URL atualizada na próxima sincronização com o CRM.
Preciso configurar para cada CRM separadamente?
Sim. Cada integração de CRM tem seus próprios campos de URL padrão. Se a imobiliária usa mais de um CRM, configure a URL em cada um.
O campo "Regex de normalização" é obrigatório?
Não. A grande maioria das imobiliárias não precisa usar esse campo. Só configure se o código do imóvel no CRM tiver caracteres extras que não fazem parte da URL do site.