Documentação

FuncionalidadesIntegrações

Chaves na Mão

Como publicar seus anúncios na Chaves na Mão pelo feed da Nobur e receber no Funil, sem cadastro manual, os leads desses anúncios.

A integração da Chaves na Mão liga a Nobur à sua conta no portal nos dois sentidos:

  • Anúncios — a Nobur monta um feed com os anúncios que você liga para a Chaves na Mão, e o portal o lê para publicá-los. Veja Publicando anúncios.
  • Leads — cada pedido de contato feito em um anúncio seu na Chaves na Mão chega à Nobur como um lead, com a origem Chaves na Mão, e segue o roteamento como qualquer outro lead. Veja Leads dos portais.

As integrações fazem parte dos planos pagos, a partir do Profissional, e só os gestores acessam as integrações. A integração também depende de um contrato ativo da imobiliária com a Chaves na Mão.

Cada URL diz de qual conta ela é. Por isso as duas URLs são únicas da sua integração: não as compartilhe. Para que a Nobur aceite só os leads que a Chaves na Mão envia, ative também a verificação dos leads.

Configurando a integração

Crie a integração

Em Configurações > Integrações, clique em Conectar ao lado de Chaves na Mão e dê um Nome à integração. Em Destaques, informe quantos anúncios em destaque o seu plano na Chaves na Mão inclui. Use 0 se ele não inclui nenhum.

Clique em Criar e continuar. A página da integração abre em seguida.

Envie as URLs à Chaves na Mão

Na página da integração, copie a URL do feed e a URL de leads. De um e-mail cadastrado na sua conta da Chaves na Mão, escreva para atendimento@chavesnamao.com.br:

  • diga que a sua integradora é a Nobur;
  • informe a URL do feed como URL de integração de imóveis;
  • informe a URL de leads como endpoint para integração de leads;
  • se outro sistema publica os seus anúncios hoje, peça que ele seja substituído.

O botão Escrever o e-mail, na página da integração, abre o e-mail já preenchido com as duas URLs.

Ative a verificação dos leads

Recomendado. Na página da integração, no passo Verificação dos leads, informe o e-mail da sua conta na Chaves na Mão e o Token Integração de leads e clique em Salvar. Veja Verificando os leads.

Ligue os anúncios

Na página de cada anúncio, em Portais, ligue Chaves na Mão e escolha o Destaque: Padrão ou Destaque. Para vários de uma vez, selecione-os na lista de anúncios, clique em Ativar e publicar e escolha a Chaves na Mão. Antes de confirmar, a Nobur mostra quantos entram no feed e quantos ficam pendentes, com o motivo.

Publicando anúncios

O feed leva os anúncios ativos que estão com a Chaves na Mão ligada e não têm pendências para ela. A Chaves na Mão lê o feed uma ou duas vezes por dia, e a página da integração mostra a última leitura. Todo anúncio vai no feed como venda.

Cada anúncio ligado mostra um destes status, na página do anúncio e na coluna Portais da lista:

StatusO que quer dizer
EnviadoO anúncio está no feed. A Chaves na Mão avalia cada anúncio para publicação.
PendenteO anúncio fica fora do feed até as pendências serem corrigidas. A página do anúncio lista o que corrigir.
Fora do feedO anúncio não está ativo. Só anúncios ativos entram no feed.

A Chaves na Mão não informa à Nobur se publicou cada anúncio. Depois de cada leitura, ela envia ao seu e-mail o resumo da importação, com os anúncios que recusou e o motivo.

Além das regras de todos os portais, a Chaves na Mão pede:

  • um tipo de imóvel que ela tenha;
  • uma descrição de até 3.000 caracteres;
  • de 1 a 30 fotos, em JPG ou WEBP;
  • o estado como a sigla da UF, como SC ou SP.

O bairro precisa ter o nome que os Correios usam. A Nobur não consegue conferir isso: um bairro com outro nome aparece no resumo que a Chaves na Mão envia por e-mail.

A Nobur não deixa passar dos destaques que você informou na integração e mostra quantos já estão em uso.

Para tirar um anúncio do feed, desligue a Chaves na Mão na página do anúncio, tire o anúncio do status ativo ou exclua-o. Ele sai do feed na hora, e a Chaves na Mão o retira na leitura seguinte.

A Chaves na Mão identifica cada anúncio pelo Código de referência, ou pelo ID na Nobur quando ele não tem código. Mudar o código de um anúncio que está no feed faz o portal retirar o anúncio antigo e criar outro.

Gerando uma nova URL

Se uma das URLs foi parar com quem não devia, gere outra:

  1. Na página da integração, no passo URL do feed ou URL de leads, clique em Gerar nova URL e confirme.
  2. Envie a nova URL para atendimento@chavesnamao.com.br, no lugar da anterior.

A URL antiga para de funcionar na hora. Até a Chaves na Mão cadastrar a nova, ela não consegue ler seus anúncios, ou os leads não chegam à Nobur.

Verificando os leads

A Chaves na Mão envia cada lead assinado com o e-mail da sua conta no portal e o Token Integração de leads, como descreve a documentação de leads da Chaves na Mão. O token fica no painel da Chaves na Mão, em Meus Dados, no fim da página, em Dados Adicionais.

Com os dois salvos na integração, a Nobur recusa qualquer pedido sem essa assinatura, mesmo que chegue pela URL de leads. Sem eles, a URL de leads basta para enviar um lead à Nobur. O token não é exibido de novo depois de salvo: para trocá-lo, clique em Trocar credenciais e informe o e-mail e o token outra vez. Remover verificação apaga os dois.

Com um e-mail ou token diferente dos que a Chaves na Mão usa, a Nobur recusa os leads até você corrigi-los. Os leads recusados ficam em Logs de sincronização, com o motivo Credenciais da Chaves na Mão não conferem, e entram no Funil quando você os reprocessa.

Ligando o lead ao anúncio

Cada pedido informa o código do anúncio no portal. A Nobur procura, só entre os anúncios e imóveis da sua organização, um anúncio com esse Código de referência, depois um anúncio ou um imóvel com esse ID na Nobur. Se encontra, o imóvel fica como o imóvel de interesse do lead. Se não encontra, o lead entra mesmo assim, sem imóvel.

Leads que não entraram

Um pedido que chega mas não pode ser registrado fica em Logs de sincronização, com status Falha e o motivo na coluna Erro. Corrija a causa e clique em Reprocessar na linha do pedido. Reprocessar um pedido que já virou lead não cria outro. Veja Leads que não entraram no Canal Pro, que funciona do mesmo jeito.