สถิติข้อความ

messages:list

แสดงรายการข้อความที่ส่งไป

POST https://api.pushwoosh.com/api/v2/messages:list

Headers

ชื่อ	จำเป็น	คำอธิบาย
`Authorization`	ใช่	Server API token ต้องระบุในรูปแบบต่อไปนี้: `Authorization: Api <Server Key>`

พารามิเตอร์ใน Request body

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
`platforms`	ไม่	Array	แพลตฟอร์มข้อความ ค่าที่เป็นไปได้: `"IOS"`, `"ANDROID"`, `"OSX"`, `"WINDOWS"`, `"AMAZON"`, `"SAFARI"`, `"CHROME"`, `"FIREFOX"`, `"IE"`, `"EMAIL"`, `"HUAWEI_ANDROID"`, `"SMS"`
`date_range`	ไม่	Object	ช่วงเวลาการรายงาน `date_from` และ `date_to` ต้องเป็นรูปแบบ `YYYY-MM-DD` (เช่น `"2000-01-01"`)
`campaign`	ไม่	String	รหัสแคมเปญ
`filters`	ใช่	Object	ตัวกรองข้อความ
`source`	ไม่	String	แหล่งที่มาของข้อความ ตัวอย่างเช่น: `AB_TEST`, `API`, `AUTO_PUSH`, `CP`, `CSV`, `CUSTOMER_JOURNEY`, `EMAIL_API`, `EMAIL_CP`, `GEO_ZONE`, `PUSH_ON_EVENT`, `RSS`
`messages_codes`	ไม่	Array	รหัสข้อความ ที่ได้รับจาก response ของ API `/createMessage`
`messages_ids`	ไม่	Array	ID ของข้อความที่ได้รับจาก Message History
`params`	ไม่	Object	ระบุว่าจะแสดงรายละเอียดและ metrics ของข้อความหรือไม่ ตั้งค่า `with_details: true` เพื่อรวม object `"details"` และ `with_metrics: true` เพื่อรวม object `"metrics"` ใน response
`application`	ใช่	String	รหัสแอปพลิเคชัน Pushwoosh
`per_page`	ไม่	Integer	จำนวนผลลัพธ์ต่อหน้า (≤ 1000)
`page`	ไม่	Integer	หมายเลขหน้าสำหรับการแบ่งหน้า

ตัวอย่าง Request

{
    "filters": {
      "platforms": [],                  // IOS, ANDROID, OSX, WINDOWS, AMAZON, SAFARI, CHROME, FIREFOX, IE, EMAIL, HUAWEI_ANDROID, SMS
      "date_range": {
        "date_from": "string",          // รูปแบบที่กำหนด: 2000-01-01
        "date_to": "string"             // รูปแบบที่กำหนด: 2000-01-01
      },
      "source": "API",                  // AB_TEST, API, AUTO_PUSH, CP, CSV, CUSTOMER_JOURNEY, EMAIL_API, EMAIL_CP, GEO_ZONE, PUSH_ON_EVENT, RSS
      "campaign": "string",             // รหัสแคมเปญ
      "messages_ids": [],               // ID ของข้อความ
      "messages_codes": [],             // รหัสข้อความ
      "application": "string"           // รหัสแอปพลิเคชัน Pushwoosh
    },
    "params": {
      "with_details": true,             // เพิ่มรายละเอียดข้อความใน response (object "details")
      "with_metrics": true              // เพิ่ม metrics ของข้อความใน response (object "metrics")
    },
    "per_page": 20,                     // <= 1000
    "page": 0
}

รหัส Response และตัวอย่าง

{
  "total": 0,
  "items": [{
    "id": 0,
    "code": "string",
    "created_date": "string",
    "send_date": "string",
    "status": "string",
    "platforms": [],
    "source": "string",
    "push_info": {
      "details": {
        "title": "string",
        "filter_name": "string",
        "filter_code": "string",
        "content": {
          "key": "value"
        },
        "platform_parameters": {
          "android_header": "string",
          "android_root_params": {
            "key": "value"
          },
          "ios_title": "string",
          "ios_subtitle": "string",
          "ios_root_params": {
            "key": "value"
          },
          "chrome_header": "string",
          "chrome_root_params": {
            "key": "value"
          },
          "firefox_header": "string",
          "firefox_root_params": {
            "key": "value"
          },
          "conditions": [               // เงื่อนไข tag (ดู /developer/api-reference/messages-api/#tag-conditions)
            TAG_CONDITION1,
            TAG_CONDITION2,
            ...,
            TAG_CONDITIONN
          ],
          "conditions_operator": "AND", // ตัวดำเนินการทางตรรกะสำหรับ array เงื่อนไข; ค่าที่เป็นไปได้: AND, OR
          "data": {
            "key": "value"
          }
        },
        "follow_user_timezone": true
      },
      "metrics": [{
        "sends": 0,
        "opens": 0,
        "deliveries": 0,
        "inbox_opens": 0,
        "unshowable_sends": 0,
        "errors": 0,
        "platform": 0
      }]
    },
    "email_info": {
      "details": {
        "template": "string",
        "filter_name": "string",
        "filter_code": "string",
        "subject": {
          "key": "value"
        },
        "from_name": "string",
        "from_email": "string",
        "reply_name": "string",
        "reply_email": "string",
        "follow_user_timezone": true,
        "conditions": [              // เงื่อนไข tag (ดู Messages-api - tag-conditions)
          TAG_CONDITION1,
          TAG_CONDITION2,
          ...,
          TAG_CONDITIONN
        ],
        "conditions_operator": "AND" // ตัวดำเนินการทางตรรกะสำหรับ array เงื่อนไข; ค่าที่เป็นไปได้: AND, OR
      },
      "metrics": [{
        "sends": 0,
        "opens": 0,
        "deliveries": 0,
        "hard_bounces": 0,
        "soft_bounces": 0,
        "rejects": 0,
        "confirmed_sends": 0,
        "unsubs": 0,
        "complaints": 0,
        "errors": 0
      }]
    }
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

totalsByIntervals

คืนค่า metrics และข้อมูล conversion ตามรหัสข้อความ โดยรวบรวมข้อมูลรายชั่วโมง

POST https://api.pushwoosh.com/api/v2/statistics/messages/totalsByIntervals

Authorization

การอนุญาตจัดการผ่าน API Access Token ใน header ของ request

พารามิเตอร์ใน Request body

ชื่อพารามิเตอร์	ประเภท	คำอธิบาย	จำเป็น
`message_code`	string	รหัสข้อความ ที่ได้รับจาก response ของ API `/createMessage`	ใช่
`platforms`	[int]	แพลตฟอร์ม	ไม่

ตัวอย่าง Request

{
  "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // จำเป็น, ตัวระบุข้อความที่ไม่ซ้ำกัน
  "platforms": [1, 3, 7, 10, 11, 12]          // ไม่จำเป็น, รายการรหัสแพลตฟอร์ม
}

ฟิลด์ใน Response

ชื่อ	ประเภท	คำอธิบาย
`metrics`	array	ประกอบด้วย array ของ metrics ข้อความ
`timestamp`	string	เวลาของ metric
`platform`	int	รหัสแพลตฟอร์ม (เช่น iOS, Android)
`sends`	string	จำนวนข้อความที่ส่ง
`opens`	string	จำนวนข้อความที่เปิด
`deliveries`	string	จำนวนข้อความที่ส่งถึงผู้รับ
`inbox_opens`	string	จำนวนการเปิดใน Inbox
`unshowable_sends`	string	จำนวนข้อความที่ส่งไปแต่ไม่สามารถแสดงผลได้
`errors`	string	จำนวนข้อผิดพลาด
`conversion`	object	ประกอบด้วยข้อมูล conversion
`sends`	string	จำนวนรวมของข้อความที่ส่ง
`opens`	string	จำนวนรวมของข้อความที่เปิด
`events`	array	Array ของ events พร้อมสถิติ
`name`	string	ชื่อของ event (เช่น cart add)
`hits`	string	จำนวน hits
`conversion`	float	อัตรา conversion เทียบกับการเปิด
`revenue`	float	รายได้ (เฉพาะ events ที่มี attribute `__amount` และ `__currency`)

ตัวอย่าง Response

{
  "metrics": [{
    "timestamp": "2024-08-03 15:00:00",  // Timestamp ของ metrics ในรูปแบบ "YYYY-MM-DD HH:MM:SS"
    "platform": 3,                       // รหัสแพลตฟอร์ม
    "sends": "55902",                    // จำนวนข้อความที่ส่ง
    "opens": "382",                      // จำนวนข้อความที่เปิด
    "deliveries": "22931",               // จำนวนข้อความที่ส่งถึงผู้รับ
    "inbox_opens": "0",                  // จำนวนข้อความที่เปิดใน Inbox
    "unshowable_sends": "2",             // จำนวนข้อความที่ไม่สามารถแสดงผลได้
    "errors": "0"                        // จำนวนข้อผิดพลาดที่พบ
  }],
  "conversion": {
    "sends": "55902",                    // จำนวนรวมของข้อความที่ส่ง
    "opens": "772",                      // จำนวนรวมของข้อความที่เปิด
    "events": [{
      "name": "cart_add",                // ชื่อของ event
      "hits": "96",                      // จำนวน hits สำหรับ event
      "conversion": 0.12,                // อัตรา conversion เทียบกับการเปิด
      "revenue": 0                       // รายได้ที่เกิดจาก event (เฉพาะ events ที่มี attribute amount/currency)
    }]
  }
}

getMessageLog

แสดงข้อมูลโดยละเอียดเกี่ยวกับข้อความที่ส่งไป

POST https://api.pushwoosh.com/api/v2/statistics/getMessageLog

Headers

ชื่อ	จำเป็น	คำอธิบาย
`Authorization`	จำเป็น	API access token จาก Pushwoosh Control Panel

พารามิเตอร์ใน Request body

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
`message_id`	ไม่	Integer	เลือก events ของข้อความตาม Message ID ที่ได้รับจากประวัติข้อความ ตัวอย่าง: `12345678900`
`message_code`	ไม่	String	เลือก events ของข้อความตาม รหัสข้อความ ที่ได้รับจาก response ของ API `/createMessage` ตัวอย่าง: `"A444-AAABBBCC-00112233"`
`campaign_code`	ไม่	String	เลือก events ของข้อความตาม รหัสแคมเปญ ที่ระบุใน payload ของข้อความ ตัวอย่าง: `"AAAAA-XXXXX"`
`hwid`	ไม่	String หรือ Array	เลือก events ของข้อความตาม HWID (Hardware ID) หรือ array ของ HWID
`date_from`	จำเป็นหากไม่ระบุ `message_id`, `message_code` หรือ `campaign_code`	Datetime	วันที่เริ่มต้นสำหรับการกรองข้อความ รูปแบบ: `"YYYY-MM-DD HH:MM:SS"` ตัวอย่าง: `"2000-01-25 00:00:00"`
`date_to`	จำเป็นหากไม่ระบุ `message_id`, `message_code` หรือ `campaign_code`	Datetime	วันที่สิ้นสุดสำหรับการกรองข้อความ รูปแบบ: `"YYYY-MM-DD HH:MM:SS"` ตัวอย่าง: `"2000-01-26 00:00:00"`
`limit`	ไม่	Integer	จำนวนสูงสุดของ events ข้อความที่ส่งคืนใน response เดียว ค่าสูงสุด: `100000`
`pagination_token`	ไม่	String	Token สำหรับการแบ่งหน้าที่ได้รับจาก response ของ `/getMessageLog` ก่อนหน้า ใช้เพื่อดึงผลลัพธ์เพิ่มเติม
`user_id`	ไม่	String	เลือก events ของข้อความตาม User ID ที่กำหนดเอง ดูรายละเอียดเพิ่มเติมที่ `/registerUser`
`application_code`	ใช่	String	เลือก events ของข้อความตาม รหัสแอปพลิเคชัน Pushwoosh
`actions`	ไม่	Array	กรองผลลัพธ์ตามการกระทำของข้อความที่ระบุ ค่าที่เป็นไปได้: `"sent"`, `"delivered"`, `"opened"`, `"inbox_delivered"`, `"inbox_read"`, `"inbox_opened"`, `"inbox_deleted"`
`platforms`	ไม่	Array	Array ของแพลตฟอร์มเป้าหมายเพื่อกรองผลลัพธ์ ค่าที่เป็นไปได้: `"ios"`, `"android"`, `"osx"`, `"windows"`, `"amazon"`, `"safari"`, `"chrome"`, `"firefox"`, `"ie"`, `"email"`, `"huawei_android"`

ตัวอย่าง Request

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/getMessageLog' \
--header 'Authorization: Key API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "pagination_token": "PAGINATION_TOKEN_FROM_PREVIOUS_RESPONSE",  // ไม่จำเป็น, token สำหรับการแบ่งหน้า
   "limit": 1000,                                  // ไม่จำเป็น, จำนวนรายการสูงสุดสำหรับ response เดียว
   "application_code": "XXXXX-XXXXX",              // รหัสแอป Pushwoosh
   "message_code": "A444-AAABBBCC-00112233",       // ไม่จำเป็น, รหัสข้อความที่ได้รับจาก request /createMessage
   "message_id": 1234567890,                       // ไม่จำเป็น, Message ID ที่ได้รับจาก Pushwoosh Control Panel
   "campaign_code": "AAAAA-XXXXX",                 // ไม่จำเป็น, รหัสของแคมเปญที่จะดึง log
   "hwid": "aaazzzqqqqxxx",                        // ไม่จำเป็น, hardware ID ของอุปกรณ์เฉพาะที่เป็นเป้าหมายของข้อความ
   "user_id": "user_123",                          // ไม่จำเป็น, ID ของผู้ใช้ที่เป็นเป้าหมายของข้อความ
   "date_from": "2000-01-25 00:00:00",             // ไม่จำเป็น, เริ่มต้นช่วงเวลาสถิติ
   "date_to": "2000-02-10 23:59:59",               // ไม่จำเป็น, สิ้นสุดช่วงเวลาสถิติ
   "actions": ["opened", "inbox_opened"],          // ไม่จำเป็น, ใช้สำหรับการกรองผลลัพธ์ ค่าที่เป็นไปได้: "sent", "opened", "delivered", "inbox_delivered", "inbox_read", "inbox_opened", "inbox_deleted" response จะรวมข้อความทั้งหมดที่มี action ตามที่ระบุ
   "platforms": ["ios", "chrome"]                  // ไม่จำเป็น, ใช้สำหรับการกรองผลลัพธ์ ค่าที่เป็นไปได้: "ios", "android", "osx", "windows", "amazon", "safari", "chrome", "firefox", "ie", "email", "huawei android"
}'

รหัส Response และตัวอย่าง

{
  "pagination_token": "PAGINATION_TOKEN_FOR_NEXT_REQUEST",
  "data": [{
    "timestamp": "2000-01-25T11:18:47Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "sent",
    "status": "success",
    "push_alerts_enabled": "true"
  }, {
    "timestamp": "2000-01-25T11:18:49Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "delivered",
    "push_alerts_enabled": "true"
  }, {
    "timestamp": "2000-01-25T11:19:23Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "opened",
    "push_alerts_enabled": "true"
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

Email statistics

linksInteractions

แสดงสถิติการคลิกลิงก์ในอีเมล

POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions

Headers

ชื่อ	จำเป็น	คำอธิบาย
`Authorization`	ใช่	API access token จาก Pushwoosh Control Panel

พารามิเตอร์ใน Request body

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
`date_range`	ไม่	Object	กำหนดช่วงเวลาการรายงาน ประกอบด้วย `date_from` และ `date_to`
`filters`	ใช่	Object	ตัวกรองอีเมล
`application`	ใช่	String	รหัสแอปพลิเคชัน Pushwoosh (หรือระบุ `campaign`, `messages_ids` หรือ `message_codes` แทน)
`messages_codes`	ใช่	Array	รหัสข้อความ (หรือระบุ `application`, `campaign` หรือ `messages_ids` แทน)
`campaign`	ใช่	String	รหัสแคมเปญ (หรือระบุ `application`, `messages_ids` หรือ `message_codes` แทน)
`messages_ids`	ใช่	Array	ID ของข้อความ (หรือระบุ `application`, `campaign` หรือ `message_codes` แทน)
`link_template`	จำเป็นหากระบุ `application` หรือ `campaign`	String	กรองการโต้ตอบกับลิงก์อีเมลด้วยคำหลัก เฉพาะลิงก์ที่มีข้อความที่ระบุอยู่ใน URL เท่านั้นที่จะถูกส่งคืนใน response ของ API ตัวอย่างเช่น หากอีเมลของคุณมีลิงก์เช่น `https://example.com/news` และ `https://example.com/shop` การตั้งค่า “link_template”: “shop” จะส่งคืนการโต้ตอบสำหรับ `https://example.com/shop` เท่านั้น
`email_content_code`	ไม่	String	ตัวระบุเฉพาะสำหรับเนื้อหาอีเมล
`params`	ไม่	Object	กำหนดตัวเลือก response เพิ่มเติม รวมถึง `with_full_links` ซึ่งจะเพิ่มรายการลิงก์แบบเต็มพร้อมสถิติ

ตัวอย่าง Request

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions' \
--header 'Authorization: Api API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "filters": {
      "date_range": {
         "date_from": "string",           // รูปแบบที่กำหนด: 2000-01-01
         "date_to": "string"              // รูปแบบที่กำหนด: 2000-01-01
      },
      "campaign": "string",               // รหัสแคมเปญ (คุณสามารถระบุ application, messages_ids หรือ message_codes แทนได้)
      "application": "string",            // รหัสแอปพลิเคชัน (คุณสามารถระบุ campaign, messages_ids หรือ message_codes แทนได้)
      "messages_ids": [],                 // ID ของข้อความ (คุณสามารถระบุ application, campaign หรือ message_codes แทนได้)
      "messages_codes": [],               // รหัสข้อความ (คุณสามารถระบุ application, campaign หรือ message_ids แทนได้)
      "link_template": "string",          // เทมเพลตลิงก์ (จำเป็นหากระบุ application หรือ campaign)
      "email_content_code": "string"      // ตัวระบุเฉพาะสำหรับเนื้อหาอีเมล
   },
   "params": {
      "with_full_links": true             // ระบุว่าจะแสดงสถิติโดยละเอียดหรือไม่ รายการลิงก์แบบเต็มพร้อมสถิติจะถูกส่งมาใน array full_links
   }
}'

รหัส Response และตัวอย่าง

{
  "items": [{
    "template": "string",
    "link": "string",
    "title": "string",
    "clicks": 0,
    "full_links": [{
      "full_link": "string",
      "clicks": 0
    }]
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

linksInteractionsDevices

แสดงผู้ใช้ที่คลิกลิงก์ในอีเมล

POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices

Headers

ชื่อ	จำเป็น	คำอธิบาย
`Authorization`	ใช่	API access token จาก Pushwoosh Control Panel

พารามิเตอร์ใน Request body

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
`date_range`	ไม่	Object	กำหนดช่วงเวลาการรายงาน ประกอบด้วย `date_from` และ `date_to`
`filters`	ใช่	Object	ตัวกรองอีเมล
`application`	ใช่	String	รหัสแอปพลิเคชัน Pushwoosh (หรือระบุ `campaign`, `messages_ids` หรือ `message_codes` แทน)
`messages_codes`	ใช่	Array	รหัสข้อความ (หรือระบุ `application`, `campaign` หรือ `messages_ids` แทน)
`campaign`	ใช่	String	รหัสแคมเปญ (หรือระบุ `application`, `messages_ids` หรือ `message_codes` แทน)
`messages_ids`	ใช่	Array	ID ของข้อความ (หรือระบุ `application`, `campaign` หรือ `message_codes` แทน)
`link_template`	จำเป็นหากระบุ `application` หรือ `campaign`	String	กรองการโต้ตอบกับลิงก์อีเมลด้วยคำหลัก เฉพาะลิงก์ที่มีข้อความที่ระบุอยู่ใน URL เท่านั้นที่จะถูกส่งคืนใน response ของ API ตัวอย่างเช่น หากอีเมลของคุณมีลิงก์เช่น `https://example.com/news` และ `https://example.com/shop` การตั้งค่า “link_template”: “shop” จะส่งคืนการโต้ตอบสำหรับ `https://example.com/shop` เท่านั้น
`email_content_code`	ไม่	String	ตัวระบุเฉพาะสำหรับเนื้อหาอีเมล
`page`	ไม่	Integer	หมายเลขหน้าสำหรับการแบ่งหน้า
`per_page`	ไม่	Integer	จำนวนผลลัพธ์ต่อหน้า (≤ 1000)

ตัวอย่าง Request

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices' \
--header 'Authorization: Api API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "filters": {
      "date_range": {
         "date_from": "string",         // รูปแบบที่กำหนด: 2000-01-01
         "date_to": "string"            // รูปแบบที่กำหนด: 2000-01-01
      },
      "campaign": "string",             // รหัสแคมเปญ (คุณสามารถระบุ application, messages_ids หรือ message_codes แทนได้)
      "application": "string",          // รหัสแอปพลิเคชัน (คุณสามารถระบุ campaign, messages_ids หรือ message_codes แทนได้)
      "messages_ids": [],               // ID ของข้อความ (คุณสามารถระบุ application, campaign หรือ message_codes แทนได้)
      "messages_codes": [],             // รหัสข้อความ (คุณสามารถระบุ application, campaign หรือ message_ids แทนได้)
      "link_template": "string",        // เทมเพลตลิงก์ (จำเป็นหากระบุ application หรือ campaign)
      "email_content_code": "string"    // ตัวระบุเฉพาะสำหรับเนื้อหาอีเมล
   },
   "per_page": 100,
   "page": 0
}'

รหัส Response และตัวอย่าง

{
  "total": 0,
  "items": [{
    "timestamp": "string",
    "link": "string",
    "hwid": "string"
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

bouncedEmails

POST https://api.pushwoosh.com/api/v2/statistics/emails/bouncedEmails

ให้ข้อมูลเกี่ยวกับการร้องเรียนทางอีเมล (complaints), soft bounces, และ hard bounces รวมถึงวันที่ ที่อยู่อีเมล และเหตุผลของการตีกลับแต่ละครั้ง

Authorization

การอนุญาตจัดการผ่าน API Access Token ใน header ของ request

พารามิเตอร์ใน Request body

ชื่อพารามิเตอร์	ประเภท	คำอธิบาย	จำเป็น
`application`	string	รหัสแอปพลิเคชัน Pushwoosh	ใช่
`message_code`	string	รหัสข้อความ	จำเป็นหากไม่ระบุ `date range` หรือ `campaign`
`campaign`	string	รหัสแคมเปญ	จำเป็นหากไม่ระบุ `message_code` หรือ `date range`
`date_from`	string	วันที่เริ่มต้นสำหรับข้อมูลในรูปแบบ `YYYY-MM-DDTHH:MM:SS.000Z` (มาตรฐาน ISO 8601)	จำเป็นหากไม่ระบุ `message_code` หรือ `campaign`
`date_to`	string	วันที่สิ้นสุดสำหรับข้อมูลในรูปแบบ `YYYY-MM-DDTHH:MM:SS.000Z` (มาตรฐาน ISO 8601)	จำเป็นหากไม่ระบุ `message_code` หรือ `campaign`
`per_page`	int	จำนวนแถวต่อหน้า สูงสุด 5000	ใช่
`page`	int	หมายเลขหน้า เริ่มต้นจากศูนย์	ใช่
`type`	string	ประเภทของการตีกลับ: Complaint, Softbounce, Hardbounce	ไม่

ตัวอย่าง Request

{
  "application": "XXXXX-XXXXX",               // จำเป็น, รหัสแอป Pushwoosh
  "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // จำเป็นหากไม่ระบุ campaign หรือ date range
                                              //          ตัวระบุข้อความที่ไม่ซ้ำกัน
  "campaign": "XXXXX-XXXXX",                  // จำเป็นหากไม่ระบุ message_code หรือ date range
                                              //          รหัสแคมเปญ
  "date_from": "2024-07-20T00:00:00.000Z",    // จำเป็นหากไม่ระบุ message_code หรือ campaign
                                              //          วันที่เริ่มต้นในรูปแบบ ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "date_to": "2024-07-20T00:00:00.000Z",      // จำเป็นหากไม่ระบุ message_code หรือ campaign
                                              //          วันที่สิ้นสุดในรูปแบบ ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "per_page": 1000,                           // จำเป็น, จำนวนผลลัพธ์ต่อหน้า สูงสุด 5000
  "page": 5,                                  // ไม่จำเป็น, หมายเลขหน้า เริ่มต้นจากศูนย์
  "type": "Softbounce"                        // ไม่จำเป็น, ประเภทของการตีกลับ: Complaint, Softbounce, Hardbounce
}

ฟิลด์ใน Response

ชื่อฟิลด์	ประเภท	คำอธิบาย
`total`	int	จำนวนแถวทั้งหมด
`bounced_emails`	array	Array ของรายละเอียดอีเมลที่ถูกตีกลับ
├── `email`	string	ที่อยู่อีเมลที่ถูกตีกลับ
├── `date`	string	วันที่ตีกลับ (รูปแบบ: `YYYY-MM-DDTHH:MM:SS.000Z`)
├── `reason`	string	เหตุผลของการตีกลับ
└── `type`	string	ประเภทของการตีกลับ: Complaint, Softbounce, Hardbounce

ตัวอย่าง Response

{
  "total": 25,                             // จำนวนแถวทั้งหมด
  "bounced_emails": [{
    "email": "example@example.com",        // ที่อยู่อีเมลที่ถูกตีกลับ
    "date": "2024-07-20T00:00:00.000Z",    // วันที่ตีกลับในรูปแบบ ISO 8601
    "reason": "Invalid recipient address", // เหตุผลของการตีกลับ
    "type": "Hardbounce"                   // ประเภทของการตีกลับ: Complaint, Softbounce, Hardbounce
  }]
}