Catálogo de eventos

Estos ejemplos reflejan la nomenclatura de eventos que ya se utiliza en la documentación de integraciones existente de watsi y buscan mostrar la estructura que una integración debe esperar y persistir.

Índice

Evento	Descripción
message.received	Carga útil de un nuevo mensaje entrante desde el flujo de mensajería.
message.status	Cambio de estado de entrega/lectura/fallo de un mensaje saliente.
conversation.created	Se creó un nuevo registro de conversación.
conversation.updated	Cambió un atributo de la conversación, como el responsable asignado o el estado de automatización.
contact.created	Se creó un nuevo registro de contacto.
contact.updated	Se actualizó el perfil de un contacto.

`message.received`

Se activa cuando un mensaje entrante llega a watsi. Los manejadores suelen usar este evento para sincronizar los mensajes entrantes hacia un CRM, almacén de datos o motor de flujos de trabajo externo.

{
  "id": "evt_01HXYZ111111111",
  "type": "message.received",
  "created_at": "2025-03-15T10:30:00.000Z",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "from": "5215512345678",
    "body": "Hola, quiero información",
    "messageId": "wamid.HBgL...",
    "conversationId": "chat_123",
    "channel": "whatsapp"
  }
}

`message.status`

Se activa cuando un mensaje saliente cambia de estado. Úselo para conciliar las transiciones de enviado, entregado, leído o fallido en los sistemas posteriores.

{
  "id": "evt_01HXYZ222222222",
  "type": "message.status",
  "created_at": "2025-03-15T10:32:00.000Z",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "messageId": "wamid.HBgL...",
    "status": "delivered",
    "recipientId": "5215512345678",
    "timestamp": "1710499920"
  }
}

`conversation.created`

Se activa cuando watsi abre un nuevo registro de conversación para un contacto.

{
  "id": "evt_01HXYZ333333333",
  "type": "conversation.created",
  "created_at": "2025-03-15T10:30:00.000Z",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "conversationId": "chat_123",
    "contactId": "contact_123",
    "status": "active",
    "channel": "whatsapp"
  }
}

`conversation.updated`

Se activa cuando cambia un campo rastreado de la conversación, como la asignación, el estado de cierre o el estado de automatización.

{
  "id": "evt_01HXYZ444444444",
  "type": "conversation.updated",
  "created_at": "2025-03-15T11:00:00.000Z",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "conversationId": "chat_123",
    "status": "closed",
    "assignedUserId": "user_123",
    "watsiEnabled": false
  }
}

`contact.created`

Se activa cuando watsi crea un nuevo registro de contacto.

{
  "id": "evt_01HXYZ555555555",
  "type": "contact.created",
  "created_at": "2025-03-15T10:30:00.000Z",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "contactId": "contact_123",
    "phone": "+5215512345678",
    "name": "Ana Martínez"
  }
}

`contact.updated`

Se activa cuando watsi actualiza el perfil de un contacto.

{
  "id": "evt_01HXYZ666666666",
  "type": "contact.updated",
  "created_at": "2025-03-16T09:00:00.000Z",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "contactId": "contact_123",
    "name": "Ana M. García",
    "email": "ana@example.com"
  }
}