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

ดัชนีอ้างอิงเมธอด 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 gateway

Anchor link to

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

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ส่งค่า badge ปัจจุบันสำหรับอุปกรณ์ไปยัง 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เปลี่ยนสถานะแพลตฟอร์มของแอป

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ดึงรายการข้อความใน Inbox สำหรับ HWID ที่ระบุ
inboxStatusอัปเดตสถานะของข้อความใน Inbox ที่ระบุ

Statistics API

Anchor link to

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

Anchor link to
messages:listดึงรายการข้อความที่ส่งแล้ว
totalsByIntervalsให้ข้อมูลเมตริกและข้อมูล Conversion ที่รวบรวมตามชั่วโมง
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ส่งคืนลิงก์สำหรับบันทึก “เพิ่มลงใน 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 ที่ใกล้ที่สุดและระยะทางไปถึง นอกจากนี้ยังบันทึกตำแหน่งของอุปกรณ์สำหรับการแจ้งเตือนแบบ geo push
addGeoZoneเพิ่ม Geozone ไปยังแอปที่ระบุ
updateGeoZoneอัปเดตคุณสมบัติของ Geozone เช่น ชื่อ สถานะ เนื้อหา และช่วง
deleteGeoZoneลบ Geozones ออกจากแอป
addGeoZoneClusterเพิ่ม Geozone Cluster ไปยังแอป
deleteGeoZoneClusterลบ Geozone Cluster ออกจากแอป
listGeoZonesดึงรายการ Geozones สำหรับแอป
listGeoZoneClustersดึงรายการคลัสเตอร์ Geozone สำหรับแอป