Jetimob
Ahora, NicoChat se conecta directamente al sistema inmobiliario Jetimob, permitiéndote automatizar toda la atención, la captación y la gestión de inmuebles de forma práctica e inteligente.
Jetimob es una plataforma completa para inmobiliarias y corredores, que reúne en un solo sistema el CRM de ventas y alquileres, la gestión de alquileres, el sitio inmobiliario y diversos recursos que facilitan el día a día de tu negocio.
Con la integración con NicoChat, podrás transformar esa estructura en una poderosa herramienta de automatización de conversaciones, captación y calificación de leads.
Nota
A partir de ahora, podrás listar inmuebles activos, obtener los detalles de un inmueble (incluidas las fotos) y crear leads directamente en el CRM de Jetimob — todo directamente desde el flujo de NicoChat. Base de la integración: la API oficial de Jetimob (api.jetimob.com).
Cómo obtener las credenciales
En el panel de Jetimob, en Integrações → Chaves API, existen tres claves disponibles. Por el flujo interno de la NicoApp, hoy solo dos de ellas se usan efectivamente por las acciones disponibles:
- Chave Webservice — es la clave usada en las dos acciones de consulta de inmuebles (Consultar imóveis Ativos y Consultar Detalhes de um Imóvel), que llaman a
GET https://api.jetimob.com/webservice/{'{'}chave_webservice{'}'}/imoveis. Es la credencial de lectura del catálogo de inmuebles. - Chave Privada — es la clave usada por la acción Criar Lead, que llama a
POST https://api.jetimob.com/leads/{'{'}chave_privada{'}'}. Es la credencial que autoriza la escritura en el CRM de Jetimob (creación de leads), por eso se trata como más sensible que la de lectura.
Atención
Chave Pública: ninguna de las tres acciones hoy disponibles en la NicoApp hace referencia a esa clave. Puede guardarse para otros usos dentro de la propia Jetimob (sitio, portales), pero no es necesaria para el funcionamiento de esta NicoApp en la versión actual.
Al instalar la NicoApp Jetimob, pega la Chave Webservice y la Chave Privada en los campos de configuración: es eso lo que autentica las llamadas descritas arriba.
Limitaciones
Nota
Jetimob no publica, en su documentación de ayuda, un número fijo de rate limit (solicitudes por minuto/hora) para la API pública. Lo que el propio centro de ayuda de Jetimob recomienda, al orientar integraciones de sitios/portales, es una frecuencia de sincronización: carga completa del catálogo cada 30 minutos y carga complementaria (novedades/cambios) cada 5 minutos. Trata esos intervalos como una buena práctica para no sobrecargar la API, aunque no sean un límite técnico documentado.
- Tamaño de respuesta: la acción Consultar imóveis Ativos puede devolver muchos inmuebles de una vez; internamente la NicoApp divide la lista en bloques de hasta ~19.000 caracteres para respetar el límite de tamaño de mensaje de NicoChat/WhatsApp — eso es una limitación del canal de mensajes, no de la API de Jetimob.
- Errores de la API: si Jetimob rechaza una llamada (clave inválida, permiso insuficiente, inmueble inexistente, etc.), la acción sigue por el camino de error del nodo: úsalo para tratar el fallo en el flujo.
Qué hace la NicoApp
Acción
Qué hace
Entradas principales
Salidas
Consultar imóveis Ativos
Lista los inmuebles activos de la cuenta Jetimob (
GET /webservice/{'{'}chave{'}'}/imoveis)Ninguna (usa solo la Chave Webservice)
Lista resumida por inmueble: id, código, tipo, barrio, ciudad, valor, dormitorios, suites, baños, área total, título del anuncio. No incluye fotos.
Consultar Detalhes de um Imóvel
Busca los datos completos de un inmueble específico por su ID/código
ID del Inmueble (código devuelto por el listado)
Imágenes/fotos, título del anuncio, valor de venta, área privativa, área total, garajes, baños, suites, dormitorios, observaciones
Criar Lead
Envía un lead al CRM de Jetimob (
POST /leads/{'{'}chave_privada{'}'})Obligatorios: full_name, email, phone, property_contract (tipo de contrato: venta/alquiler).
Sobre el contacto/lead: message, source, subject, tags, tag, responsible, temperature.
Sobre el inmueble: property_code, prospecting_supply_id, country_code.
Rastreo/UTMs: utm_id, utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, url, url_utm.
Atribución interna: agency_id, team_id, campaign.
Los campos vacíos, nulos o en cero se descartan automáticamente antes del envío: solo hace falta completar lo que la conversación realmente recopiló.
Sobre el contacto/lead: message, source, subject, tags, tag, responsible, temperature.
Sobre el inmueble: property_code, prospecting_supply_id, country_code.
Rastreo/UTMs: utm_id, utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, url, url_utm.
Atribución interna: agency_id, team_id, campaign.
Los campos vacíos, nulos o en cero se descartan automáticamente antes del envío: solo hace falta completar lo que la conversación realmente recopiló.
Confirmación de la creación del lead en el CRM de Jetimob
Flujo recomendado: captación y calificación de leads
- Consultar imóveis Ativos → el flujo presenta la lista resumida (sin fotos) para que el contacto elija un inmueble de interés.
- Consultar Detalhes de um Imóvel por el ID elegido → el flujo envía las fotos, el valor, el área y las demás características.
- Si el contacto demuestra interés, recopila Nombre, Correo electrónico y Teléfono y llama a Criar Lead, completando
property_codecon el inmueble consultado ysource/subjectcon el canal de origen (ej.: WhatsApp/NicoChat) — así el lead ya entra calificado en el CRM de Jetimob.
Consejos y observaciones
- Fotos solo en Detalles: el listado (Consultar imóveis Ativos) trae solo datos resumidos — nombre, valor, ubicación, características numéricas. Las fotos/imágenes solo vienen en la acción Consultar Detalhes de um Imóvel. Llama siempre a Detalles antes de enviar imágenes al contacto.
- ID encadenado: el ID/código del inmueble devuelto por Consultar imóveis Ativos alimenta tanto Consultar Detalhes de um Imóvel como el campo
property_codede Criar Lead — guárdalo en una variable del flujo en cuanto el contacto elija el inmueble. - Dos credenciales, dos propósitos: la Chave Webservice solo lee inmuebles; la Chave Privada solo graba leads. Trata la Chave Privada con más cuidado: es ella la que escribe datos en el CRM de Jetimob.
- Campos de Criar Lead: completa solo lo que tenga sentido para la conversación. Los campos en blanco se eliminan automáticamente antes del envío, así que no hace falta "forzar" valores para UTMs, gclid/fbclid, agencia o equipo cuando no exista esa información.