Inicio rápido

Guía paso a paso para integrar su CRM con Spot2 Ingestion.

---

Requisitos previos

Antes de empezar, asegúrese de tener:

• Un endpoint REST que exponga en JSON las publicaciones activas seleccionadas para Spot2.
• Su endpoint debe soportar el parámetro updated_since (filtro de recencia por fecha de modificación).
• Un endpoint REST que exponga los IDs de propiedades eliminadas.
• Capacidad de agregar autenticación (API key, bearer token, o header custom).
• Paginación offset-based implementada.
• Propiedades comerciales (no residenciales).

---

Paso 1 — Construya su endpoint

Cree un endpoint GET que devuelva en JSON las publicaciones activas que el usuario marcó explícitamente para aparecer en Spot2:

GET https://su-crm.com/api/v1/spot2/properties?updated_since=2026-07-01T00:00:00Z

Requisitos mínimos:

• Content-Type: application/json.
• Autenticación: x-api-key o Authorization: Bearer.
• Paginación: offset con meta.next en la respuesta.
• Cada propiedad debe incluir al menos estos campos:
  • external_id — su identificador único e inmutable.
  • property_type — uno de: office, retail, industrial, terrain.
  • modality — rent, sale o rent_and_sale.
  • price.rent_price o price.sale_price — al menos un precio mayor a 0.
  • price.currency — código ISO 4217 (MXN o USD).
  • location.latitude — latitud decimal.
  • location.longitude — longitud decimal.
  • location.street — calle.
  • location.city — ciudad.
  • location.state — estado.
  • location.postal_code — código postal resoluble.
  • contact.name — nombre del contacto comercial.
  • contact.email — correo electrónico del contacto.
  • contact.phone — teléfono del contacto.

Campos muy recomendados:

• updated_at — fecha de última modificación en ISO 8601.
• photos — recomendamos 3 o más URLs públicas.

El detalle completo de campos, tipos, validaciones y ejemplos está en Esquema de propiedad.

---

Paso 2 — (Opcional) Arme su webhook

Si quiere recibir notificaciones cuando Ingestion acepta o rechaza una propiedad, exponga un endpoint POST:

POST https://su-crm.com/api/webhooks/spot2/feedback

Recibirá estados del webhook de Ingestion:

• PROCESSING: la propiedad fue aceptada y enviada al flujo downstream de publicación.
• REJECTED: la propiedad fue rechazada por errores bloqueantes. Incluye messages con los motivos en lenguaje natural.

Si no configura el webhook, sus propiedades se publican igual pero no recibe notificaciones de errores.

El contrato completo del webhook está en Webhook de retroalimentación.

---

Paso 3 — Implemente eliminación

Exponga un endpoint que devuelva los IDs de propiedades eliminadas de su CRM:

GET https://su-crm.com/api/v1/spot2/properties/deleted

Este endpoint es obligatorio. Spot2 lo consulta en cada ciclo para detectar bajas y desactivar propiedades. Sin este endpoint, las propiedades eliminadas de su CRM o retiradas de la selección para Spot2 seguirán publicadas en Spot2.

Detalles en Protocolo de eliminación.

---

Resumen de entregables

#	Qué necesita	Obligatorio	Doc de referencia
1	Endpoint GET de propiedades (con updated_since)	Sí	Protocolo de sincronización + Esquema de propiedad
2	Endpoint POST de webhook	No	Webhook de retroalimentación
3	Endpoint GET de eliminados (con since)	Sí	Protocolo de eliminación

---

Próxima lectura

• Esquema de propiedad: la referencia completa de campos.
• Protocolo de sincronización: el contrato de su API.
• Ciclo de vida: qué le pasa a una propiedad desde que la envía.
• Reglas de validación: qué validamos y por qué.
• Ejemplos de integración: casos concretos de request/response.