Event & Payload

Nama jenis event menggunakan format dot-namespaced (resource.action), konvensi yang sama dengan yang digunakan Stripe, GitHub, dan Meta. Setiap body JSON event membawa field event dengan string yang persis sama.

Matriks dukungan

Tidak semua channel dapat mengirimkan semua event — sebagian besar karena platform yang mendasarinya (WhatsApp, Telegram, Instagram, Messenger) memang tidak menyediakannya. Pemilih event di dashboard akan menampilkan abu-abu untuk apa pun yang tidak didukung oleh channel yang Anda pilih, sehingga Anda tidak bisa salah berlangganan sesuatu yang tidak akan pernah terpicu.

Referensi event

Bentuk JSON persis dari setiap event, per channel, ada di bawah.

Envelope payload

Setiap request webhook menggunakan envelope yang sama:

Code
{
  "event": "message.received",
  "created_at": "2026-09-16T10:00:00Z",
  "data": { },
  "raw_payload": { }
}

event sesuai persis dengan salah satu jenis event. Bentuk data tergantung pada event — identik di semua channel kecuali beberapa field yang dicatat di bawah. raw_payload bersifat opsional dan hanya muncul jika Anda mengaktifkannya — lihat penjelasan di bawah.

Raw provider payload

Setiap webhook endpoint punya toggle Include raw provider payload (nonaktif secara default, ada di form Add/Edit Webhook). Saat diaktifkan, setiap delivery pada endpoint itu akan menyertakan field raw_payload — sejajar dengan data, bukan bersarang di dalamnya — berisi payload yang benar-benar diterima Chatmo dari channel untuk event tersebut, hampir apa adanya.

Gunakan data untuk kebutuhan yang sudah dicakupnya, yaitu hampir semuanya: teks, file pesan media (data.media.url, tersimpan di Chatmo), lokasi, kontak yang dibagikan, template dan balasan tombol semuanya punya block normalized sendiri di setiap channel. Aktifkan raw_payload hanya jika Anda butuh field khusus provider yang tidak ada di data. Lihat Raw payload tiap channel di bawah.

:::warning Ini bentuk dari channel, bukan dari Chatmo raw_payload mencerminkan item webhook asli dari WhatsApp / Telegram / Meta untuk event tersebut, lengkap dengan nama field aslinya. Ini tidak dinormalisasi, tidak diversi oleh Chatmo, dan bisa berubah kapan saja provider mengubah API mereka — Chatmo tidak menjamin bentuknya seperti pada data. Aktifkan ini hanya jika Anda siap menanganinya, dan perlakukan sebagai kode integrasi khusus-channel, bukan kontrak yang stabil. :::

raw_payload hanya pernah ada untuk event yang benar-benar diterima Chatmo dari sebuah channel. Event yang berasal dari Chatmo sendiri tidak pernah menyertakannya, terlepas dari toggle-nya:

Event lainnya (message.received, message.reaction.added/.removed, message.status.*, template.status_updated, call.status_updated) akan menyertakannya, di setiap channel yang memang mendukung event tersebut — lihat matriks dukungan.

:::tip Coba dengan Test Tombol Test juga mengirim raw_payload yang realistis per channel (kalau toggle-nya aktif), dibangun dari bentuk yang sama seperti di halaman ini — cara yang bagus untuk melihat nama field sebenarnya sebelum menulis kode apa pun. Lihat Pengujian & Log Pengiriman. :::

message.received

Code
{
  "event": "message.received",
  "created_at": "2026-09-16T10:00:01Z",
  "data": {
    "message_id": "3f9c9d2a-6b7e-4d1a-9c2b-1a2b3c4d5e6f",
    "conversation_id": "b6e2a2b0-9b21-4b6a-8b7a-9d3f6c1a2e10",
    "external_message_id": "wamid.HBgLNjI4MjE0MTAwMDA=",
    "type": "TEXT",
    "content": "Hi, is this product still available?",
    "timestamp": "2026-09-16T10:00:00Z",
    "sender": {
      "type": "CONTACT",
      "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "Sarah Wijaya"
    },
    "contact": {
      "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "Sarah Wijaya",
      "phone": "6281234567890"
    }
  }
}

message.received dan message.sent memakai bentuk data yang persis sama di semua channel. Partner cukup menangani keduanya dengan satu parser.

Field

Field bertanda "–" tidak dikirim sama sekali (bukan null) jika tidak relevan, jadi periksa dulu keberadaan key-nya sebelum membacanya. Field opsional baru bisa ditambahkan seiring waktu; abaikan key yang tidak Anda kenali.

Jenis konten

type mencerminkan apa yang sebenarnya dikirim. Baca content untuk teksnya, lalu block sesuai tipenya:

LOCATION dan CONTACT datang dari WhatsApp Official, WhatsApp Unofficial dan Telegram. Facebook dan Instagram (Messenger Platform) tidak punya pesan location atau contact-share, jadi di dua channel itu kontak bisa mengirim TEXT, IMAGE, VIDEO, AUDIO, DOCUMENT atau STICKER. TEMPLATE masuk datang dari WhatsApp Unofficial, saat akun WhatsApp Business lain mengirim pesan template atau interaktif ke nomor Anda.

Block khusus per tipe

media

Ada untuk IMAGE, VIDEO, AUDIO, DOCUMENT dan STICKER. Chatmo mengunduh setiap file masuk dari channel dan menyimpan salinannya di storage Chatmo sendiri, jadi media.url adalah link langsung https://files.chatmo.io/... di semua channel. Anda tidak butuh access token provider, bot token, atau panggilan Graph API untuk mengambilnya, dan link-nya tidak kedaluwarsa seperti link CDN provider.

Code
{
  "event": "message.received",
  "created_at": "2026-10-13T17:01:52Z",
  "data": {
    "message_id": "40387d23-c8da-4bfc-a517-9927defc10d9",
    "conversation_id": "e4151f70-8eaf-4ca5-9db5-d22aea8981d5",
    "external_message_id": "TLGM3A32B4316ACE63FE",
    "type": "IMAGE",
    "content": "Is this the one you have in stock?",
    "timestamp": "2026-10-13T17:01:51Z",
    "sender": { "type": "CONTACT", "id": "231e258a-fc0d-4617-8aef-3bb481f1ba89", "name": "Fahmi Tyastomo" },
    "contact": { "id": "231e258a-fc0d-4617-8aef-3bb481f1ba89", "name": "Fahmi Tyastomo" },
    "media": {
      "id": "6c0f3b1e-2a4d-4f7b-9e1c-8d2a5b7c9e01",
      "url": "https://files.chatmo.io/chat/2026/10/13/photo_8f2c1a.jpg",
      "file_name": "photo_8f2c1a.jpg",
      "mime_type": "image/jpeg",
      "file_size": 184233,
      "thumbnail_url": "https://files.chatmo.io/chat/2026/10/13/photo_8f2c1a_thumb.jpg",
      "caption": "Is this the one you have in stock?"
    }
  }
}

Hanya url yang dijamin ada. Field lainnya diisi jika diketahui. Pada kasus langka Chatmo gagal menyalin file dari channel (error provider saat itu), id tidak ada dan url berisi link asli provider (Facebook / Instagram, berumur pendek) atau seluruh block media tidak dikirim. Referensi asli dari provider tetap ada di raw_payload jika Anda mengaktifkannya.

location

Ada untuk LOCATION.

Code
"location": {
  "latitude": -6.1753924,
  "longitude": 106.8271528,
  "name": "Monas",
  "address": "Gambir, Central Jakarta, Jakarta",
  "static_map_url": "https://files.chatmo.io/maps/2026/10/13/-6.17539,106.82715.png"
}

latitude dan longitude selalu diisi. name dan address berasal dari channel untuk tempat yang punya nama; jika tidak ada, Chatmo mencarinya dari koordinat (best effort). static_map_url adalah gambar preview peta.

contacts

Ada untuk CONTACT. Selalu berupa array, walaupun hanya satu kontak.

Code
"contacts": [
  {
    "name": "Budi Santoso",
    "phone": "+6281298765432",
    "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Budi Santoso\nTEL;type=CELL:+6281298765432\nEND:VCARD"
  }
]

vcard hanya disertakan jika channel mengirim teks vCard mentah (WhatsApp Unofficial).

template

Ada untuk pesan TEMPLATE (dan pesan interaktif WhatsApp Unofficial seperti pesan tombol atau list). Teks body ada di content; bagian template lainnya ada di sini:

Code
{
  "event": "message.received",
  "created_at": "2026-10-13T09:15:02Z",
  "data": {
    "message_id": "5d7e9f1a-2b3c-4d5e-8f90-a1b2c3d4e5f6",
    "conversation_id": "b6e2a2b0-9b21-4b6a-8b7a-9d3f6c1a2e10",
    "external_message_id": "3EB0A1B2C3D4E5F60718",
    "type": "TEMPLATE",
    "content": "Hi Sarah, your order #INV-2291 has been shipped.",
    "timestamp": "2026-10-13T09:15:00Z",
    "sender": { "type": "CONTACT", "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789", "name": "Toko Sepatu" },
    "contact": { "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789", "name": "Toko Sepatu", "phone": "6281234567890" },
    "template": {
      "type": "template",
      "header_media_url": "https://files.chatmo.io/chat/2026/10/13/header_19ab.jpg",
      "components": [
        { "type": "HEADER", "format": "IMAGE", "media_url": "https://files.chatmo.io/chat/2026/10/13/header_19ab.jpg" },
        { "type": "FOOTER", "text": "Reply STOP to unsubscribe" },
        {
          "type": "BUTTONS",
          "buttons": [
            { "type": "URL", "text": "Track order", "url": "https://example.com/track/INV-2291" },
            { "type": "QUICK_REPLY", "text": "Contact seller" }
          ]
        }
      ]
    }
  }
}

button_reply

Ada saat kontak mengklik tombol quick-reply, tombol interaktif, atau baris list (WhatsApp Official dan Unofficial). type bernilai TEXT dan content berisi label tombolnya.

Code
"button_reply": {
  "type": "quick_reply",
  "text": "Yes, confirm my order",
  "payload": "CONFIRM_ORDER"
}

type bernilai quick_reply (tombol template), button_reply (tombol interaktif) atau list_reply (baris list, yang juga membawa description). payload adalah ID yang Anda pasang di tombol tersebut.

reply_to

Ada saat kontak membalas (mengutip) pesan sebelumnya.

Code
"reply_to": {
  "message_id": "7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "external_message_id": "wamid.HBgLNjI4MjE0MTAwMDE="
}

message_id diisi jika pesan yang dikutip dikenali Chatmo; external_message_id adalah ID pesan tersebut di channel.

referral

Ada di pesan pertama dari chat yang dimulai dari iklan Click-to-WhatsApp atau iklan / post Instagram.

Code
"referral": {
  "source_type": "ad",
  "source_id": "120208000000000001",
  "source_url": "https://fb.me/3abcDEF",
  "ctwa_clid": "ARAkLmN0pQrStUvWxYz",
  "headline": "Free shipping this week",
  "body": "Chat with us to order",
  "media_type": "image",
  "thumbnail_cdn_url": "https://files.chatmo.io/ctwa/2026/10/13/ad_120208.jpg"
}

call

Ada untuk CALL_REQUEST dan CALL_ENDED (WhatsApp Official calling): snapshot panggilan, misalnya call_id, direction, status dan duration_seconds. Lihat call.status_updated untuk status panggilan secara live.

Raw payload tiap channel

Semua yang di atas sudah ada di data pada setiap channel, jadi sebagian besar integrasi tidak butuh raw_payload. Aktifkan hanya jika Anda butuh field khusus provider yang tidak ada di data. Untuk media, raw payload berisi referensi file milik provider sendiri, yang cara pakainya berbeda per channel:

Di bawah ini satu contoh raw_payload per channel: pesan TEXT (kasus paling sederhana) dan pesan IMAGE (untuk menunjukkan referensi media-nya). Jenis konten lain (VIDEO, DOCUMENT, LOCATION, CONTACT) mengikuti bentuk objek yang sama dengan field bersarang yang berbeda; tabel referensi di bawah tiap channel mencantumkan nama field-nya.

WhatsApp Official

Dibungkus dalam envelope webhook lengkap milik Meta — object → entry → changes → value — persis seperti referensi webhook resmi Meta, dipersempit hanya untuk satu pesan yang memicu delivery ini (entry/changes masing-masing hanya punya satu elemen).

Code
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102938475610293",
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550000001",
              "phone_number_id": "106540000000001"
            },
            "contacts": [
              { "profile": { "name": "Sarah Wijaya" }, "wa_id": "6281234567890" }
            ],
            "messages": [
              {
                "from": "6281234567890",
                "id": "wamid.HBgLNjI4MjE0MTAwMDA=",
                "timestamp": "1757999999",
                "type": "text",
                "text": { "body": "Hi, is this product still available?" }
              }
            ]
          }
        }
      ]
    }
  ]
}

Code
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102938475610293",
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550000001",
              "phone_number_id": "106540000000001"
            },
            "contacts": [
              { "profile": { "name": "Sarah Wijaya" }, "wa_id": "6281234567890" }
            ],
            "messages": [
              {
                "from": "6281234567890",
                "id": "wamid.HBgLNjI4MjE0MTAwMDE=",
                "timestamp": "1757999999",
                "type": "image",
                "image": {
                  "id": "1029384756102938",
                  "mime_type": "image/jpeg",
                  "sha256": "a1b2c3...",
                  "caption": "Is this the one you have in stock?",
                  "url": "https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=...&ext=...&hash=..."
                }
              }
            ]
          }
        }
      ]
    }
  ]
}

:::tip Chatmo merekonstruksi ini, bukan meneruskan byte asli dari Meta Meta mengelompokkan beberapa pesan/status dalam satu panggilan webhook (value.messages bisa berisi lebih dari satu elemen). Chatmo sudah memecah satu batch menjadi satu delivery per pesan sebelum sampai ke endpoint Anda, jadi raw_payload membangun ulang struktur object/entry/changes/value yang sama seperti yang didokumentasikan Meta, hanya untuk satu pesan tersebut — akurat field demi field, tapi bukan salinan byte-per-byte dari apa yang benar-benar dikirim Meta (field metadata yang disertakan Meta tapi tidak disimpan Chatmo akan kosong, bukan dikarang). :::

WhatsApp Unofficial

Code
{
  "event": "message.received",
  "device_id": "device-0f3a9c21",
  "partner_id": "partner-001",
  "timestamp": 1757999999,
  "data": {
    "chat": "[email protected]",
    "sender": "[email protected]",
    "message_id": "3EB0C767D26A1D4E5F6A",
    "sender_name": "Sarah Wijaya",
    "message_type": "TEXT",
    "text": "Hi, is this product still available?"
  }
}

Code
{
  "event": "message.received",
  "device_id": "device-0f3a9c21",
  "partner_id": "partner-001",
  "timestamp": 1757999999,
  "data": {
    "chat": "[email protected]",
    "sender": "[email protected]",
    "message_id": "3EB0C767D26A1D4E5F6B",
    "sender_name": "Sarah Wijaya",
    "message_type": "IMAGE",
    "caption": "Is this the one you have in stock?",
    "media_url": "https://files.chatmo.io/media/9c1a2b3d.jpg",
    "mimetype": "image/jpeg",
    "file_length": 184320
  }
}

Telegram

Code
{
  "update_id": 100000001,
  "message": {
    "message_id": 1001,
    "from": { "id": 123456789, "is_bot": false, "first_name": "Sarah", "last_name": "Wijaya" },
    "chat": { "id": 123456789, "type": "private" },
    "date": 1757999999,
    "text": "Hi, is this product still available?"
  }
}

Code
{
  "update_id": 100000002,
  "message": {
    "message_id": 1002,
    "from": { "id": 123456789, "is_bot": false, "first_name": "Sarah", "last_name": "Wijaya" },
    "chat": { "id": 123456789, "type": "private" },
    "date": 1757999999,
    "caption": "Is this the one you have in stock?",
    "photo": [
      { "file_id": "AgACAgEAAxkBTEST0001", "file_unique_id": "AQAD9BgA", "width": 1280, "height": 960, "file_size": 184320 }
    ]
  }
}

Facebook Messenger

Dibungkus dalam bentuk resmi Messenger Platform milik Meta — object: "page" → entry[] → messaging[] — lihat referensi webhook Messenger Meta. entry/messaging masing-masing hanya punya satu elemen, alasan yang sama seperti WhatsApp Official di atas.

Code
{
  "object": "page",
  "entry": [
    {
      "id": "1000000000000002",
      "time": 1757999999000,
      "messaging": [
        {
          "sender": { "id": "1000000000000001" },
          "recipient": { "id": "1000000000000002" },
          "timestamp": 1757999999000,
          "message": {
            "mid": "m_AbCdEfGhIjKlMnOpQrSt",
            "text": "Hi, is this product still available?"
          }
        }
      ]
    }
  ]
}

Code
{
  "object": "page",
  "entry": [
    {
      "id": "1000000000000002",
      "time": 1757999999000,
      "messaging": [
        {
          "sender": { "id": "1000000000000001" },
          "recipient": { "id": "1000000000000002" },
          "timestamp": 1757999999000,
          "message": {
            "mid": "m_AbCdEfGhIjKlMnOpQrSu",
            "attachments": [
              { "type": "image", "payload": { "url": "https://scontent.xx.fbcdn.net/v/....jpg" } }
            ]
          }
        }
      ]
    }
  ]
}

Tidak ada tipe pesan LOCATION atau CONTACT — Messenger Platform tidak mengirimkannya sebagai pesan masuk.

Instagram

Kontrak Messenger Platform yang sama dengan Facebook, nama field identik — tapi perhatikan body level teratas berupa JSON array, bukan objek biasa, sesuai referensi webhook Instagram Meta:

Code
[
  {
    "object": "instagram",
    "entry": [
      {
        "id": "1790293746510294",
        "time": 1757999999000,
        "messaging": [
          {
            "sender": { "id": "1780293746510293" },
            "recipient": { "id": "1790293746510294" },
            "timestamp": 1757999999000,
            "message": {
              "mid": "aWdfZAG1YQVZAERQVzVBaEFURVN…",
              "text": "Hi, is this product still available?"
            }
          }
        ]
      }
    ]
  }
]

Code
[
  {
    "object": "instagram",
    "entry": [
      {
        "id": "1790293746510294",
        "time": 1757999999000,
        "messaging": [
          {
            "sender": { "id": "1780293746510293" },
            "recipient": { "id": "1790293746510294" },
            "timestamp": 1757999999000,
            "message": {
              "mid": "aWdfZAG1YQVZAERQVzVBaEZAURVOU…",
              "attachments": [
                { "type": "image", "payload": { "url": "https://scontent.cdninstagram.com/v/....jpg" } }
              ]
            }
          }
        ]
      }
    ]
  }
]

Tidak ada tipe pesan LOCATION atau CONTACT, sama seperti Facebook.

message.sent

Code
{
  "event": "message.sent",
  "created_at": "2026-09-16T10:00:06Z",
  "data": {
    "message_id": "7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "conversation_id": "b6e2a2b0-9b21-4b6a-8b7a-9d3f6c1a2e10",
    "external_message_id": "wamid.HBgLNjI4MjE0MTAwMDE=",
    "type": "DOCUMENT",
    "content": "Here is the price list you asked for.",
    "timestamp": "2026-09-16T10:00:05Z",
    "status": "sent",
    "sender": {
      "type": "AGENT",
      "id": "c4d5e6f7-8a9b-0c1d-2e3f-4a5b6c7d8e9f",
      "name": "Rina Agent"
    },
    "contact": {
      "id": "8a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "Sarah Wijaya",
      "phone": "6281234567890"
    },
    "media": {
      "id": "0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
      "url": "https://files.chatmo.io/chat/2026/09/16/price-list-2026.pdf",
      "file_name": "price-list-2026.pdf",
      "mime_type": "application/pdf",
      "file_size": 248112,
      "caption": "Here is the price list you asked for."
    }
  }
}

Bentuk data sama dengan message.received: field yang sama dan block khusus per tipe yang sama (media, location, template, reply_to, ...). Template yang Anda kirim dari Chatmo membawa block template lengkap (name, language, category, components, variables). Perbedaannya:

message.sent hanya membawa raw_payload untuk sent_via: "device" (echo yang diterima Chatmo dari WhatsApp). Pengiriman lainnya dilakukan oleh Chatmo sendiri, jadi tidak ada payload provider. Catatan internal (pesan private) tidak pernah memicu message.sent.

message.status.delivered / .read / .sent / .failed

Code
{
  "event": "message.status.delivered",
  "created_at": "2026-09-16T10:00:08Z",
  "data": {
    "message_id": "7c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "external_message_id": "wamid.HBgLNjI4MjE0MTAwMDE=",
    "conversation_id": "b6e2a2b0-9b21-4b6a-8b7a-9d3f6c1a2e10",
    "status": "delivered"
  }
}

status mengikuti akhiran nama event (sent, delivered, read, failed). Hanya untuk WhatsApp Official dan WhatsApp Unofficial.

Code
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102938475610293",
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": { "phone_number_id": "106540000000001" },
            "statuses": [
              {
                "id": "wamid.HBgLNjI4MjE0MTAwMDE=",
                "status": "delivered",
                "timestamp": "1757999999",
                "recipient_id": "6281234567890"
              }
            ]
          }
        }
      ]
    }
  ]
}

Code
{
  "event": "message.delivered",
  "device_id": "device-0f3a9c21",
  "partner_id": "partner-001",
  "timestamp": 1757999999,
  "data": {
    "chat": "[email protected]",
    "sender": "[email protected]",
    "message_ids": ["3EB0C767D26A1D4E5F6A"]
  }
}

message.reaction.added / .removed

Code
{
  "event": "message.reaction.added",
  "created_at": "2026-09-16T10:01:00Z",
  "data": {
    "message_id": "3f9c9d2a-6b7e-4d1a-9c2b-1a2b3c4d5e6f",
    "conversation_id": "b6e2a2b0-9b21-4b6a-8b7a-9d3f6c1a2e10",
    "emoji": "👍",
    "reactor": {
      "id": "+6281234567890",
      "name": "Sarah Wijaya",
      "type": "CONTACT"
    }
  }
}

emoji berupa string kosong pada message.reaction.removed. reactor.type adalah CONTACT, AGENT, atau AI_AGENT. raw_payload hanya ada jika yang bereaksi adalah kontak — reaksi dari agen tidak punya payload provider masuk yang bisa dilampirkan, alasan yang sama seperti message.sent.

Code
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102938475610293",
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15550000001",
              "phone_number_id": "106540000000001"
            },
            "contacts": [
              { "profile": { "name": "Sarah Wijaya" }, "wa_id": "6281234567890" }
            ],
            "messages": [
              {
                "from": "6281234567890",
                "id": "wamid.HBgLNjI4MjE0MTAwMDM=",
                "timestamp": "1757999999",
                "type": "reaction",
                "reaction": { "message_id": "wamid.HBgLNjI4MjE0MTAwMDA=", "emoji": "👍" }
              }
            ]
          }
        }
      ]
    }
  ]
}

Code
{
  "event": "message.reaction",
  "device_id": "device-0f3a9c21",
  "partner_id": "partner-001",
  "timestamp": 1757999999,
  "data": {
    "chat": "[email protected]",
    "sender": "[email protected]",
    "reaction_target_message_id": "3EB0C767D26A1D4E5F6A",
    "reaction_emoji": "👍"
  }
}

Code
{
  "chat": { "id": 123456789, "type": "private" },
  "message_id": 1001,
  "user": { "id": 123456789, "is_bot": false, "first_name": "Sarah", "last_name": "Wijaya" },
  "date": 1757999999,
  "old_reaction": [],
  "new_reaction": [{ "type": "emoji", "emoji": "👍" }]
}

Code
{
  "object": "page",
  "entry": [
    {
      "id": "1000000000000002",
      "time": 1757999999000,
      "messaging": [
        {
          "sender": { "id": "1000000000000001" },
          "recipient": { "id": "1000000000000002" },
          "timestamp": 1757999999000,
          "reaction": { "action": "react", "emoji": "👍", "reaction": "like", "mid": "m_AbCdEfGhIjKlMnOpQrSt" }
        }
      ]
    }
  ]
}

Code
[
  {
    "object": "instagram",
    "entry": [
      {
        "id": "1790293746510294",
        "time": 1757999999000,
        "messaging": [
          {
            "sender": { "id": "1780293746510293" },
            "recipient": { "id": "1790293746510294" },
            "timestamp": 1757999999000,
            "reaction": { "action": "react", "emoji": "👍", "reaction": "like", "mid": "aWdfTEST0001" }
          }
        ]
      }
    ]
  }
]

conversation.assigned

Code
{
  "event": "conversation.assigned",
  "created_at": "2026-09-16T10:02:00Z",
  "data": {
    "conversation_id": "b6e2a2b0-9b21-4b6a-8b7a-9d3f6c1a2e10",
    "assigned_to": {
      "type": "USER",
      "id": "c4d5e6f7-8a9b-0c1d-2e3f-4a5b6c7d8e9f"
    }
  }
}

assigned_to.type adalah USER atau TEAM. Ini adalah aksi internal Chatmo — tidak pernah menyertakan raw_payload.

conversation.resolved

Code
{
  "event": "conversation.resolved",
  "created_at": "2026-09-16T10:15:00Z",
  "data": {
    "conversation_id": "b6e2a2b0-9b21-4b6a-8b7a-9d3f6c1a2e10",
    "resolved_by": {
      "id": "c4d5e6f7-8a9b-0c1d-2e3f-4a5b6c7d8e9f"
    }
  }
}

resolved_by tidak disertakan jika percakapan di-resolve secara otomatis (AI atau Workflow), bukan oleh agen manusia. Ini juga aksi internal Chatmo — tidak pernah menyertakan raw_payload.

template.status_updated

Code
{
  "event": "template.status_updated",
  "created_at": "2026-09-16T09:00:00Z",
  "data": {
    "template_name": "order_confirmation",
    "language": "en",
    "status": "APPROVED"
  }
}

Khusus WhatsApp Official. status mengikuti status review template Meta (APPROVED, REJECTED, PAUSED, DISABLED, PENDING_DELETION, IN_APPEAL, PENDING).

Code
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102938475610293",
      "changes": [
        {
          "field": "message_template_status_update",
          "value": {
            "event": "APPROVED",
            "message_template_id": 1000000000000001,
            "message_template_name": "order_confirmation",
            "message_template_language": "en"
          }
        }
      ]
    }
  ]
}

call.status_updated

Code
{
  "event": "call.status_updated",
  "created_at": "2026-09-16T09:30:00Z",
  "data": {
    "call_id": "d5e6f7a8-9b0c-1d2e-3f4a-5b6c7d8e9f0a",
    "status": "MISSED"
  }
}

Khusus WhatsApp Official. status salah satu dari RINGING, IN_PROGRESS, COMPLETED, MISSED, NO_ANSWER, REJECTED, CANCELED, FAILED.

Code
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "102938475610293",
      "changes": [
        {
          "field": "calls",
          "value": {
            "messaging_product": "whatsapp",
            "calls": [
              {
                "id": "wacid.TEST0001",
                "to": "6281234567890",
                "from": "6281111111111",
                "event": "terminate",
                "timestamp": "1757999999",
                "direction": "USER_INITIATED",
                "status": "MISSED"
              }
            ]
          }
        }
      ]
    }
  ]
}