Menandai Pesan Telah Dibaca (Read Receipt)

Endpoint ini digunakan untuk mengirimkan sinyal tanda baca (Read Receipt) ke Meta WhatsApp Cloud API. Menggunakan endpoint ini akan mengubah status pesan di aplikasi ponsel pelanggan Anda menjadi dua centang biru, yang menandakan bahwa pesan mereka telah dibaca oleh tim Anda.

🛜 1. HTTP Endpoint

POST /v1/messages/read (Memerlukan API Key & Whitelisted IP)

Headers:

• Authorization: Bearer <kirem_live_xxx> (Required)
• Content-Type: application/json

📦 2. Payload Request (JSON)

Anda wajib mengirimkan ID pesan yang ingin ditandai beserta ID saluran terkait:

{
  "message_id": "wamid.HBgLNjI4MTIzNDU2NzhGFgQ0NDMzMzc3RUQ1OEFG",
  "channel_id": "chan-123"
}

Parameter:

• message_id (String - Wajib): ID pesan WhatsApp (biasanya diawali wamid.) yang diterima dari webhook callback pelanggan Anda.
• channel_id (String - Wajib): ID saluran WhatsApp terdaftar di Kirem tempat pesan tersebut diterima.

🚦 3. Format Respons API

Respons Sukses (200 OK)

{
  "status": 200,
  "message": "Message marked as read successfully",
  "data": {
    "success": true
  }
}

Respons Gagal (400 Bad Request)

Terjadi jika format parameter salah atau data tidak sesuai.

{
  "status": 400,
  "message": "Invalid request payload",
  "errors": {
    "message_id": "message_id is required",
    "channel_id": "channel_id is required"
  }
}

Respons Gagal (404 Not Found)

Terjadi jika ID saluran tidak ditemukan atau tidak berada di bawah kepemilikan tenant Anda (Tenant Isolation).

{
  "status": 404,
  "message": "Channel not found",
  "errors": {
    "channel": "Channel either does not exist or does not belong to your project"
  }
}