พารามิเตอร์ /createMessage

ที่นี่คุณจะพบคำอธิบายของพารามิเตอร์ API /createMessage

• พารามิเตอร์ที่จำเป็น ต้องรวมอยู่ด้วยเพื่อส่งคำขอ API /createMessage และออกอากาศ push notification ในเวลาที่กำหนดได้สำเร็จ

• พารามิเตอร์ทางเลือก ช่วยให้คุณสามารถปรับแต่งคุณสมบัติของ push notification ได้

หมายเหตุ

หากคุณใช้ /createMessage เพื่อส่ง SMS โปรดอ้างอิงถึง พารามิเตอร์สำหรับการส่ง SMS พารามิเตอร์อื่นๆ จะไม่ถูกส่งผ่าน

พารามิเตอร์ที่จำเป็น

พารามิเตอร์ที่จำเป็นเป็นข้อบังคับที่ต้องใช้ในคำขอ /createMessage มิฉะนั้น คำขอจะไม่ถูกส่ง

application

รหัสเฉพาะของแอปที่สร้างขึ้นในบัญชี Pushwoosh ของคุณ รหัสแอปสามารถพบได้ที่มุมซ้ายบนของ Control Panel หรือในการตอบกลับคำขอ /createApplication รหัสแอปเป็นชุดอักขระ 10 ตัวที่คั่นด้วยยัติภังค์ (ทั้งตัวอักษรและตัวเลข)

เมื่อสร้างแอปผ่าน API คุณจะได้รับรหัสแอปในการตอบกลับคำขอ /createApplication ของคุณ

หากต้องการรับรหัสของแอปที่สร้างไว้ก่อนหน้านี้ผ่าน API ให้เรียกใช้ /getApplications ในการตอบกลับคำขอ /getApplications คุณจะได้รับรายการแอปทั้งหมดที่สร้างขึ้นในบัญชี Pushwoosh ของคุณพร้อมชื่อและรหัส

auth

โทเค็นการเข้าถึง API จาก Pushwoosh Control Panel ไปที่ Settings → API Access และคัดลอกโทเค็นที่คุณต้องการใช้หรือสร้างโทเค็นใหม่

เมื่อสร้างโทเค็นการเข้าถึง ให้ระบุสิทธิ์ของโทเค็นนั้น เลือกช่องทำเครื่องหมายสำหรับประเภทของกิจกรรมที่คุณจะใช้โทเค็น API ด้วย คุณสามารถสร้างโทเค็น API เฉพาะแอปได้โดยการเลือกช่องทำเครื่องหมาย Applications

content

สตริงหรือออบเจ็กต์ที่กำหนดเนื้อหาของข้อความ พารามิเตอร์ “content” ที่ส่งด้วยค่าประเภทสตริงจะส่งข้อความเดียวกันสำหรับผู้รับทุกคน

String

"content": "Hello world!",

ออบเจ็กต์ JSON ใช้สำหรับระบุเนื้อหาโดยใช้ Dynamic Content ตัวอย่างเช่น สำหรับข้อความหลายภาษา

Object

"content": {
  "en": "Hello!",
  "es": "¡Hola!",
  "de": "Hallo!"
},

notifications

อาร์เรย์ JSON ของคุณสมบัติ push ต้องมีพารามิเตอร์ที่จำเป็นอย่างน้อย content และ send_date

พารามิเตอร์ทางเลือกที่จะใช้ภายในอาร์เรย์ “notifications”:

• campaign
• capping_days
• capping_count
• conditions
• data
• devices
• dynamic_content
• filter
• ignore_user_timezone
• inbox_date
• inbox_image
• link
• minimize_link
• platforms
• preset
• rich_media
• send_rate
• timezone
• template_bindings
• transactionId
• users

send_date

วันที่และเวลาที่จะส่งข้อความ สามารถเป็นวันที่และเวลาใดก็ได้ในรูปแบบ YYYY-MM-DD HH:mm หรือ ‘now’ หากตั้งค่าเป็น ‘now’ ข้อความจะถูกส่งทันทีหลังจากส่งคำขอ

พารามิเตอร์ทางเลือก

campaign

รหัสของ Campaign หากต้องการรับรหัส Campaign ให้ไปที่ Statistics → Aggregated statistics และเลือก Campaign ที่คุณจะใช้ รหัสแคมเปญจะปรากฏที่ส่วนท้ายของ URL ของหน้าในรูปแบบ XXXXX-XXXXX

ตัวอย่าง:

URL: https://app.pushwoosh.com/applications/AAAAA-AAAAA/statistics/aggregated-message?campaignCode=XXXXX-XXXXX

รหัส Campaign: XXXXX-XXXXX

หากต้องการรับรายการ Campaigns พร้อมรหัส ให้เรียกใช้ /getCampaigns ในการตอบกลับคำขอ /getCampaigns คุณจะได้รับรายการ Campaigns ทั้งหมดที่สร้างขึ้นสำหรับแอปใดแอปหนึ่งในบัญชี Pushwoosh ของคุณ พร้อมด้วยรหัส ชื่อ และคำอธิบาย

capping_days

ระยะเวลาที่จะใช้สำหรับการจำกัดความถี่เป็นวัน (สูงสุด 30 วัน) ดูรายละเอียดที่ การจำกัดความถี่ (Frequency capping)

capping_count

จำนวน push สูงสุดที่สามารถส่งจากแอปเฉพาะไปยังอุปกรณ์ใดอุปกรณ์หนึ่งภายในระยะเวลา “capping_days” ในกรณีที่ข้อความที่สร้างขึ้นเกินขีดจำกัด “capping_count” สำหรับอุปกรณ์ ข้อความนั้นจะไม่ถูกส่งไปยังอุปกรณ์นั้น ดูรายละเอียดที่ การจำกัดความถี่ (Frequency capping)

conditions

Conditions เป็นอาร์เรย์เช่น [tagName, operator, operand] ที่ใช้สำหรับการส่งข้อความที่กำหนดเป้าหมายตาม Tags และค่าของมัน โดยที่:

• tagName — ชื่อของแท็กที่จะใช้
• operator — ตัวดำเนินการเปรียบเทียบค่า (“EQ” | “IN” | “NOTEQ” | “NOTIN” | “LTE” | “GTE” | “BETWEEN” | “NOTSET” | “ANY”)
• operand — ค่าแท็กประเภทใดประเภทหนึ่งต่อไปนี้: string | integer | array | date | boolean | list

คำอธิบายตัวดำเนินการ

EQ	ค่าแท็กเท่ากับ operand
IN	ค่าแท็กตัดกับ operand (operand ต้องเป็นอาร์เรย์เสมอ)
NOTEQ	ค่าแท็กไม่เท่ากับ operand
NOTIN	ค่าแท็กไม่ตัดกับ operand (operand ต้องเป็นอาร์เรย์เสมอ)
GTE	ค่าแท็กมากกว่าหรือเท่ากับ operand
LTE	ค่าแท็กน้อยกว่าหรือเท่ากับ operand
BETWEEN	ค่าแท็กมากกว่าหรือเท่ากับค่า operand ขั้นต่ำ แต่น้อยกว่าหรือเท่ากับค่า operand สูงสุด (operand ต้องเป็นอาร์เรย์เสมอ)
NOTSET	ไม่ได้ตั้งค่าแท็ก ไม่พิจารณา Operand
ANY	แท็กมีค่าใดก็ได้ ไม่พิจารณา Operand

แท็กสตริง

ตัวดำเนินการที่ถูกต้อง: EQ, IN, NOTEQ, NOTIN, NOTSET, ANY

Operands ที่ถูกต้อง:

EQ, NOTEQ	operand ต้องเป็นสตริง
IN, NOTIN	operand ต้องเป็นอาร์เรย์ของสตริงเช่น ["value 1", "value 2", "value N"]
NOTSET	ไม่ได้ตั้งค่าแท็ก ไม่พิจารณา Operand
ANY	แท็กมีค่าใดก็ได้ ไม่พิจารณา Operand

แท็กจำนวนเต็ม

ตัวดำเนินการที่ถูกต้อง: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY

Operands ที่ถูกต้อง:

EQ, NOTEQ, GTE, LTE	operand ต้องเป็นจำนวนเต็ม
IN, NOTIN	operand ต้องเป็นอาร์เรย์ของจำนวนเต็มเช่น [value 1, value 2, value N]
BETWEEN	operand ต้องเป็นอาร์เรย์ของจำนวนเต็มเช่น [min_value, max_value]
NOTSET	ไม่ได้ตั้งค่าแท็ก ไม่พิจารณา Operand
ANY	แท็กมีค่าใดก็ได้ ไม่พิจารณา Operand

แท็กวันที่

ตัวดำเนินการที่ถูกต้อง: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE, NOTSET, ANY

Operands ที่ถูกต้อง:

• "YYYY-MM-DD 00:00" (สตริง)
• การประทับเวลา unix 1234567890 (จำนวนเต็ม)
• "N days ago" (สตริง) สำหรับตัวดำเนินการ EQ, BETWEEN, GTE, LTE

แท็กบูลีน

ตัวดำเนินการที่ถูกต้อง: EQ, NOTSET, ANY

Operands ที่ถูกต้อง: 0, 1, true, false

แท็กรายการ

ตัวดำเนินการที่ถูกต้อง: IN, NOTIN, NOTSET, ANY

Operands ที่ถูกต้อง: operand ต้องเป็นอาร์เรย์ของสตริงเช่น ["value 1", "value 2", "value N"]

สำคัญ

โปรดจำไว้ว่าไม่ควรใช้พารามิเตอร์ “filter” และ “conditions” ร่วมกัน
นอกจากนี้ ทั้งสองพารามิเตอร์ จะถูกละเว้น หากใช้พารามิเตอร์ “devices” ในคำขอเดียวกัน

แท็กประเทศและภาษา

ค่าแท็กภาษาเป็นรหัสสองตัวอักษรตัวพิมพ์เล็กตาม ISO-639-1 ค่าแท็กประเทศเป็นรหัสสองตัวอักษรตัวพิมพ์ใหญ่ตาม ISO_3166-2

ตัวอย่างเช่น หากต้องการส่ง push notification ไปยังผู้สมัครสมาชิกที่พูดภาษาโปรตุเกสในบราซิล คุณจะต้องระบุเงื่อนไขต่อไปนี้: "conditions": [["Country", "EQ", "BR"],["Language", "EQ", "pt"]]

conditions_operator

ตัวดำเนินการตรรกะสำหรับอาร์เรย์เงื่อนไข ค่าที่เป็นไปได้: AND | OR ค่าเริ่มต้นคือ AND

หากตัวดำเนินการที่ใช้คือ AND (เมื่อไม่ได้ระบุตัวดำเนินการ หรือพารามิเตอร์ ‘conditions_operator’ มีค่าเป็น ‘AND’) อุปกรณ์ที่ปฏิบัติตามเงื่อนไขทั้งหมดพร้อมกันจะได้รับ push notification

หากตัวดำเนินการคือ OR อุปกรณ์ที่ปฏิบัติตามเงื่อนไขใดๆ ที่ระบุจะได้รับข้อความ

data

สตริง JSON หรือออบเจ็กต์ JSON ที่ใช้ในการส่ง ข้อมูลที่กำหนดเอง ใดๆ ใน payload ของ push; จะถูกส่งเป็นพารามิเตอร์ “u” ใน payload (แปลงเป็นสตริง JSON)

devices

อาร์เรย์ของ push tokens หรือ hwids เพื่อส่ง push notification ที่กำหนดเป้าหมาย หากตั้งค่าไว้ ข้อความจะถูกส่งไปยังอุปกรณ์ในรายการเท่านั้น

dynamic_content

ตัวยึดตำแหน่งสำหรับ Dynamic Content ที่จะใช้แทนค่าแท็กของอุปกรณ์ ตัวอย่างด้านล่างจะส่งข้อความ “Hello, John!” ไปยังผู้ใช้ทุกคนที่คุณกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ค่า Dynamic Content จะถูกนำมาจากแท็กของอุปกรณ์

"content": "Hello, {firstname|CapitalizeFirst}!",
"dynamic_content_placeholders": {
  "firstname": "John",
  "lastname": "Doe"
},

filter

ชื่อของ Segment ตรงตามที่สร้างใน Pushwoosh Control Panel หรือผ่านคำขอ API /createFilter ไปที่ส่วน Audience → Segments และตรวจสอบรายการ Segments ที่สร้างขึ้น

หากต้องการรับรายการ Segments ผ่าน API ให้เรียกใช้เมธอด API /listFilters ในการตอบกลับคำขอ /listFilters คุณจะได้รับรายการ Segments ทั้งหมดที่สร้างขึ้นในบัญชี Pushwoosh ของคุณ พร้อมด้วยชื่อเงื่อนไข และวันหมดอายุของ Segments

ignore_user_timezone

หากตั้งค่าเป็น ‘true’ จะส่งข้อความในเวลาและวันที่ที่ระบุในพารามิเตอร์ “send_date” ตาม UTC-0

หากตั้งค่าเป็น ‘false’ ผู้ใช้จะได้รับข้อความตามเวลาท้องถิ่นที่ระบุตามการตั้งค่าของอุปกรณ์

inbox_date

วันที่ที่ข้อความควรถูกเก็บไว้ใน Inbox ของผู้ใช้ หากไม่ได้ระบุ ข้อความจะถูกลบออกจาก Inbox ในวันถัดไปหลังจากวันที่ส่ง

หมายเหตุ

หากต้องการบันทึกข้อความไปยัง Inbox ให้ใช้อย่างน้อยหนึ่งพารามิเตอร์ ‘inbox’: “inbox_date” หรือ “inbox_image”

ข้อควรระวัง

ข้อความจะถูกลบออกจาก Inbox เวลา 00:00:01 ของวันที่ระบุ ดังนั้นวันก่อนหน้าคือวันสุดท้ายที่ผู้ใช้สามารถเห็นข้อความใน Inbox ของตนได้

inbox_image

URL ของรูปภาพที่กำหนดเองที่จะแสดงใกล้กับข้อความใน Inbox

หมายเหตุ

หากต้องการบันทึกข้อความไปยัง Inbox ให้ใช้อย่างน้อยหนึ่งพารามิเตอร์ ‘inbox’: “inbox_date” หรือ “inbox_image”

inbox_days

อายุการใช้งานของข้อความในกล่องจดหมายเป็นวัน สูงสุด 30 วัน หลังจากช่วงเวลานี้ ข้อความจะถูกลบออกจากกล่องจดหมาย สามารถใช้แทนพารามิเตอร์ inbox_date ได้

link

URL ที่จะเปิดเมื่อผู้ใช้เปิด push notification

minimize_link

ตัวย่อเพื่อย่อ URL ที่ส่งในพารามิเตอร์ “link” โปรดทราบว่าขนาด payload ของ push notification มีจำกัด ดังนั้นควรพิจารณาสร้าง URL สั้นๆ เพื่อไม่ให้เกินขีดจำกัด ค่าที่ใช้ได้: 0 — ไม่ย่อ, 2 — bitly ค่าเริ่มต้น = 2 ตัวย่อ URL ของ Google ถูกปิดใช้งานตั้งแต่วันที่ 30 มีนาคม 2019

platforms

อาร์เรย์ของรหัสแพลตฟอร์มเพื่อส่งข้อความไปยังแพลตฟอร์มเฉพาะเท่านั้น

รหัสแพลตฟอร์มที่ใช้ได้ ได้แก่: 1 — iOS, 3 — Android, 7 — Mac OS X, 8 — Windows, 9 — Amazon, 10 — Safari, 11 — Chrome, 12 — Firefox, 14 — Email, 17 — Huawei, 18 — SMS, และ 21 — WhatsApp

preset

รหัสของ Preset ที่สร้างใน Pushwoosh Control Panel หรือผ่าน API หากต้องการรับรหัส preset ให้ไปที่ Content → Presets ขยาย preset ที่คุณจะใช้ และคัดลอก Preset Code จากรายละเอียดของ preset

rich_media

รหัสของหน้า Rich Media ที่คุณจะแนบไปกับข้อความของคุณ หากต้องการรับรหัส ให้ไปที่ Content → Rich Media เปิดหน้า Rich Media ที่คุณจะใช้ และคัดลอกรหัสจากแถบ URL ของเบราว์เซอร์ของคุณ รหัสเป็นชุดอักขระ 10 ตัวที่คั่นด้วยยัติภังค์ (ทั้งตัวอักษรและตัวเลข)

send_rate

การควบคุมปริมาณเพื่อจำกัดความเร็วในการส่ง push ค่าที่ถูกต้องคือตั้งแต่ 100 ถึง 1000 pushes/วินาที

timezone

เขตเวลาที่จะนำมาพิจารณาเมื่อส่งข้อความในวันที่และเวลาที่กำหนด หากตั้งค่าไว้ เขตเวลาของอุปกรณ์จะถูกละเว้น หากละเว้น ข้อความจะถูกส่งในเวลา UTC ดู https://php.net/manual/timezones.php สำหรับเขตเวลาที่รองรับ

template_bindings

ตัวยึดตำแหน่งเทมเพลตที่จะใช้ในเทมเพลตเนื้อหาของคุณ ดูรายละเอียดในคู่มือ Liquid Templates

transactionId

ตัวระบุข้อความที่ไม่ซ้ำกันเพื่อป้องกันข้อความซ้ำซ้อนในกรณีที่เกิดปัญหาเครือข่าย คุณสามารถกำหนด ID ใดๆ ให้กับข้อความที่สร้างผ่านคำขอ /createMessage หรือ /createTargetedMessage ได้ จะถูกเก็บไว้ที่ฝั่ง Pushwoosh เป็นเวลา 5 นาที

users

อาร์เรย์ของ userIds User ID เป็นตัวระบุผู้ใช้ที่ไม่ซ้ำกันซึ่งตั้งค่าโดยคำขอ API /registerUser, /registerDevice หรือ /registerEmail