การส่งออกสถิติข้อความแบบอะซิงโครนัส

exportMessagesStatistics จะส่งออกประวัติและสถิติข้อความไปยังไฟล์ CSV บนเซิร์ฟเวอร์ ใช้สำหรับดึงข้อมูลจำนวนมากหรือข้อมูลทั้งบัญชีซึ่ง messages:list ไม่สามารถจัดการได้

เมื่อใดที่ควรใช้ export แทน messages:list

ใช้ messages:list สำหรับการค้นหาแบบสดและแบ่งหน้าในช่วงเวลาที่จำกัด ใช้ exportMessagesStatistics เมื่อผลลัพธ์จะเกินขีดจำกัดการแบ่งหน้าลึกของ messages:list (page × per_page > 100000) หรือเมื่อเป้าหมายคือไฟล์เดียวที่สามารถดาวน์โหลดได้แทนที่จะเป็น JSON แบบแบ่งหน้า การส่งออกไม่มีขีดจำกัดสำหรับ date_range หรือจำนวนแถว เนื่องจากจะสตรีมผลลัพธ์ไปยังไฟล์บนดิสก์แทนที่จะเก็บไว้ในการตอบกลับครั้งเดียว

ขั้นตอนการส่งออกทำงานอย่างไร

1. เรียกใช้ export ด้วยตัวกรองเดียวกับ messages:list การตอบกลับจะส่งคืนตัวระบุงาน uid ทันที ก่อนที่ไฟล์จะถูกสร้างขึ้น
2. ตรวจสอบ status ด้วย uid นั้นจนกว่าจะรายงาน STATUS_SUCCESS (หรือ STATUS_FAILED)
3. เรียกใช้ result ด้วย uid เดียวกันเพื่อรับ file ที่สร้างขึ้นและ file_url ที่พร้อมใช้งาน
4. ดาวน์โหลด ไฟล์ ใช้ file_url ตามที่เป็นอยู่ หรือดูที่ result สำหรับการสร้าง URL จาก file หากค่าที่ได้กลับมาว่างเปล่า

ใช้ lastTasks เพื่อค้นหางานส่งออกล่าสุดสำหรับแอปพลิเคชัน และ delete เพื่อยกเลิกงานหรือลบไฟล์ก่อนเวลา

เมธอด

วงจรชีวิตการส่งออกมีห้าเมธอด พร้อมด้วย endpoint สำหรับดาวน์โหลดโดยตรง:

เมธอด	คำอธิบาย
exportMessagesStatistics/export	จัดคิวการส่งออกและส่งคืน uid ของงาน
exportMessagesStatistics/status	ตรวจสอบความคืบหน้าของงาน
exportMessagesStatistics/result	ส่งคืนชื่อไฟล์ที่สร้างขึ้นเมื่องานเสร็จสิ้น
exportMessagesStatistics/lastTasks	แสดงรายการงานส่งออกล่าสุดสำหรับแอปพลิเคชัน
exportMessagesStatistics/delete	ยกเลิกงานหรือลบไฟล์ก่อนที่ระยะเวลาการเก็บรักษาจะหมดอายุ
ดาวน์โหลด	ดาวน์โหลดไฟล์ CSV ที่สร้างขึ้นตามชื่อ

export

จัดคิวการส่งออกประวัติข้อความและส่งคืนตัวระบุงานทันที

POST https://api.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/export

ส่วนหัว (Headers)

คำร้องขอนี้ต้องการ Server API token:

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

พารามิเตอร์ในส่วนเนื้อหาของคำร้องขอ (Request body)

ส่วนเนื้อหาของคำร้องขอยอมรับฟิลด์ต่อไปนี้:

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
type	ใช่	String	ต้องเป็น “TASK_TYPE_EXPORT_MESSAGES_V2”
export_messages_v2	ใช่	Object	พารามิเตอร์การส่งออก อธิบายไว้ด้านล่าง
export_messages_v2.application_code	ดูหมายเหตุ	String	รหัสแอปพลิเคชัน Pushwoosh จำเป็นหากไม่ได้ตั้งค่า app_group_code
export_messages_v2.app_group_code	ดูหมายเหตุ	String	รหัสกลุ่มแอปพลิเคชัน ส่งออกข้อมูลของทุกแอปในกลุ่ม จำเป็นหากไม่ได้ตั้งค่า application_code
export_messages_v2.search	ไม่	String	ค้นหาข้อความอิสระในชื่อและเนื้อหาของข้อความ
export_messages_v2.filters	ไม่	Object	ตัวกรองข้อความ อธิบายไว้ด้านล่าง ละเว้นเพื่อส่งออกประวัติทั้งหมดของบัญชี
export_messages_v2.properties	ไม่	Array	คอลัมน์ที่จะรวมใน CSV อธิบายไว้ด้านล่าง

export_messages_v2.filters ยอมรับ:

ชื่อ	ประเภท	คำอธิบาย
statuses	Array	สถานะข้อความที่จะรวม ค่าที่เป็นไปได้ ”MESSAGE_STATUS_CANCELED" "MESSAGE_STATUS_CREATING" "MESSAGE_STATUS_DONE" "MESSAGE_STATUS_FAIL" "MESSAGE_STATUS_PENDING" "MESSAGE_STATUS_PROCESSING" "MESSAGE_STATUS_WAITING”
platforms	Array	รหัสแพลตฟอร์ม (ตัวเลข เช่น 1 สำหรับ iOS) ไม่ใช่สตริงชื่อแพลตฟอร์มที่ใช้โดย messages:list
sent_date	Object	ช่วงเวลารายงานที่กรองตามวันที่ส่ง: {"date_from": "YYYY-MM-DD", "date_to": "YYYY-MM-DD"}
created_date	Object	ช่วงเวลารายงานที่กรองตามวันที่สร้างข้อความ รูปแบบเดียวกับ sent_date
created_via	Array	แหล่งที่มาของข้อความ ค่าที่เป็นไปได้ ”AB_TEST" "API" "AUTO_PUSH" "CP" "CSV" "CUSTOMER_JOURNEY" "EMAIL_API" "EMAIL_CP" "GEO_ZONE" "PUSH_ON_EVENT" "RSS" "SYSTEM”
segments	Array	รหัสตัวกรอง ที่ข้อความถูกส่งไป
campaigns	Array	รหัสแคมเปญ ซึ่งแตกต่างจาก messages:list ที่นี่จะรับเป็นรายการ ไม่ใช่รหัสเดียว
message_id	String (uint64)	ID ข้อความตัวเลขเดียว อยู่ในเครื่องหมายคำพูด ซึ่งแตกต่างจาก messages:list ที่การส่งออกจะรับ ID เดียว ไม่ใช่ array
message_code	String	รหัสข้อความ เดียว

export_messages_v2.properties จะเลือกว่า CSV จะมีคอลัมน์ใดบ้าง

ค่าที่เป็นไปได้

• "EXPORT_MESSAGE_PROPERTY_ID"
• "EXPORT_MESSAGE_PROPERTY_TIMESTAMP"
• "EXPORT_MESSAGE_PROPERTY_CONTENT"
• "EXPORT_MESSAGE_PROPERTY_TITLE"
• "EXPORT_MESSAGE_PROPERTY_APPLICATIONS"
• "EXPORT_MESSAGE_PROPERTY_STATUS"
• "EXPORT_MESSAGE_PROPERTY_PLATFORMS"
• "EXPORT_MESSAGE_PROPERTY_SOURCE"
• "EXPORT_MESSAGE_PROPERTY_FILTER"
• "EXPORT_MESSAGE_PROPERTY_SUBSCRIPTION_SEGMENTS"
• "EXPORT_MESSAGE_PROPERTY_SENT"
• "EXPORT_MESSAGE_PROPERTY_OPENED"
• "EXPORT_MESSAGE_PROPERTY_ERRORS"
• "EXPORT_MESSAGE_PROPERTY_RECIPIENTS"
• "EXPORT_MESSAGE_PROPERTY_DELIVERED"
• "EXPORT_MESSAGE_PROPERTY_TOTAL_DELIVERED"
• "EXPORT_MESSAGE_PROPERTY_TOTAL_OPENED"
• "EXPORT_MESSAGE_PROPERTY_TOTAL_CLICKS"
• "EXPORT_MESSAGE_PROPERTY_CLICKS"
• "EXPORT_MESSAGE_PROPERTY_UNSUBSCRIBED"

properties ไม่ใช่แค่ตัวกรอง

คุณสมบัติที่ไม่ได้ระบุใน properties จะไม่ปรากฏในไฟล์เลย รวมถึงคอลัมน์พื้นฐาน (ID, วันที่ส่ง, เนื้อหา, สถานะ) การปล่อยให้ properties ว่างจะทำให้ได้ CSV ที่ไม่มีคอลัมน์ โปรดระบุทุกคอลัมน์ที่การส่งออกควรมี ไม่ใช่แค่เมตริกที่คุณต้องการเพิ่มเติมนอกเหนือจากชุดเริ่มต้น

ตัวอย่างคำร้องขอ

{
  "type": "TASK_TYPE_EXPORT_MESSAGES_V2",
  "export_messages_v2": {
    "application_code": "XXXXX-XXXXX",
    "filters": {
      "created_date": {
        "date_from": "2026-01-01",
        "date_to": "2026-06-30"
      },
      "statuses": ["MESSAGE_STATUS_DONE"],
      "platforms": [1, 3]
    },
    "properties": [
      "EXPORT_MESSAGE_PROPERTY_ID",
      "EXPORT_MESSAGE_PROPERTY_TIMESTAMP",
      "EXPORT_MESSAGE_PROPERTY_STATUS",
      "EXPORT_MESSAGE_PROPERTY_PLATFORMS",
      "EXPORT_MESSAGE_PROPERTY_SENT",
      "EXPORT_MESSAGE_PROPERTY_OPENED"
    ]
  }
}

200: OK

{
  "uid": "177458"
}

401: API access token ไม่ถูกต้อง

{
  "error": "account not found"
}

status

ส่งคืนความคืบหน้าของงานส่งออก

POST https://api.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/status

พารามิเตอร์ในส่วนเนื้อหาของคำร้องขอ (Request body)

ส่งตัวระบุงานที่ได้รับจากการเรียก export:

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
uid	ใช่	String (int64)	ตัวระบุงานจากการตอบกลับของ export เช่น "177458"

ตัวอย่างคำร้องขอ

{
  "uid": "177458"
}

200: OK

{
  "status": "STATUS_SUCCESS",
  "progress": 1
}

status เป็นหนึ่งใน "STATUS_PENDING", "STATUS_SUCCESS" หรือ "STATUS_FAILED" ส่วน progress เป็นเศษส่วนระหว่าง 0 ถึง 1; ให้ตรวจสอบ status จนกว่าจะถึง "STATUS_SUCCESS" ก่อนที่จะเรียก result

result

ส่งคืนชื่อไฟล์ที่สร้างขึ้นเมื่องานเสร็จสมบูรณ์

POST https://api.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/result

พารามิเตอร์ในส่วนเนื้อหาของคำร้องขอ (Request body)

ส่งตัวระบุงานเดียวกันกับที่ได้รับจากการเรียก export:

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
uid	ใช่	String (int64)	ตัวระบุงานจากการตอบกลับของ export เช่น "177458"

ตัวอย่างคำร้องขอ

{
  "uid": "177458"
}

200: OK

{
  "export_messages_v2_result": {
    "file": "Export_Messages_v2_12345_20260813120000-a1b2c3d4.csv",
    "file_url": "https://app.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/download/Export_Messages_v2_12345_20260813120000-a1b2c3d4.csv"
  }
}

การเรียก result ก่อนที่ status จะรายงาน "STATUS_SUCCESS" จะส่งคืนผลลัพธ์ที่ว่างเปล่า file_url เป็นลิงก์ที่พร้อมใช้งานไปยัง endpoint สำหรับดาวน์โหลด บนศูนย์ข้อมูลที่ถูกต้องสำหรับบัญชี — ให้ใช้ตามที่เป็นอยู่แทนที่จะสร้าง URL จาก file ด้วยตัวเอง file_url จะว่างเปล่าหากศูนย์ข้อมูลของบัญชีไม่มีการกำหนดค่า URL พื้นฐาน ในกรณีนั้น คุณสามารถกลับไปสร้าง URL จาก file ได้ก็ต่อเมื่อบัญชีอยู่บนศูนย์ข้อมูลเริ่มต้น app.pushwoosh.com เท่านั้น — บัญชีบนศูนย์ข้อมูลอื่นหรือโดเมน white label จะไม่มีทางทราบโฮสต์ที่ถูกต้องจาก file เพียงอย่างเดียวได้

lastTasks

แสดงรายการงานส่งออกล่าสุดสำหรับแอปพลิเคชัน โดยแสดงรายการล่าสุดก่อน

POST https://api.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/lastTasks

พารามิเตอร์ในส่วนเนื้อหาของคำร้องขอ (Request body)

พารามิเตอร์ทุกตัวเป็นตัวกรองที่ไม่บังคับ; ละเว้นทั้งหมดเพื่อแสดงรายการงานทั้งหมดที่โทเค็นสามารถเข้าถึงได้:

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
application	ไม่	String	รหัสแอปพลิเคชัน Pushwoosh ละเว้นเพื่อแสดงรายการงานของทุกแอปพลิเคชันที่โทเค็นสามารถเข้าถึงได้
types	ไม่	Array	จำกัดเฉพาะประเภทงานที่ระบุ ใช้ [“TASK_TYPE_EXPORT_MESSAGES_V2”] เพื่อดูเฉพาะการส่งออกข้อความ
campaign	ไม่	String	กรองตาม รหัสแคมเปญ
message_id	ไม่	String (uint64)	กรองตาม ID ข้อความตัวเลขเดียว อยู่ในเครื่องหมายคำพูด
message_code	ไม่	String	กรองตาม รหัสข้อความ เดียว
limit	ไม่	Integer	จำนวนงานสูงสุดที่จะส่งคืน
timestamp_from	ไม่	String	ส่งคืนเฉพาะงานที่สร้างขึ้นหลังจากการประทับเวลานี้ (RFC 3339)

หมายเหตุ

งานจะถูกเก็บไว้เป็นเวลา 30 วัน โดยไม่คำนึงว่าไฟล์ของงานนั้นถูกลบไปแล้วหลังจากระยะเวลาการเก็บรักษาไฟล์ 7 วันหรือไม่ lastTasks ยังคงสามารถแสดงงานที่ result ของมันไม่สามารถชี้ไปยังไฟล์ที่ดาวน์โหลดได้อีกต่อไป

ตัวอย่างคำร้องขอ

{
  "application": "XXXXX-XXXXX",
  "types": ["TASK_TYPE_EXPORT_MESSAGES_V2"],
  "limit": 10
}

200: OK

{
  "tasks": [
    {
      "id": "177458",
      "timestamp": "2026-08-13T12:00:00Z",
      "status": "STATUS_SUCCESS",
      "requested_by_user": "user@example.com",
      "export_messages_v2": {
        "application_code": "XXXXX-XXXXX"
      },
      "export_messages_v2_result": {
        "file": "Export_Messages_v2_12345_20260813120000-a1b2c3d4.csv",
        "file_url": "https://app.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/download/Export_Messages_v2_12345_20260813120000-a1b2c3d4.csv"
      }
    }
  ]
}

delete

ลบงานและไฟล์ของงานนั้นก่อนที่ระยะเวลาการเก็บรักษา 7 วันจะหมดอายุ

POST https://api.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/delete

พารามิเตอร์ในส่วนเนื้อหาของคำร้องขอ (Request body)

ส่งตัวระบุงานที่ได้รับจากการเรียก export:

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
uid	ใช่	String (int64)	ตัวระบุงานจากการตอบกลับของ export เช่น "177458"

ตัวอย่างคำร้องขอ

{
  "uid": "177458"
}

200: OK

{}

ดาวน์โหลด

ดาวน์โหลดไฟล์ CSV ที่สร้างโดย result ตามชื่อ

GET https://app.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/download/<file>

ส่วนหัว (Headers)

รับรองความถูกต้องด้วยวิธีเดียวกับเมธอดอื่น ๆ หรือใช้เซสชัน Control Panel ที่ใช้งานอยู่:

ชื่อ	จำเป็น	คำอธิบาย
Authorization	ใช่	Server API token ในรูปแบบเดียวกับเมธอด exportMessagesStatistics อื่น ๆ: Authorization: Api <Server Key> (รูปแบบ Api ไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก) คำร้องขอที่ไม่มีส่วนหัว Authorization และไม่มีเซสชัน Control Panel ที่ลงชื่อเข้าใช้จะได้รับ 401 Unauthorized

แทนที่ <file> ด้วยค่า file ที่แน่นอนจากการตอบกลับของ result ตัวอย่างเช่น:

https://app.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/download/Export_Messages_v2_12345_20260813120000-a1b2c3d4.csv

ข้อควรระวัง

การสร้าง URL นี้ด้วยตนเองจะใช้ได้เฉพาะกับบัญชีที่อยู่บนศูนย์ข้อมูลเริ่มต้น app.pushwoosh.com เท่านั้น บัญชีบนศูนย์ข้อมูลอื่น (app.wavesend.ru สำหรับ OVB, app.pushwoosh.us สำหรับ IAD) หรือโดเมน white label ต้องการโฮสต์ที่แตกต่างกัน และไม่มีทางที่จะทราบได้จาก file เพียงอย่างเดียว ให้ใช้ file_url จาก result หรือ lastTasks แทน เนื่องจากมันชี้ไปยังโฮสต์ที่ถูกต้องสำหรับบัญชีอยู่แล้ว ดูที่ result สำหรับสิ่งที่ต้องทำหาก file_url กลับมาเป็นค่าว่าง

ไฟล์เป็น CSV ที่มีคอลัมน์ที่เลือกใน properties ไฟล์จะยังคงใช้งานได้เป็นเวลา 7 วันหลังจากการส่งออกเสร็จสิ้น จากนั้นงานล้างข้อมูลจะลบไฟล์ออกและ URL จะไม่สามารถใช้งานได้อีกต่อไป