Webhook events and their contents.

Choose events when you add a webhook. Every event is sent in the same delivery shape; below is the data of each one.

message.received · Message received

A customer sends a message on WhatsApp, live chat, Instagram, Messenger, or Telegram.

{
  "message_id": 99141,
  "conversation_id": 812,
  "contact_id": 301,
  "channel": "whatsapp_official",
  "from": "6281234567890",
  "name": "Rina",
  "type": "text",
  "text": "Kak, pesanan INV-2207 sudah dikirim?",
  "has_media": false,
  "received_at": "2026-11-01T09:12:03+07:00"
}

message.status · Message status

An outgoing message is sent, delivered, read, or failed.

{
  "message_id": 99140,
  "conversation_id": 812,
  "channel": "whatsapp_official",
  "to": "6281234567890",
  "status": "read",
  "error": null,
  "at": "2026-11-01T09:13:10+07:00"
}

contact.created · New contact

A new contact is saved: from a first chat, a form, a store buyer, manual entry, or the API. Bulk imports are not sent.

{
  "contact_id": 301,
  "name": "Rina",
  "phone": "6281234567890",
  "email": "rina@contoh.com",
  "source_channel": "whatsapp",
  "created_at": "2026-11-01T09:12:03+07:00"
}

lead.created · New lead

A landing page or Bio Link form is submitted, or a WhatsApp chat matches a Smart Link click. Smart Link adds match, confidence, attribution_id, and conversation_id.

{
  "source": "landing_page",
  "source_id": 14,
  "source_name": "Promo Ramadan",
  "submission_id": 902,
  "contact_id": 301,
  "name": "Rina",
  "phone": "6281234567890",
  "email": "rina@contoh.com",
  "message": "Mau tanya paket reseller",
  "fields": [
    {
      "label": "Kota",
      "value": "Bandung"
    }
  ],
  "created_at": "2026-11-01T09:12:03+07:00"
}

order.paid · Order paid

Payment for a store order is received (QRIS or marked as paid).

{
  "order_id": 5521,
  "number": "INV-2207",
  "total": 185000,
  "currency": "IDR",
  "payment_method": "qris",
  "customer": {
    "name": "Rina",
    "phone": "6281234567890",
    "email": "rina@contoh.com"
  },
  "contact_id": 301,
  "items": 2,
  "paid_at": "2026-11-01T09:20:00+07:00"
}

ticket.created · New ticket

A ticket is created from a chat, a form, or by staff.

{
  "ticket_id": 77,
  "number": "#1077",
  "subject": "Paket belum sampai",
  "status": "open",
  "priority": "high",
  "source": "chat",
  "contact_id": 301,
  "conversation_id": 812,
  "assignee_id": 5,
  "created_at": "2026-11-01T09:15:00+07:00"
}

ticket.status · Ticket status

A ticket's status changes, for example to resolved.

{
  "ticket_id": 77,
  "number": "#1077",
  "status": "resolved",
  "previous_status": "open",
  "at": "2026-11-01T11:40:00+07:00"
}

template.status · Template status

A WhatsApp Official template is approved, rejected, or paused.

{
  "template_id": 41,
  "channel_id": "waba:3",
  "name": "konfirmasi_pesanan",
  "language": "id",
  "category": "UTILITY",
  "status": "APPROVED",
  "reason": null,
  "at": "2026-11-01T10:02:00+07:00"
}

channel.status · Channel status

A WhatsApp number connects or disconnects.

{
  "channel_id": "wa:12",
  "channel": "whatsapp_qr",
  "name": "CS Toko",
  "connected": false,
  "reason": "Perangkat logout dari WhatsApp.",
  "at": "2026-11-01T08:55:00+07:00"
}