TutoriaisIntegrações Chaves na Mão · ImóveisVoltar ao sistema ↗

Todos os tutoriais

Guia completo de Chaves na Mão

Disponibilize os imóveis do catálogo ao Chaves na Mão por um feed XML atualizado automaticamente.

▶ ASSISTA PRIMEIROVeja este assunto em vídeo
Portais de imóveis2:24

Prefere ler? O passo a passo completo continua logo abaixo. Ir para o passo a passo ↓

Tour visual com dados demonstrativos

Da configuração ao item marcado

As telas abaixo são reais da empresa Demo; nenhuma integração externa foi ativada.

1

Configure a integração com segurança

Confira modo, vertical, dados do anunciante e requisitos antes de ativar.

Abrir configuração
Configuração real de Chaves na Mão na empresa Demo
Integração demonstrativa mantida desativada
Etapa 1 de 2
01CadastreComplete o imóvel ou veículo.
02MarqueEscolha o portal no catálogo.
03ConfigureInforme dados e credenciais.
04ValideFaça um piloto antes do lote.

O que esta integração faz

PortalChaves na Mão
ModoFeed XML
CatálogoImóveis
Origem dos dadosProdutos/Serviços do CRM marcados para este portal.
O portal consulta o feed. Cada imóvel marcado aparece dentro de Carga > Imóveis com dados, localização, valores e fotos.

Antes de configurar

O feed de demonstração permanece desativado. Ative somente quando o portal confirmar o contrato e os dados do anunciante.

Passo a passo completo

  1. Abra a integração, preencha os dados da imobiliária, UF e cidade padrão.
  2. Marque Ativar integração e salve.
  3. Copie a URL do feed.
  4. Envie a URL para atendimento@chavesnamao.com.br junto com nome e CNPJ/CPF do responsável.
  5. No app Imóveis, abra cada imóvel, vá em Portais deste imóvel, marque Chaves na Mão e clique em Salvar seleção de portais. Só imóveis ativos entram no feed.
  6. Acompanhe a homologação e corrija eventuais campos solicitados.
Exemplo da empresa Demo

O imóvel “Apartamento Vista Parque — Demo” está marcado para este portal e aparece na lista de publicação.

Campos que merecem atenção

IdentificaçãoTítulo claro, descrição e código interno.
NegociaçãoVenda ou aluguel e respectivo preço.
LocalizaçãoUF, cidade, bairro, endereço, número e CEP.
CaracterísticasTipo, áreas, dormitórios, suítes, banheiros e vagas.
FotosURLs públicas; a primeira foto é tratada como principal.
Cadastre os dados no produto antes de diagnosticar o portal. Campos ausentes no catálogo não podem ser inventados pelo feed ou pela API.

Como a publicação acontece

O portal consulta o feed. Cada imóvel marcado aparece dentro de Carga > Imóveis com dados, localização, valores e fotos.

Feed XMLO portal busca periodicamente a URL. Alterações aparecem na próxima leitura.
APIO CRM envia o item quando você publica e registra o retorno.
ModeraçãoRecebido pelo portal não significa aprovado; regras comerciais e de conteúdo continuam válidas.

Entenda os status

PendenteItem marcado, ainda sem confirmação final do portal.
PublicadoA API aceitou o envio; o portal ainda pode moderar.
ErroAbra a mensagem e revise credenciais, contrato, campos e imagens.
Integração desativadaNenhum envio automático deve ser iniciado.

Checklist antes de ativar

  1. Confirme contrato, plano e homologação diretamente com o portal.
  2. Revise anunciante, telefone, e-mail, UF e cidade.
  3. Complete todos os campos do item e confira as fotos.
  4. Mantenha apenas um item piloto marcado no primeiro teste.
  5. Valide o retorno e a aparência no portal.
  6. Somente depois amplie para o restante do catálogo.

Dúvidas frequentes

Para onde envio a URL?

Para o canal de atendimento informado pelo Chaves na Mão, junto com a identificação do responsável.

Alterei o imóvel. Preciso reenviar?

Não. A mesma URL passa a entregar os dados atualizados.

Por que o anúncio não aparece?

Confira integração ativa, marcação do imóvel, campos obrigatórios e a última leitura/moderação do portal.

O CRM garante que o anúncio será aprovado?

Não. O CRM prepara e entrega os dados; aprovação, moderação, prazo e regras comerciais pertencem ao portal.

Posso usar credenciais de demonstração?

Não. Credenciais precisam pertencer à conta ou revenda contratante e ser fornecidas pelo portal.