ข้ามไปยังเนื้อหา

ดัชนีอ้างอิงเมธอด API

Pushwoosh มีไลบรารีขนาดใหญ่ของเมธอด API กว่า 100 รายการ ซึ่งจัดหมวดหมู่ตามฟังก์ชันต่างๆ เช่น การส่งการแจ้งเตือน การจัดการผู้ใช้ และการติดตามการวิเคราะห์

Messaging API v2

Anchor link to

API แบบครบวงจรที่มาแทนที่กลุ่ม /create*Message ทั้งหมด (push, email, SMS, Kakao) ดู ภาพรวม และ คู่มือการย้าย

Notifyสร้างและส่งข้อความเดียวผ่านช่องทางใดก็ได้ แทนที่ /createMessage, /createTargetedMessage, /createEmailMessage, /createSMSMessage, /createKakaoMessage
Cancelยกเลิกข้อความที่สร้างไว้ก่อนหน้านี้ก่อนที่จะถูกส่ง ใช้กับ message_code จาก Notify
Updateแทนที่ข้อความที่ยังคงกำหนดเวลาไว้ด้วยคำจำกัดความใหม่ (แทนที่ทั้งหมด) ใช้กับ message_code จาก Notify

เกตเวย์ SMTP

Anchor link to

ส่งอีเมลธุรกรรมผ่าน SMTP มาตรฐานแทนการเรียก API โดยตรง เกตเวย์จะตรวจสอบสิทธิ์ด้วยรหัสแอปพลิเคชันและโทเค็น API ของคุณ จากนั้นจะส่งต่อแต่ละข้อความไปยัง Notify ดู ข้อมูลอ้างอิงเกตเวย์ SMTP

Messages API

Anchor link to
createMessage เลิกใช้แล้วสร้างการแจ้งเตือนแบบพุชใหม่ ใช้ Notify แทน
deleteMessageลบข้อความ (ที่ส่งแล้วหรือกำหนดเวลาไว้) และลบออกจากประวัติข้อความ
getMessageDetailsดึงรายละเอียดข้อความ
createTargetedMessage เลิกใช้แล้วสร้างการแจ้งเตือนแบบพุชที่กำหนดเป้าหมายใหม่ ใช้ Notify ที่มีชนิดเป็น transactional แทน
getPushHistory เลิกใช้แล้วใช้ /messages:list เพื่อดึงประวัติข้อความพร้อมข้อมูลโดยละเอียด
cancelMessageยกเลิกข้อความที่กำหนดเวลาไว้ โดยยังคงเก็บไว้ในประวัติข้อความ

Presets API

Anchor link to
Createสร้างพรีเซ็ตพุชใหม่
Listแสดงรายการพรีเซ็ตพุชของแอปพลิเคชัน
Getดึงพรีเซ็ตพุชเดียวตามรหัส
Updateเขียนทับพรีเซ็ตพุชตามรหัส
UpdatePartialอัปเดตเฉพาะฟิลด์ที่ให้มาของพรีเซ็ตพุชตามรหัส
Cloneทำซ้ำพรีเซ็ตพุชภายในแอปพลิเคชันเดียวกัน
Deleteลบพรีเซ็ตพุชตามรหัส

Device API

Anchor link to
registerDeviceลงทะเบียนอุปกรณ์สำหรับแอปพลิเคชัน
unregisterDeviceลบโทเค็นพุชของอุปกรณ์
deleteDeviceลบอุปกรณ์และข้อมูลที่เกี่ยวข้องทั้งหมดในแอปพลิเคชันที่ระบุ
setTagsตั้งค่าแท็กสำหรับอุปกรณ์
getTagsดึงแท็กพร้อมค่าที่สอดคล้องกันสำหรับอุปกรณ์เฉพาะ
setBadgeส่งค่าป้ายสถานะปัจจุบันสำหรับอุปกรณ์ไปยัง Pushwoosh
applicationOpenลงทะเบียนเหตุการณ์การเปิดแอป
pushStatลงทะเบียนเหตุการณ์การเปิดพุช
messageDeliveryEventลงทะเบียนเหตุการณ์การส่งพุชสำหรับอุปกรณ์

Audience API

Anchor link to
bulkSetTagsตั้งค่าแท็กสำหรับอุปกรณ์หลายเครื่อง
bulkSetTags Statusส่งคืนสถานะของการดำเนินการ bulkSetTags
bulkRegisterDeviceลงทะเบียนอุปกรณ์หลายเครื่องในคำขอเดียว รวมถึงค่าแท็กที่เป็นตัวเลือกสำหรับแต่ละอุปกรณ์
bulkRegisterDevice Statusดึงสถานะและผลลัพธ์ของคำขอลงทะเบียนอุปกรณ์จำนวนมากโดยใช้ ID คำขอ
bulkUnregisterDeviceยกเลิกการลงทะเบียนอุปกรณ์หลายเครื่องในคำขอเดียว
bulkUnregisterDevice Statusดึงสถานะและผลลัพธ์ของคำขอยกเลิกการลงทะเบียนอุปกรณ์จำนวนมากโดยใช้ ID คำขอ
addTagสร้างแท็กในบัญชีของคุณ
deleteTagลบแท็กพร้อมข้อมูลที่เกี่ยวข้องทั้งหมด
listTagsดึงรายการแท็กในบัญชี

Segmentation (Filters) API

Anchor link to
createFilterสร้างเซกเมนต์ใหม่
listFiltersส่งคืนรายการเซกเมนต์ที่มีอยู่พร้อมเงื่อนไข
deleteFilterลบเซกเมนต์ที่มีอยู่
exportSegmentกำหนดเวลาคำขอเพื่อส่งออกผู้ติดตามที่ตรงกับเงื่อนไขของเซกเมนต์
exportSegment Resultsดึงลิงก์ CSV สำหรับผลลัพธ์ exportSegment

User-centric API

Anchor link to
registerUserเชื่อมโยง User ID ภายนอกกับอุปกรณ์ที่ระบุ
deleteUserลบผู้ใช้และอุปกรณ์ทั้งหมดที่เชื่อมโยงกับ User ID ที่ระบุ
postEventเรียกเหตุการณ์ภายในแอป

Events API

Anchor link to
createEventสร้างเหตุการณ์สำหรับแอป

Applications API

Anchor link to
createApplicationสร้างแอปพลิเคชันใหม่ในบัญชี
updateApplicationอัปเดตการตั้งค่าแอปพลิเคชัน
deleteApplicationลบแอปออกจากบัญชี
getApplicationรับรายละเอียดเกี่ยวกับแอป
getApplicationsดึงรายการแอปพลิเคชันในบัญชี
getApplicationFileดึงไฟล์การกำหนดค่าที่เกี่ยวข้องกับแอป
setApplicationPlatformStatusเปลี่ยนสถานะแพลตฟอร์มของแอป

Control Groups API

Anchor link to
Listแสดงรายการกลุ่มควบคุมของแอปพลิเคชัน
Createสร้างกลุ่มควบคุม
Getดึงกลุ่มควบคุมเดียวตามรหัส
UpdatePercentageปรับขนาดเปอร์เซ็นต์การกันออกของกลุ่มควบคุม
UpdateCountriesกำหนดขอบเขตกลุ่มควบคุมใหม่เป็นชุดของประเทศ
Disableปิดกลุ่มควบคุม
Reshuffleสุ่มตัวอย่างการกันออกของกลุ่มควบคุมใหม่
ForceUpdateCalculationเริ่มนับขนาดของกลุ่มควบคุมใหม่
GetCalculationStatusสำรวจการคำนวณขนาดที่กำลังทำงานอยู่
GetAnalyticsดึงข้อมูลการวิเคราะห์ Control-vs-Treatment สำหรับกลุ่มควบคุม
CheckControlGroupMembershipรายงานว่า User ID แต่ละรายการในชุดถูกกันออกโดยกลุ่มควบคุมหรือไม่
Deleteลบกลุ่มควบคุม

Data Erasure API

Anchor link to
Createเริ่มการลบ (หรือการนับแบบทดลอง) ข้อมูลส่วนบุคคลของบุคคลหนึ่ง
Uploadสร้างงานลบข้อมูลจากไฟล์ CSV ของตัวระบุที่อัปโหลด
ListTasksแสดงรายการงานลบข้อมูลของบัญชี
GetTaskดึงสถานะและตัวนับของงานลบข้อมูลหนึ่งงาน
ListTaskRowsแสดงผลลัพธ์รายตัวระบุของงานหนึ่งงาน
GetTaskReportดาวน์โหลดรายงานของงานหนึ่งงานเป็น CSV
GetJournalReportดาวน์โหลดงานทั้งหมดในช่วงเวลาหนึ่งเป็นไฟล์ CSV เดียว

Campaigns API

Anchor link to
createCampaignสร้างแคมเปญพุชใหม่
deleteCampaignลบแคมเปญเฉพาะ
getCampaignsดึงรายการแคมเปญสำหรับแอป

App configuration API

Anchor link to
configureApplication for iOSกำหนดค่าแพลตฟอร์ม iOS สำหรับแอป
configureApplication for Androidกำหนดค่าแพลตฟอร์ม Android สำหรับแอป
configureApplication for Mac OS Xกำหนดค่าแพลตฟอร์ม macOS สำหรับแอป
configureApplication for Windowsกำหนดค่าแพลตฟอร์ม Windows สำหรับแอป
configureApplication for Amazonกำหนดค่าแพลตฟอร์ม Amazon สำหรับแอป
configureApplication for Chromeกำหนดค่าแพลตฟอร์ม Chrome สำหรับแอป
configureApplication for Safariกำหนดค่าแพลตฟอร์ม Safari สำหรับแอป
configureApplication for Firefoxกำหนดค่าแพลตฟอร์ม Firefox สำหรับแอป
configureApplication for Emailกำหนดค่าแพลตฟอร์ม Email สำหรับแอป
createEmailMessage เลิกใช้แล้วสร้างข้อความอีเมล ใช้ Notify ที่มี platforms: ["EMAIL"] และ email_payload แทน
registerEmailลงทะเบียนที่อยู่อีเมลสำหรับแอป
deleteEmailลบที่อยู่อีเมลออกจากฐานข้อมูลของคุณ
setEmailTagsตั้งค่าแท็กสำหรับที่อยู่อีเมลที่ระบุ
registerEmailUserเชื่อมโยง User ID ภายนอกกับที่อยู่อีเมลที่ระบุ

Email Templates API

Anchor link to
Createสร้างเทมเพลตอีเมลใหม่ในแอปพลิเคชัน
Listแสดงรายการเทมเพลตอีเมลของแอปพลิเคชัน
Getส่งคืนเทมเพลตอีเมลเดียวตามรหัส
Updateอัปเดตเทมเพลตอีเมลที่มีอยู่ตามรหัส
Deleteลบเทมเพลตอีเมลและพรีเซ็ตที่เชื่อมต่ออยู่ตามรหัส
Cloneโคลนเทมเพลตอีเมลไปยังแอปพลิเคชันปลายทาง

Test devices API

Anchor link to
createTestDeviceลงทะเบียนอุปกรณ์ทดสอบสำหรับแอปพลิเคชัน
listTestDevicesดึงอุปกรณ์ทดสอบทั้งหมดที่ลงทะเบียนสำหรับแอปพลิเคชัน

Message inbox API

Anchor link to
getInboxMessagesดึงรายการข้อความในกล่องจดหมายสำหรับ HWID ที่ระบุ
inboxStatusอัปเดตสถานะของข้อความในกล่องจดหมายที่ระบุ

Statistics API

Anchor link to

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

Anchor link to
messages:listดึงรายการข้อความที่ส่งแล้ว
totalsByIntervalsให้ข้อมูลเมตริกและข้อมูล Conversion ที่รวมตามชั่วโมง
getDeliveryFunnelส่งคืน delivery funnel ของหนึ่งข้อความ แบ่งตามช่องทางและแพลตฟอร์ม
getCampaignDeliveryFunnelรวม delivery funnel ของข้อความทั้งหมดในแคมเปญ
getMessageLogดึงข้อมูลโดยละเอียดเกี่ยวกับข้อความที่ส่งแล้ว
linksInteractionsให้สถิติเกี่ยวกับการคลิกลิงก์ในอีเมล
linksInteractionsDevicesแสดงรายชื่อผู้ใช้ที่คลิกลิงก์ในอีเมล
bouncedEmailsให้ข้อมูลเกี่ยวกับการตีกลับของอีเมล การร้องเรียน และเหตุผลการตีกลับ

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

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

สถิติแอปพลิเคชันและผู้ติดตาม

Anchor link to
getApplicationSubscribersStatsดึงสถิติผู้ติดตามของแอป โดยจัดกลุ่มตามประเภทอุปกรณ์
getAppStatsดึงสถิติแอปสำหรับช่วงเวลาที่ระบุ
getSubscribersStatisticsดึงสถิติผู้ติดตามสำหรับช่วงเวลาที่ระบุ

สถิติแคมเปญ

Anchor link to
getCampaignStatsดึงสถิติแคมเปญสำหรับช่วงเวลาที่ระบุ

สถิติเหตุการณ์และแท็ก

Anchor link to
getEventStatisticsดึงจำนวนครั้งที่เหตุการณ์ถูกทริกเกอร์ในช่วงเวลาที่ระบุ
getTagStatsดึงสถิติสำหรับแท็กที่ระบุ

สถิติในแอป

Anchor link to
inapps:totalsดึงข้อมูลยอดรวมของการแสดงผล การโต้ตอบ และการจำกัดความถี่สำหรับแคมเปญในแอปหนึ่งแคมเปญหรือมากกว่าในช่วงเวลาหนึ่ง
inapps:timelineดึงข้อมูลยอดรวมของช่วงเวลาและอนุกรมเวลาของเมตริกในแอปสำหรับแคมเปญเดียว

iOS Live Activities API

Anchor link to
startLiveActivityสร้าง iOS Live Activity ใหม่
updateLiveActivityอัปเดต iOS Live Activity ที่มีอยู่

Apple Wallet PassKit API

Anchor link to
Apple Wallet PassKit APIข้อมูลอ้างอิงสำหรับการจัดการบัตร Apple Wallet และการกำหนดค่าที่เกี่ยวข้องใน Pushwoosh

Google Wallet API

Anchor link to
Create a passสร้างบัตรใน Google Wallet และส่งคืนลิงก์บันทึก
Validate a passตรวจสอบการกำหนดค่าบัตรโดยไม่ต้องสร้าง
Update a passอัปเดตบัตรที่มีอยู่ Google จะส่งการเปลี่ยนแปลงไปยังอุปกรณ์ที่บันทึกไว้
Get a save linkส่งคืนลิงก์บันทึก “Add to Google Wallet” สำหรับบัตรที่มีอยู่
Get a passส่งคืนบัตรที่จัดเก็บไว้ใบเดียว
List passesส่งคืนรายการบัตรแบบแบ่งหน้าสำหรับแอปพลิเคชัน
Set pass stateเปิดใช้งานหรือทำให้บัตรใช้งานไม่ได้
Delete a passทำให้บัตรใน Google ใช้งานไม่ได้และลบบันทึกใน Pushwoosh
Get configurationส่งคืนสถานะการกำหนดค่า Google Wallet สำหรับแอปพลิเคชัน
Templatesแสดงรายการเทมเพลตบัตรหรือดึงมาหนึ่งรายการเพื่อเป็นจุดเริ่มต้น

Customer Journey API

Anchor link to
Lifecycleเริ่ม, หยุดชั่วคราว, สิ้นสุด, ร่าง หรือเก็บ Journey ตาม UUID ของมัน
Create and updateสร้างคำจำกัดความ Journey ใหม่หรือแทนที่อันที่มีอยู่
Start by APIนำผู้ใช้เข้าสู่จุดเริ่มต้น API ของ Journey ที่กำลังทำงานอยู่
Get Journey statsรับสถิติสำหรับ Journey ที่ระบุตาม ID ของมัน
Remove users from journeysลบผู้ใช้หนึ่งคนหรือมากกว่าออกจาก Journey ที่ใช้งานอยู่ทั้งหมดหรือที่เลือก

Scheduled requests API

Anchor link to
getResultsดึงผลลัพธ์ของคำขอที่กำหนดเวลาไว้
createSMSMessage เลิกใช้แล้วสร้างข้อความ SMS ใหม่ ใช้ Notify ที่มี platforms: ["SMS"] แทน

WhatsApp API

Anchor link to
createWhatsAppMessage เลิกใช้แล้วสร้างข้อความ WhatsApp ใหม่ ใช้ Notify ที่มี platforms: ["WHATS_APP"] แทน
createLineMessage เลิกใช้แล้วสร้างข้อความ LINE ใหม่ ใช้ Notify ที่มี platforms: ["LINE"] แทน
createKakaoMessage เลิกใช้แล้วส่งข้อความ Kakao โดยใช้เทมเพลตที่ได้รับอนุมัติ ใช้ Notify ที่มี platforms: ["KAKAO"] แทน

Geozones API

Anchor link to
getNearestZoneดึงพารามิเตอร์ของ Geozone ที่ใกล้ที่สุดและระยะทางไปยังโซนนั้น และยังบันทึกตำแหน่งของอุปกรณ์สำหรับการแจ้งเตือนแบบพุชตามตำแหน่งทางภูมิศาสตร์
addGeoZoneเพิ่ม Geozone ไปยังแอปที่ระบุ
updateGeoZoneอัปเดตคุณสมบัติของ Geozone เช่น ชื่อ สถานะ เนื้อหา และช่วง
deleteGeoZoneลบ Geozones ออกจากแอป
addGeoZoneClusterเพิ่ม Geozone Cluster ไปยังแอป
deleteGeoZoneClusterลบ Geozone Cluster ออกจากแอป
listGeoZonesดึงรายการ Geozones สำหรับแอป
listGeoZoneClustersดึงรายการคลัสเตอร์ Geozone สำหรับแอป