Intégrate con YAVE
API de leads
Envía leads desde tu sitio, landing, CRM o ERP con una API key.
Formularios web
Incrusta un formulario de YAVE con una línea, o envía el tuyo por API.
Widget de WhatsApp
Botón de WhatsApp que conserva la campaña de origen del lead.
Webhooks
Dispara automatizaciones desde afuera y recibe eventos en tu servidor.
Catálogo público
Muestra en tu sitio los proyectos e inmuebles que publicas en YAVE.
Agentes de IA (MCP)
Conecta Claude u otro agente compatible con MCP a tu CRM.
¿Qué integración necesito?#
| Quiero… | Usa | ¿Código? |
|---|---|---|
| Que los contactos de mi sitio web lleguen a YAVE | Formulario incrustado | Pegar un snippet |
| Mantener mi propio formulario y mandar los datos a YAVE | API de leads | Sí (servidor) |
| Conectar Zapier, Make, n8n, Dapta u otra herramienta | API de leads | No |
| Saber de qué campaña vino cada chat de WhatsApp | Widget de WhatsApp | Pegar un snippet |
| Avisar a mi sistema cuando un lead cambia de etapa | Webhook saliente | Recibir un POST |
| Mostrar el inventario en un sitio a la medida | Catálogo público | Sí |
| Consultar y operar el CRM desde un asistente de IA | Servidor MCP | No |
| Conectar Meta Ads, TikTok, Google Ads o portales | Integraciones nativas | No |
Inicio rápido: tu primer lead en 3 minutos#
- Pide a un administrador de la organización que cree una API key en Configuración → Integraciones → API Key dentro del CRM (
app.yavehome.com). La clave empieza poryave_. - Envía un lead de prueba desde tu servidor:
curl -X POST https://api.yavehome.com/api/v1/webhooks/custom \
-H "Content-Type: application/json" \
-H "X-API-Key: yave_tu_api_key" \
-d '{
"action": "create_lead",
"data": {
"name": "Laura Gómez",
"phone": "+57 300 123 4567",
"email": "[email protected]",
"source": "WEBSITE",
"utm_source": "google",
"utm_campaign": "lanzamiento-torre-2"
}
}'- Abre el embudo en el CRM: el lead aparece en segundos, asignado a un asesor según las reglas de la organización, y dispara las automatizaciones y la IA configuradas para leads nuevos.
Conceptos clave#
| Concepto | Qué significa para tu integración |
|---|---|
| Organización | Cada inmobiliaria o constructora es una organización aislada. Una API key solo lee y escribe datos de su propia organización. |
| Lead | Un prospecto o cliente. YAVE lo identifica por teléfono: si el número ya existe en la organización, no se crea un duplicado. |
| Embudo y etapas | Cada lead vive en un embudo (pipeline) con etapas. YAVE decide el embudo con las reglas de enrutamiento de la organización (origen, UTM, formulario). |
| Origen (source) | Texto libre que indica de dónde viene el lead (WEBSITE, LANDING, PORTAL…). Se usa en informes y en las reglas de enrutamiento. |
| Atribución (UTM) | Los parámetros utm_* y los identificadores de clic (gclid, fbclid) alimentan los informes de marketing y las conversiones que YAVE devuelve a Meta y Google. |
URL base y formato#
Todas las rutas de esta documentación son relativas a https://api.yavehome.com/api/v1, salvo que se indique otra cosa. El API solo acepta HTTPS, recibe y devuelve application/json y usa fechas en ISO 8601 (2026-10-01T15:00:00-05:00).
Tu API key es una contraseña
Nunca la pongas en JavaScript que corre en el navegador, en una app móvil ni en un repositorio público. Llama al API desde tu servidor; si necesitas capturar desde el navegador sin servidor, usa los formularios o el widget, que no requieren clave.Soporte#
¿Algo no funciona como dice aquí o necesitas un endpoint que no está? Escríbenos por WhatsApp con el nombre de la organización, la hora aproximada de la petición y el requestId del error (ver formato de error).