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.

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.