Get Available Events

Returns the full list of events you can subscribe to through webhooks. The response includes conversation, message, customer, ads, and WhatsApp Flows events.

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

Response

{
  "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",
      "referral.received",
      "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"
      ],
      "ads": [
        "referral.received"
      ],
      "whatsappFlow": [
        "whatsapp.flows.init",
        "whatsapp.flows.screen_advance",
        "whatsapp.flows.back",
        "whatsapp.flows.exchanges"
      ]
    }
  }
}

Conversations (6):

EventDescription
conversation.createdNew conversation created
conversation.status.updatedConversation status updated (open, pending, finished, spam, …)
conversation.operation.updatedConversation operation / pipeline updated
conversation.owners.updatedConversation owners updated
conversation.tags.updatedConversation tags updated
conversation.expiredConversation expired (24-hour WhatsApp window)

Messages (3):

EventDescription
message.createdNew message created
message.updatedMessage updated
message.deletedMessage deleted — not available yet. The event is declared in the catalog, but no emitter currently fires it. Subscribing produces no events.

Customers (5):

EventDescription
client.createdNew customer created
client.updatedCustomer updated
client.owners.updatedCustomer owners updated
client.tags.updatedCustomer tags updated
client.customFields.updatedCustomer custom fields updated

Meta Ads (1):

EventDescription
referral.receivedA customer started a conversation from a Meta ad (Click-to-WhatsApp, Click-to-Messenger, or Instagram ads). Includes ad_id, ctwa_clid, the ad context, and the text the customer sent. Only on channels connected directly with Meta.

WhatsApp Flows (4) — require a response:

EventDescription
whatsapp.flows.initFlow start (action: "INIT" from Meta)
whatsapp.flows.screen_advanceScreen advance (action: "data_exchange")
whatsapp.flows.backReturn to the previous screen (action: "BACK")
whatsapp.flows.exchanges"Umbrella" subscription — receives the three above on a single webhook

Use these pages to implement your endpoint:

  • Delivery and signatures : headers, envelope, and validation with secret.
  • Payloads : structure of conversation.*, message.*, client.*, and referral.received.
  • WhatsApp Flows : whatsapp.flows.* events, timeout, and the expected response shape.
Previous Create Webhook Next Delivery and Signatures