Obtener Eventos Disponibles

Obtiene la lista completa de eventos disponibles para suscribirse a través de webhooks. La respuesta incluye eventos de conversaciones, mensajes, clientes y WhatsApp Flows.

GET https://api.platica.mx/v1/webhooks/events

Respuesta

{
  "status": "success",
  "data": {
    "events": [
      "conversation.created",
      "conversation.status.updated",
      "conversation.operation.updated",
      "conversation.owners.updated",
      "conversation.tags.updated",
      "conversation.expired",
      "message.created",
      "message.updated",
      "message.deleted",
      "client.created",
      "client.updated",
      "client.owners.updated",
      "client.tags.updated",
      "client.customFields.updated",
      "whatsapp.flows.init",
      "whatsapp.flows.screen_advance",
      "whatsapp.flows.back",
      "whatsapp.flows.exchanges"
    ],
    "categories": {
      "conversation": [
        "conversation.created",
        "conversation.status.updated",
        "conversation.operation.updated",
        "conversation.owners.updated",
        "conversation.tags.updated",
        "conversation.expired"
      ],
      "message": [
        "message.created",
        "message.updated",
        "message.deleted"
      ],
      "client": [
        "client.created",
        "client.updated",
        "client.owners.updated",
        "client.tags.updated",
        "client.customFields.updated"
      ],
      "whatsappFlow": [
        "whatsapp.flows.init",
        "whatsapp.flows.screen_advance",
        "whatsapp.flows.back",
        "whatsapp.flows.exchanges"
      ]
    }
  }
}

Conversaciones (6):

Evento	Descripción
`conversation.created`	Nueva conversación creada
`conversation.status.updated`	Estado de conversación actualizado (`open`, `pending`, `finished`, `spam`, …)
`conversation.operation.updated`	Operación / pipeline de la conversación actualizada
`conversation.owners.updated`	Propietarios de conversación actualizados
`conversation.tags.updated`	Etiquetas de conversación actualizadas
`conversation.expired`	Conversación expirada (ventana de 24 h en WhatsApp)

Mensajes (3):

Evento	Descripción
`message.created`	Nuevo mensaje creado
`message.updated`	Mensaje actualizado
`message.deleted`	Mensaje eliminado — no disponible aún. El evento está declarado en el catálogo, pero hoy ningún emisor lo dispara. Suscribirse no produce eventos.

Clientes (5):

Evento	Descripción
`client.created`	Nuevo cliente creado
`client.updated`	Cliente actualizado
`client.owners.updated`	Propietarios de cliente actualizados
`client.tags.updated`	Etiquetas de cliente actualizadas
`client.customFields.updated`	Campos personalizados del cliente actualizados

WhatsApp Flows (4) — requieren respuesta:

Evento	Descripción
`whatsapp.flows.init`	Inicio del flow (`action: "INIT"` desde Meta)
`whatsapp.flows.screen_advance`	Avance de pantalla (`action: "data_exchange"`)
`whatsapp.flows.back`	Regreso a pantalla anterior (`action: "BACK"`)
`whatsapp.flows.exchanges`	Suscripción "paraguas" — recibe los 3 anteriores en un único webhook

Documentación relacionada

Usa estas páginas para implementar tu endpoint:

Entrega y firmas : headers, envelope y validación con secret.
Payloads : estructura de conversation.*, message.* y client.*.
WhatsApp Flows : eventos whatsapp.flows.*, timeout y forma de la respuesta esperada.

Anterior Crear Webhook Siguiente Entrega y Firmas