Webhooks: Propiedades

Configuración de Webhooks

Para recibir notificaciones automáticas sobre eventos de propiedades, debes registrar una URL pública (endpoint) que acepte solicitudes POST. Cada vez que ocurra un evento relevante, enviaremos un payload en formato JSON a esa URL.

ℹ️
Recomendación: Utiliza HTTPS para proteger la información transmitida y valida siempre la autenticidad de los eventos recibidos.

¿Cómo configuro mi endpoint? Ponte en contacto con nuestro equipo de soporte para registrar o actualizar la URL de tus webhooks.
POST https://tuservidor.com/webhooks/wiggot

Tu endpoint debe responder con un HTTP 2xx para confirmar la recepción exitosa del evento.

PROPERTY_CREATED

EVENTPROPERTY_CREATED

Este evento se emite cuando se crea una nueva propiedad. El payload incluye todos los detalles de la propiedad.

{
  "id": "e8a316e9-079b-4d32-87da-417809e94bd2",
  "type": "PROPERTY_CREATED",
  "created": "2025-05-26T23:06:42.743Z",
  "user": "wiggot@gmail.com",
  "data": {
    "object": {
      "title": "Terreno en preventa en Agronomos",
      "property_type": "TERRAIN",
      "public_id": "pkDrR1N"
    }
  }
}

PROPERTY_UPDATED

EVENTPROPERTY_UPDATED

Este evento se emite cuando se modifica cualquier dato de una propiedad existente. El payload contiene el estado actualizado completo de la propiedad y, en el campo previous_attributes, los valores anteriores de los campos que fueron modificados.

{
  "id": "3f71223d-bb9a-416c-9690-72c8815ed3ea",
  "type": "PROPERTY_UPDATED",
  "created": "2025-05-26T23:00:45.298Z",
  "user": "wiggot@gmail.com",
  "data": {
    "object": {
      "title": "Departamento en renta en Barrancos",
      "property_type": "APARTMENT",
      "public_id": "pm7lRHE"
    },
    "previous_attributes": {
      "updated_at": "2025-05-26T22:55:58.766Z",
      "assigned_user": "developer@wiggot.mx"
    }
  }
}
ℹ️
El objeto previous_attributes solo incluye los campos que cambiaron, permitiéndote identificar exactamente qué se modificó.

PROPERTY_DELETED

EVENTPROPERTY_DELETED

Este evento se emite cuando una propiedad es eliminada. El payload incluye el estado final de la propiedad antes de su eliminación.

{
  "id": "313fb1e4-1e02-4d72-a9ca-c5064eb54fc3",
  "type": "PROPERTY_DELETED",
  "created": "2025-05-26T23:08:48.526Z",
  "user": "wiggot@gmail.com",
  "data": {
    "object": {
      "title": "Departamento en renta en Barrancos",
      "property_type": "APARTMENT",
      "public_id": "pL90k4Y"
    }
  }
}

Webhooks: Prospectos

Notas sobre campos opcionales

ℹ️
Campos que pueden estar vacíos:
• assigned_users, interested_properties, origin_sources pueden ser arrays vacíos []
• phone, phone_code y email pueden ser null

Campo createdBy:
• "USER" - Lead creado/actualizado/eliminado manualmente por un asesor desde el sitio web de Wiggot
• "SYNC" - Lead creado/actualizado/eliminado automáticamente desde algún portal externo

LEAD_CREATED

EVENTLEAD_CREATED

Este evento se emite cuando se crea un nuevo lead. El payload incluye todos los detalles del lead incluyendo información de contacto, estado, usuarios asignados y propiedades de interés.

{
  "id": "49c62e40-f9f0-4029-9d65-4ca2bf02cbff",
  "type": "LEAD_CREATED",
  "created": "2025-08-09T04:45:23.346Z",
  "createdBy": "USER",
  "user": "lula@wiggot.com",
  "data": {
    "object": {
      "name": "Prospecto 1",
      "contact": {
        "phone": "33-5522-2222",
        "phone_code": "52",
        "email": "prospecto@wiggot.com"
      },
      "status": "Nuevos"
    }
  }
}

LEAD_UPDATED

EVENTLEAD_UPDATED

Este evento se emite cuando se modifica cualquier dato de un lead existente. El payload contiene el estado actualizado completo del lead y, en el campo previous_attributes, los valores anteriores de los campos que fueron modificados.

{
  "id": "49c62e40-f9f0-4029-9d65-4ca2bf02cbff",
  "type": "LEAD_UPDATED",
  "created": "2025-08-09T05:30:15.123Z",
  "createdBy": "USER",
  "user": "lula@wiggot.com",
  "data": {
    "object": {
      "name": "Prospecto 1",
      "contact": {
        "phone": "33-5522-2222",
        "phone_code": "52",
        "email": "prospecto@wiggot.com"
      },
      "status": "Contactados"
    },
    "previous_attributes": {
      "status": "Nuevos",
      "assigned_users": [
        "lula@wiggot.com"
      ],
      "interested_properties": [
        "ptPj9EH"
      ],
      "origin_sources": [
        "Wiggot"
      ]
    }
  }
}
ℹ️
El objeto previous_attributes solo incluye los campos que cambiaron, permitiéndote identificar exactamente qué se modificó en el lead.

LEAD_DELETED

EVENTLEAD_DELETED

Este evento se emite cuando un lead es eliminado. El payload incluye el estado final del lead antes de su eliminación.

{
  "id": "49c62e40-f9f0-4029-9d65-4ca2bf02cbff",
  "type": "LEAD_DELETED",
  "created": "2025-08-09T06:15:45.789Z",
  "createdBy": "USER",
  "user": "lula@wiggot.com",
  "data": {
    "object": {
      "name": "Prospecto 1",
      "contact": {
        "phone": "33-5522-2222",
        "phone_code": "52",
        "email": "prospecto@wiggot.com"
      },
      "status": "Eliminado"
    }
  }
}