Jetimob
Agora o NicoChat se conecta diretamente ao sistema imobiliário Jetimob, permitindo que você automatize todo o atendimento, captação e gestão de imóveis de forma prática, inteligent
A Jetimob é uma plataforma completa para imobiliárias e corretores, reunindo em um só sistema o CRM de vendas e locações, a gestão de aluguéis, o site imobiliário e diversos recursos que facilitam o dia a dia do seu negócio.
Com a integração com o NicoChat, você poderá transformar essa estrutura em uma poderosa ferramenta de automação de conversas, captação e qualificação de leads.
Nota
A partir de agora, você poderá listar imóveis ativos, obter os detalhes de um imóvel (incluindo fotos) e criar leads diretamente no CRM da Jetimob — tudo direto do fluxo do NicoChat. Base da integração: API oficial Jetimob (api.jetimob.com).
Como obter as credenciais
No painel Jetimob, em Integrações → Chaves API, existem três chaves disponíveis. Conferindo o fluxo interno do miniapp, hoje apenas duas delas são efetivamente usadas pelas ações disponíveis:
- Chave Webservice — é a chave usada nas duas ações de consulta de imóveis (Consultar imóveis Ativos e Consultar Detalhes de um Imóvel), que chamam
GET https://api.jetimob.com/webservice/{'{'}chave_webservice{'}'}/imoveis. É a credencial de leitura do catálogo de imóveis. - Chave Privada — é a chave usada pela ação Criar Lead, que chama
POST https://api.jetimob.com/leads/{'{'}chave_privada{'}'}. É a credencial que autoriza gravação no CRM da Jetimob (criação de leads), por isso é tratada como mais sensível que a de leitura.
Atenção
Chave Pública: nenhuma das três ações hoje disponíveis no miniapp referencia essa chave. Ela pode ser mantida em mãos para outros usos dentro da própria Jetimob (site, portais), mas não é necessária para o funcionamento deste miniapp na versão atual.
Ao instalar o NicoApp Jetimob, cole a Chave Webservice e a Chave Privada nos campos de configuração — é isso que autentica as chamadas descritas acima.
Limitações
Nota
A Jetimob não publica, em sua documentação de ajuda, um número fixo de rate limit (requisições por minuto/hora) para a API pública. O que a própria central de ajuda da Jetimob recomenda, ao orientar integrações de sites/portais, é uma frequência de sincronização: carga completa do catálogo a cada 30 minutos e carga complementar (novidades/alterações) a cada 5 minutos. Trate esses intervalos como boa prática para não sobrecarregar a API, mesmo não sendo um limite técnico documentado.
- Tamanho de resposta: a ação Consultar imóveis Ativos pode retornar muitos imóveis de uma vez; internamente o miniapp quebra a lista em blocos de até ~19.000 caracteres para respeitar o limite de tamanho de mensagem do NicoChat/WhatsApp — isso é uma limitação do canal de mensagens, não da API da Jetimob.
- Erros da API: se a Jetimob recusar uma chamada (chave inválida, permissão insuficiente, imóvel inexistente etc.), a ação segue pelo caminho de erro do bloco — use-o para tratar a falha no fluxo.
O que o miniapp faz
Ação
O que faz
Entradas principais
Saídas
Consultar imóveis Ativos
Lista os imóveis ativos da conta Jetimob (
GET /webservice/{'{'}chave{'}'}/imoveis)Nenhuma (usa apenas a Chave Webservice)
Lista resumida por imóvel: id, código, tipo, bairro, cidade, valor, dormitórios, suítes, banheiros, área total, título do anúncio. Não inclui fotos.
Consultar Detalhes de um Imóvel
Busca os dados completos de um imóvel específico pelo seu ID/código
ID do Imóvel (código retornado pela listagem)
Imagens/fotos, título do anúncio, valor de venda, área privativa, área total, garagens, banheiros, suítes, dormitórios, observações
Criar Lead
Envia um lead para o CRM da Jetimob (
POST /leads/{'{'}chave_privada{'}'})Obrigatórios: full_name, email, phone, property_contract (tipo de contrato: venda/locação).
Sobre o contato/lead: message, source, subject, tags, tag, responsible, temperature.
Sobre o imóvel: property_code, prospecting_supply_id, country_code.
Rastreamento/UTMs: utm_id, utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, url, url_utm.
Atribuição interna: agency_id, team_id, campaign.
Campos vazios, nulos ou zerados são descartados automaticamente antes do envio — só é preciso preencher o que a conversa realmente coletou.
Sobre o contato/lead: message, source, subject, tags, tag, responsible, temperature.
Sobre o imóvel: property_code, prospecting_supply_id, country_code.
Rastreamento/UTMs: utm_id, utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, url, url_utm.
Atribuição interna: agency_id, team_id, campaign.
Campos vazios, nulos ou zerados são descartados automaticamente antes do envio — só é preciso preencher o que a conversa realmente coletou.
Confirmação de criação do lead no CRM da Jetimob
Fluxo recomendado: captação e qualificação de leads
- Consultar imóveis Ativos → o bot apresenta a lista resumida (sem fotos) para o contato escolher um imóvel de interesse.
- Consultar Detalhes de um Imóvel pelo ID escolhido → o bot envia as fotos, valor, área e demais características.
- Se o contato demonstrar interesse, colete Nome, E-mail e Telefone e chame Criar Lead, preenchendo
property_codecom o imóvel consultado esource/subjectcom o canal de origem (ex.: WhatsApp/NicoChat) — assim o lead já entra qualificado no CRM da Jetimob.
Dicas e observações
- Fotos só em Detalhes: a listagem (Consultar imóveis Ativos) traz apenas dados resumidos — nome, valor, localização, características numéricas. As fotos/imagens só vêm na ação Consultar Detalhes de um Imóvel. Sempre chame Detalhes antes de enviar imagens ao contato.
- ID encadeado: o ID/código do imóvel retornado por Consultar imóveis Ativos alimenta tanto Consultar Detalhes de um Imóvel quanto o campo
property_codede Criar Lead — guarde-o em uma variável do fluxo assim que o contato escolher o imóvel. - Duas credenciais, dois propósitos: a Chave Webservice só lê imóveis; a Chave Privada só grava leads. Trate a Chave Privada com mais cuidado — é ela que escreve dados no CRM da Jetimob.
- Campos de Criar Lead: preencha apenas o que fizer sentido para a conversa. Campos em branco são removidos automaticamente antes do envio, então não é preciso "forçar" valores para UTMs, gclid/fbclid, agência ou equipe quando não houver essa informação.