Kirim Pesan Massal

Kirim pesan ke beberapa penerima sekaligus melalui WhatsApp.

Endpoint

POST /agent/messages

Request Headers

Header	Value	Deskripsi
Authorization	Bearer token	Token autentikasi yang diperoleh dari Profile Anda setelah login ke CMS
Content-Type	application/json	Menentukan format body request

Request Body

Parameter	Type	Required	Deskripsi
deviceID	String	Ya	ID perangkat WhatsApp untuk mengirim dari (contoh: "62851851xxxxxx")
phoneNumbers	Array	Ya	Array nomor telepon penerima dalam format internasional
message	String	Ya	Teks pesan yang akan dikirim ke semua penerima

Contoh Request

{
  "deviceID": "62851851xxxxxx", 
  "phoneNumbers": ["62896058xxxxx", "62895177xxxxx"],
  "message": "hello world 2"
}

Response

Success Response

{
  "status": true,
  "message": "Messages sent successfully",
  "data": {
    "batchId": "batch-12345678-abcd-1234-efgh-123456789012",
    "sentCount": 2,
    "timestamp": "2025-06-22T10:15:30.123Z",
    "details": [
      {
        "phoneNumber": "62896058xxxxx",
        "status": "sent",
        "messageId": "msg-12345-abc"
      },
      {
        "phoneNumber": "62895177xxxxx",
        "status": "sent",
        "messageId": "msg-67890-def"
      }
    ]
  }
}

Error Response

{
  "status": false,
  "message": "Error sending messages",
  "error": {
    "code": "ERROR_CODE",
    "details": "Additional error details"
  },
  "partialSuccess": {
    "sentCount": 1,
    "failedCount": 1,
    "details": [
      {
        "phoneNumber": "62896058xxxxx",
        "status": "sent",
        "messageId": "msg-12345-abc"
      },
      {
        "phoneNumber": "62895177xxxxx",
        "status": "failed",
        "error": "Invalid phone number"
      }
    ]
  }
}

Catatan Penggunaan

• Nomor telepon harus dalam format internasional tanpa tanda plus atau spasi
• Endpoint ini dioptimalkan untuk mengirim pesan yang sama ke beberapa penerima
• Jumlah penerima maksimum per request: 100
• Teks pesan mendukung format dasar
• Panjang pesan maksimum adalah 4096 karakter
• Lampiran media tidak didukung di endpoint ini (gunakan endpoint media khusus untuk keperluan tersebut)
• Untuk update status real-time pada pesan massal, gunakan message status webhook
• Untuk menerima balasan pelanggan, siapkan Webhook Device Bot