# การอ้างอิง Payload
การอ้างอิงสำหรับข้อความ `Payload` ที่ใช้โดย [`Notify`](/th/developer/api-reference/messaging-api-v2/notify/) เมื่อส่งผ่านช่องทางที่ไม่ใช่อีเมล (push, SMS, Telegram, Kakao, LINE, Viber, WhatsApp, Facebook Messenger)
## Payload
- `preset` (string): รหัส [push preset](/th/product/content/push-presets/) (รูปแบบ `XXXXX-XXXXX`) ที่จะนำไปใช้กับข้อความนี้
- `sms_preset` (string): รหัส (รูปแบบ `XXXXX-XXXXX`) ของ [SMS preset](/th/product/content/sms-presets/) ที่บันทึกไว้ ข้อความต่อ locale ของมันจะถูกแก้ไขเป็น [`sms.body`](#sms-sms) ของแต่ละ locale `sms.body` แบบอินไลน์สำหรับ locale ที่กำหนดจะแทนที่ preset สำหรับ locale นั้น preset ต้องเป็นของแอปพลิเคชันเดียวกับข้อความ
- `content` ([`LocalizedContent`](#localizedcontent)): เนื้อหาข้อความ ไม่สามารถใช้ร่วมกับ `silent` ได้
- `silent` (bool): ส่ง push แบบเงียบ (ข้อมูลเท่านั้น) ไม่สามารถใช้ร่วมกับ `content` ได้
- `custom_data` (object): JSON รูปแบบอิสระที่ส่งต่อไปยัง SDK ของไคลเอ็นต์เป็นพารามิเตอร์ `u`
- `open_action` ([`OpenAction`](#openaction)): การกระทำที่เกิดขึ้นเมื่อผู้ใช้เปิดการแจ้งเตือน
- `open_actions` (map<Platform, `OpenAction`>): การแทนที่ `open_action` ต่อแพลตฟอร์ม คีย์คือค่า enum `Platform` ที่เป็นตัวเลข
- `voip_push` (bool): การแจ้งเตือน iOS VoIP
```json
{
"payload": {
"preset": "XXXXX-XXXXX",
"content": { "localized_content": { "default": { "ios": { "title": "Hello", "body": "Tap to view" } } } },
"custom_data": { "order_id": "42" },
"open_action": { "link": { "url": "https://example.com/promo" } }
}
}
```
## LocalizedContent
แมปรหัส locale กับเนื้อหาต่อแพลตฟอร์ม คีย์คือรหัสสองตัวอักษร [ISO 639-1](https://www.loc.gov/standards/iso639-2/php/code_list.php) (ตัวอย่างเช่น `"en"`, `"es"`) บวกกับคีย์พิเศษ `"default"` สำหรับการแปลแบบครอบคลุมทั้งหมด ข้อยกเว้นสำหรับ ISO 639-1 คือ `"zh-Hant"` และ `"zh-Hans"` สำหรับภาษาจีนตัวเต็มและตัวย่อ
```json
{
"localized_content": {
"default": {
"ios": { "title": "Hello", "body": "Tap to view" },
"android": { "title": "Hello", "body": "Tap to view" }
},
"es": {
"ios": { "title": "Hola", "body": "Toca para ver" },
"android": { "title": "Hola", "body": "Toca para ver" }
}
}
}
```
### การเลือก Locale สำหรับอุปกรณ์
เนื้อหาที่ส่งไปยังอุปกรณ์จะถูกเลือกตามลำดับนี้:
1. ตรงกับภาษาของอุปกรณ์อย่างสมบูรณ์
2. คีย์ `"default"`
3. คีย์ `"en"`
4. locale อื่นๆ ที่มีอยู่ในแมป
โปรดระบุอย่างน้อยหนึ่งใน `"default"` หรือ `"en"` เพื่อให้อุปกรณ์ทุกเครื่องมีการสำรองข้อมูลที่แน่นอน หากคุณไม่คาดหวังว่าจะมีรูปแบบที่แตกต่างกันไปในแต่ละ locale ให้ส่งเฉพาะ `"default"`
แต่ละรายการ locale คืออ็อบเจกต์ `Content` ที่มีบล็อกต่อแพลตฟอร์มที่เป็นทางเลือก กรอกเฉพาะแพลตฟอร์มที่คุณต้องการกำหนดเป้าหมาย
| บล็อกแพลตฟอร์ม | ช่องทาง |
|---|---|
| `ios` | iOS push |
| `android` | Android (FCM) push |
| `huawei_android` | Huawei Android push |
| `mac_os` | macOS push |
| `amazon` | Amazon (ADM) push |
| `safari` | Safari web push |
| `chrome` | Chrome web push |
| `firefox` | Firefox web push |
| `ie` | Internet Explorer web push |
| `windows` | Windows push (tile / toast / badge) |
| `telegram` | ข้อความ Telegram |
| `kakao` | ข้อความ Kakao |
| `line` | ข้อความ LINE |
| `viber` | ข้อความ Viber |
| `whatsapp` | ข้อความ WhatsApp |
| `fb_messenger` | ข้อความ Facebook Messenger |
| `sms` | ข้อความ SMS |
## ฟิลด์พุชทั่วไป
ฟิลด์เหล่านี้ใช้ร่วมกันโดยบล็อก `ios`, `android`, `huawei_android`, `mac_os`, `amazon`, `safari`, `chrome` และ `firefox` (การรองรับแตกต่างกันไป ฟิลด์ที่ไม่ได้ใช้จะถูกละเว้นโดยแพลตฟอร์มที่เกี่ยวข้อง)
- `title` (string): หัวข้อการแจ้งเตือน
- `body` (string): เนื้อหาการแจ้งเตือน
- `time_to_live` (duration, เช่น `"3600s"`): ระยะเวลาที่เซิร์ฟเวอร์ push ควรเก็บการแจ้งเตือนไว้สำหรับอุปกรณ์ที่ออฟไลน์
- `sound` (string): ชื่อไฟล์เสียง
- `sound_enabled` (bool): เปิดหรือปิดเสียง
- `badges` (string): จำนวนป้าย (iOS) หรือที่คล้ายกัน
- `root_params` (object): การแทนที่เพย์โหลดเฉพาะแพลตฟอร์มแบบดิบ
- `inbox` ([`Inbox`](#inbox)): รายการ [Message Inbox](/th/developer/guides/message-inbox/mobile-message-inbox/)
```json
{
"android": {
"title": "Hello",
"body": "Tap to view",
"time_to_live": "3600s",
"sound": "default",
"sound_enabled": true,
"badges": "+1"
}
}
```
## iOS (`ios`)
- `subtitle` (string): หัวข้อย่อยการแจ้งเตือนของ iOS
- `is_critical` (bool): การแจ้งเตือนที่สำคัญ (ต้องมีการให้สิทธิ์)
- `attachment` (string): URL ของไฟล์แนบสื่อ
- `thread_id` (string): ตัวระบุเธรดสำหรับการแจ้งเตือนแบบกลุ่ม
- `trim_content` (bool): ตัดเนื้อหาให้พอดี
- `category_id` (string): ตัวระบุ `UNNotificationCategory` สำหรับการกระทำแบบโต้ตอบ
- `interruption_level` (string): `passive`, `active`, `time-sensitive` หรือ `critical`
- `collapse_id` (string): ตัวระบุการยุบของ APNs การแจ้งเตือนที่มี `collapse_id` เดียวกันจะแทนที่กันบนอุปกรณ์
```json
{
"ios": {
"title": "Hello",
"body": "Tap to view",
"subtitle": "New update",
"attachment": "https://cdn.example.com/image.png",
"interruption_level": "active",
"thread_id": "promo"
}
}
```
## Android (`android`, `huawei_android`)
- `icon` (string): ไอคอนขนาดเล็กของการแจ้งเตือน
- `banner` (string): URL รูปภาพขนาดใหญ่
- `delivery_priority` (`NORMAL` | `HIGH`): ลำดับความสำคัญในการจัดส่งของ FCM
- `vibration` (bool): การสั่นเมื่อได้รับ
- `led_color` (string, hex): สี LED ของการแจ้งเตือน
- `icon_background_color` (string, hex): สีพื้นหลังของไอคอน
- `show_on_lockscreen` (bool): แสดงบนหน้าจอล็อก
- `custom_icon` (string): URL ของไอคอนที่กำหนดเอง
- `priority` ([`NotificationPriority`](#notificationpriority-enum)): ลำดับความสำคัญในถาด
- `group_id` (string): คีย์กลุ่มการแจ้งเตือน
- `collapse_key` (string): คีย์การยุบของ FCM การแจ้งเตือนที่มี `collapse_key` เดียวกันจะแทนที่กันในขณะที่อุปกรณ์ออฟไลน์
```json
{
"android": {
"title": "Hello",
"body": "Tap to view",
"icon": "ic_notification",
"banner": "https://cdn.example.com/banner.png",
"led_color": "#FF0000",
"priority": "PRIORITY_HIGH",
"delivery_priority": "HIGH"
}
}
```
## macOS (`mac_os`)
ใช้ฟิลด์พุชทั่วไปบวกกับ `subtitle` และ `action` (URL ที่เปิดเมื่อผู้ใช้คลิกการแจ้งเตือน)
```json
{
"mac_os": {
"title": "Hello",
"body": "Tap to view",
"subtitle": "New update",
"action": "https://example.com/promo"
}
}
```
## Amazon (`amazon`)
ใช้ฟิลด์พุชทั่วไปบวกกับ `custom_icon` และ `priority` ([`NotificationPriority`](#notificationpriority-enum))
```json
{
"amazon": {
"title": "Hello",
"body": "Tap to view",
"custom_icon": "https://cdn.example.com/icon.png",
"priority": "PRIORITY_HIGH"
}
}
```
## Safari (`safari`)
- `action` (string): URL ที่เปิดเมื่อผู้ใช้คลิกการแจ้งเตือน
- `url_arguments` (array of string): อาร์กิวเมนต์ URL ของ Safari ที่ใช้แทนที่ในเทมเพลต URL ของ Web Push
```json
{
"safari": {
"title": "Hello",
"body": "Tap to view",
"action": "https://example.com/promo",
"url_arguments": ["promo", "2026"]
}
}
```
## Chrome (`chrome`)
- `icon`, `image` (string): URL ไอคอนขนาดเล็กและรูปภาพขนาดใหญ่
- `duration` (duration): ตัวจับเวลาปิดอัตโนมัติ
- `button_text1` / `button_url1`, `button_text2` / `button_url2`: ปุ่มดำเนินการสูงสุดสองปุ่ม
```json
{
"chrome": {
"title": "Hello",
"body": "Tap to view",
"icon": "https://cdn.example.com/icon.png",
"image": "https://cdn.example.com/banner.png",
"duration": "20s",
"button_text1": "Open",
"button_url1": "https://example.com/promo"
}
}
```
## Firefox (`firefox`)
ใช้เฉพาะ `title`, `body`, `icon`, `root_params` และ `inbox`
```json
{
"firefox": {
"title": "Hello",
"body": "Tap to view",
"icon": "https://cdn.example.com/icon.png"
}
}
```
## Windows (`windows`)
Windows ใช้รูปแบบที่แตกต่างกัน:
```json
{
"windows": {
"type": "TOAST",
"template": { "title": "Hello", "body": "Tap to view" },
"tag": "promo",
"cache": true,
"time_to_live": "3600s"
}
}
```
- `type` คือ `TILE`, `TOAST` หรือ `BADGE`
- `template` (มีโครงสร้าง) หรือ `raw` (`{ "content": "" }`) — ต้องมีอย่างใดอย่างหนึ่งเท่านั้น
## Telegram (`telegram`)
- `body` (string): ข้อความ
- `content_variables` (string): ตัวแปรที่แปลงเป็นสตริง JSON สำหรับเทมเพลตฝั่งบอท
```json
{
"telegram": {
"body": "Hello from Pushwoosh",
"content_variables": "{\"name\":\"John\"}"
}
}
```
## Kakao (`kakao`)
- `content` (string): เนื้อหาข้อความ
- `template` (string): รหัสเทมเพลตที่ได้รับอนุมัติ
- `content_variables` (string): การผูกตัวแปรเทมเพลตที่แปลงเป็นสตริง JSON
```json
{
"kakao": {
"content": "Hello from Pushwoosh",
"template": "welcome_v1",
"content_variables": "{\"name\":\"John\"}"
}
}
```
## LINE (`line`)
- `content` (string): เนื้อหาข้อความธรรมดา
- `template` (string): รหัสของเทมเพลต LINE ที่กำหนดค่าใน Pushwoosh Control Panel (ใช้สำหรับส่งข้อความรูปภาพ, carousel หรือ flex) สำหรับเนื้อหา rich content ให้กำหนดค่าเทมเพลตล่วงหน้าใน Control Panel และอ้างอิงที่นี่
ต้องตั้งค่าอย่างน้อยหนึ่งอย่างระหว่าง `content` หรือ `template`
```json
{
"line": {
"content": "Hello from Pushwoosh",
"template": "promo_carousel"
}
}
```
## Viber (`viber`)
ข้อความ Viber อาจเป็นข้อความธรรมดา ซึ่งจะมีรูปภาพและปุ่ม หรือมี carousel ด้วยก็ได้ หรือเป็นเทมเพลตธุรกรรมที่ได้รับการอนุมัติล่วงหน้า (Omni Messaging / MStat) ซึ่งอ้างอิงโดย id และภาษา
- `body` (string): ข้อความธรรมดา จำเป็นเมื่อไม่ได้ตั้งค่า `template_id` เว้นแต่จะตั้งค่า `image` ไว้ จำเป็นเมื่อมีปุ่มหรือ carousel
- `image` (string): URL สาธารณะของรูปภาพ จะถูกละเว้นเมื่อตั้งค่า `template_id`
- `button_caption` (string): ข้อความบนปุ่ม ไม่เกิน 30 อักขระ ตั้งค่าคู่กับ `button_action` ต้องมี `body` จะถูกละเว้นเมื่อตั้งค่า `template_id`
- `button_action` (string): ลิงก์ของปุ่ม: URL แบบ `http://` หรือ `https://`, deep link แบบ `viber://` หรือโทเค็น Omni เช่น `{lp-100}` (ตัวยึดตำแหน่งของลิงก์ติดตามที่ Omni Messaging แปลงค่าในขณะส่ง) ตั้งค่าคู่กับ `button_caption`
- `carousel` (object): การ์ดที่ปัดดูได้ 2–5 ใบซึ่งแสดงอยู่ใต้ `body` ใช้ร่วมกับ `image`, `button_caption`, `button_action` หรือ `template_id` ไม่ได้ ดู [Carousel](#carousel)
- `template_id` (string): id ของเทมเพลตธุรกรรมที่ได้รับการอนุมัติล่วงหน้า เมื่อตั้งค่าแล้ว จะมีความสำคัญเหนือกว่า `body`
- `template_lang` (string): locale ของเทมเพลต จำเป็นเมื่อตั้งค่า `template_id`
- `template_params` (map<string, string>): การผูกค่าคีย์/ค่าที่ใช้แทนที่ในเทมเพลต เช่น `{ "name": "John", "code": "123456" }`
- `all_devices` (bool): `false` (ค่าเริ่มต้น) ส่งไปยังอุปกรณ์หลักของผู้ใช้เท่านั้น `true` ส่งไปยังอุปกรณ์ทั้งหมดของผู้ใช้
ต้องตั้งค่าอย่างน้อยหนึ่งอย่างระหว่าง `body`, `image` หรือ `template_id` เมื่อตั้งค่า `template_id` แล้ว `template_lang` จะเป็นสิ่งจำเป็น
ระบุผู้รับ Viber เป็น hwids ในรูปแบบ `viber:` (E.164) ตัวอย่างเช่น `viber:+1234567890`
ข้อความธรรมดา:
```json
{
"viber": {
"body": "Hello from Pushwoosh"
}
}
```
เทมเพลตธุรกรรม:
```json
{
"viber": {
"template_id": "e3dec4a0-c063-4b0f-96d5-cf9d629a7abe",
"template_lang": "en",
"template_params": {
"name": "John",
"code": "123456",
"expires_in": "5 minutes"
},
"all_devices": false
}
}
```
### Carousel
`carousel.items` มีการ์ด 2 ถึง 5 ใบ หากต้องการตั้งค่า carousel ใน journey แทน ดู [ส่ง carousel](/th/product/customer-journey/journey-elements/channels/viber/#send-a-carousel) การ์ดแต่ละใบมีฟิลด์ต่อไปนี้:
- `title` (string): ชื่อการ์ด 2–38 อักขระ จำเป็น
- `image` (string): URL สาธารณะของรูปภาพแบบ `http://` หรือ `https://` จำเป็น
- `primary_button` (object): ปุ่มหลัก จำเป็น
- `secondary_button` (object): ปุ่มที่สอง ไม่บังคับ
ปุ่มแต่ละปุ่มมีสองฟิลด์ และทั้งสองฟิลด์จำเป็นเมื่อมีปุ่มนั้น:
- `caption` (string): ข้อความบนปุ่ม ไม่เกิน 10 อักขระสำหรับ `primary_button` และไม่เกิน 12 อักขระสำหรับ `secondary_button`
- `action` (string): ลิงก์ของปุ่ม: URL ที่มี scheme (`http://`, `https://`, `viber://`) หรือโทเค็น Omni เช่น `{lp-100}` ซึ่งเป็นค่าเดียวกับ `button_action`
คำขอที่ละเมิดกฎข้อใดข้อหนึ่งเหล่านี้จะถูกปฏิเสธด้วย `INVALID_ARGUMENT` รายละเอียด `google.rpc.BadRequest` จะระบุชื่อฟิลด์ เช่น `viber.carousel.items[0].title`
ตัวอย่าง:
```json
{
"viber": {
"body": "New arrivals are in. Swipe to see them.",
"carousel": {
"items": [
{
"title": "Running shoes",
"image": "https://example.com/img/shoes.jpg",
"primary_button": { "caption": "Buy now", "action": "https://example.com/shoes" },
"secondary_button": { "caption": "Details", "action": "{lp-100}" }
},
{
"title": "Sports backpack",
"image": "https://example.com/img/backpack.jpg",
"primary_button": { "caption": "Buy now", "action": "https://example.com/backpack" }
}
]
}
}
}
```
## WhatsApp (`whatsapp`)
ข้อความ WhatsApp จะส่งผ่าน Meta และอยู่ภายใต้กฎการส่งข้อความของ Meta การแบ่งหลักคือระหว่างข้อความรูปแบบอิสระ (ส่งได้เฉพาะภายในหน้าต่างบริการลูกค้า 24 ชั่วโมงที่เปิดโดยข้อความขาเข้าจากผู้ใช้) และเทมเพลตที่ได้รับอนุมัติ (จำเป็นสำหรับการเริ่มต้นการส่งออกและสำหรับข้อความใดๆ นอกหน้าต่าง 24 ชั่วโมง)
- `content` (string): ข้อความรูปแบบอิสระ Meta จะส่งให้เฉพาะภายในหน้าต่าง 24 ชั่วโมงเท่านั้น
- `content_id` (string): ชื่อของเทมเพลต Meta ที่ได้รับการอนุมัติล่วงหน้า (เช่น `"hello_world"`) จำเป็นสำหรับการเริ่มต้นการส่งออกหรือข้อความใดๆ นอกหน้าต่าง 24 ชั่วโมง
- `language` (string): locale ของเทมเพลตที่ต้องตรงกับ locale ที่ได้รับอนุมัติใน Meta (เช่น `"en_US"`, `"en_GB"`) มีความหมายเฉพาะเมื่อใช้ร่วมกับ `content_id` เท่านั้น สิ่งนี้ไม่ขึ้นอยู่กับคีย์ `LocalizedContent` ภายนอก คีย์ภายนอกจะเลือกเนื้อหาสำหรับอุปกรณ์ และ `language` จะเลือก locale ของเทมเพลต Meta สำหรับเนื้อหานั้น
- `content_variables` (string): อ็อบเจกต์ JSON ที่แมปตัวยึดตำแหน่งในเนื้อหา เช่น `"{\"1\":\"John\"}"`
- `button_url_variables` (string): อ็อบเจกต์ JSON ที่แมปตัวยึดตำแหน่ง URL ของปุ่มโดยใช้ดัชนีปุ่มเป็นคีย์ เช่น `"{\"0\":\"https://...\"}"`
- `header_variables` (string): อ็อบเจกต์ JSON ที่แมปตัวยึดตำแหน่งส่วนหัวโดยใช้ประเภทเป็นคีย์ เช่น `"{\"image\":\"https://...\"}"`
ต้องตั้งค่าอย่างน้อยหนึ่งอย่างระหว่าง `content` หรือ `content_id`
```json
{
"whatsapp": {
"content_id": "hello_world",
"language": "en_US",
"content_variables": "{\"1\":\"John\"}"
}
}
```
## Facebook Messenger (`fb_messenger`)
ข้อความ Facebook Messenger จะส่งผ่าน Meta และอยู่ภายใต้กฎการส่งข้อความของ Meta: เนื้อหารูปแบบอิสระจะถูกส่งเฉพาะภายในหน้าต่างบริการลูกค้า 24 ชั่วโมงที่เปิดโดยข้อความขาเข้าจากผู้ใช้เท่านั้น นอกหน้าต่างนั้น ให้ตั้งค่า `message_tag` เป็นหนึ่งในกรณีการใช้งานที่ได้รับอนุมัติจาก Meta มิฉะนั้น Meta จะปฏิเสธการส่ง
- `body` (string): ข้อความธรรมดา Facebook Messenger ไม่รองรับเทมเพลตหรือปุ่ม ดังนั้นนี่คือฟิลด์เนื้อหาเพียงอย่างเดียว
- `message_tag` (string): จำเป็นต้องระบุนอกหน้าต่าง 24 ชั่วโมง หนึ่งใน `CONFIRMED_EVENT_UPDATE`, `POST_PURCHASE_UPDATE`, `ACCOUNT_UPDATE`, `HUMAN_AGENT`
```json
{
"fb_messenger": {
"body": "Hello from Pushwoosh",
"message_tag": "ACCOUNT_UPDATE"
}
}
```
สำหรับช่องทางนี้ ไม่มีตัวระบุอุปกรณ์แยกต่างหาก: `hwid`, `push_token` และ `user_id` ทั้งหมดจะถูกแก้ไขเป็นค่าเดียวกัน คือ Page-Scoped ID (PSID) ของผู้รับใน Meta กำหนดเป้าหมายการสนทนาที่เฉพาะเจาะจงด้วยหนึ่งในนั้นใน [`NotifyTransactional`](/th/developer/api-reference/messaging-api-v2/notify/#notifytransactional)
```bash
curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"transactional": {
"application": "XXXXX-XXXXX",
"platforms": ["FB_MESSENGER"],
"hwids": { "list": [""] },
"payload": {
"content": {
"localized_content": {
"default": {
"fb_messenger": { "body": "Hello from Pushwoosh" }
}
}
}
},
"schedule": { "at": "2026-05-01T12:00:00Z" }
}
}'
```
## SMS (`sms`)
SMS มีบล็อกแพลตฟอร์มของตัวเองภายใน [`Content`](#localizedcontent) ของแต่ละ locale ควบคู่ไปกับ `ios`, `android` และช่องทางการส่งข้อความอื่นๆ
- `body` (string): ข้อความ SMS สำหรับ locale นั้นๆ จำเป็นเมื่อมีบล็อก `sms` อยู่
มีสองวิธีในการให้ข้อความ:
- **อินไลน์** — ตั้งค่า `sms.body` ต่อ locale ใน `localized_content`
- **จาก preset** — ตั้งค่า [`sms_preset`](#payload) ระดับเพย์โหลดเป็นรหัส (รูปแบบ `XXXXX-XXXXX`) ของ [SMS preset](/th/product/content/sms-presets/) ที่บันทึกไว้ เนื้อหาต่อ locale ของมันจะถูกแก้ไขเป็น `sms.body` สำหรับแต่ละ locale ที่ preset กำหนด `sms.body` แบบอินไลน์สำหรับ locale จะแทนที่ preset สำหรับ locale นั้น ทำให้คุณสามารถใช้ preset ซ้ำและยังคงปรับแต่งแต่ละภาษาได้
```json
{
"payload": {
"sms_preset": "XXXXX-XXXXX",
"content": {
"localized_content": {
"default": { "sms": { "body": "Your order has shipped." } },
"es": { "sms": { "body": "Tu pedido ha sido enviado." } }
}
}
}
}
```
### MMS
การเพิ่ม `subject` และ `file_urls` ลงในบล็อก `sms` จะเปลี่ยนข้อความเป็น MMS มีเพียง [AbleMobile](https://ablemobile.com/) เท่านั้นที่มี endpoint สำหรับ MMS — ผู้ให้บริการ SMS รายอื่นจะละเว้นทั้งสองฟิลด์และส่งเฉพาะ `body` ที่เป็นข้อความธรรมดา
- `subject` (string): หัวเรื่อง MMS ต้องมีอย่างน้อยหนึ่งรายการใน `file_urls` — หัวเรื่องที่ไม่มีไฟล์แนบจะถูกปฏิเสธ รองรับอักขระ ASCII ได้สูงสุด 40 ตัว หรือ 13 ตัวหากหัวเรื่องมีอักขระที่ไม่ใช่ ASCII
- `file_urls` (array of string): URL ไฟล์แนบสูงสุด 3 รายการ แต่ละรายการต้องเป็น URL `https` แบบสมบูรณ์ที่ลงท้ายด้วย `.jpg` หรือ `.gif` — `.jpeg` และ `.png` จะถูกปฏิเสธโดยการตรวจสอบความถูกต้อง แม้ว่าจะเป็นไฟล์ JPEG หรือ PNG จริงก็ตาม เนื่องจากผู้ให้บริการไม่สามารถถอดรหัสได้ นอกจากนี้แต่ละไฟล์ต้องมีขนาดไม่เกิน 200 KB AbleMobile จะปฏิเสธการส่งทั้งหมดหากมีไฟล์แนบใดหนักกว่านี้
- `message_at` (int): ดัชนีใน `file_urls` (เริ่มต้นที่ 0) ที่ข้อความ SMS จะแสดงหลังจากนั้น
`subject` และ `file_urls` รองรับ [การปรับแต่ง Liquid](/th/developer/guides/personalization/liquid-templates/) เช่นเดียวกับ `body`
```json
{
"sms": {
"body": "Your order has shipped.",
"subject": "Order update",
"file_urls": [
"https://cdn.example.com/shipping-label.jpg",
"https://cdn.example.com/tracking-map.gif"
],
"message_at": 1
}
}
```
## OpenAction
กำหนดการกระทำที่จะดำเนินการเมื่อผู้ใช้เปิดข้อความ
ต้องมีอย่างใดอย่างหนึ่ง:
- `rich_media` ([`RichMedia`](#richmedia)): เปิดหน้า [Rich Media](/th/product/content/in-apps/)
- `deep_link`: เปิด deep link: `{ "code": "flow-code", "params": { "key": "value" } }`
- `link` ([`Link`](#link)): เปิด URL
```json
{
"open_action": {
"deep_link": { "code": "flow-code", "params": { "promo": "summer" } }
}
}
```
URL ของ deeplink และค่า `params` รองรับไวยากรณ์ [การปรับแต่ง Liquid](/th/developer/guides/personalization/liquid-templates/) — นิพจน์จะถูกประมวลผลก่อนที่จะเปิด deep link
### RichMedia
```json
{ "code": "XXXXX-XXXXX" } // โดยรหัส Rich Media
{ "url": "https://..." } // โดย URL ระยะไกล
```
### Link
```json
{
"url": "https://example.com/promo",
"shortener": "BITLY"
}
```
`shortener` คือ `NONE` (ค่าเริ่มต้น) หรือ `BITLY`
## Inbox
กำหนดค่าลักษณะที่ข้อความจะปรากฏใน Message Inbox
```json
{
"image_url": "https://cdn.example.com/inbox.png",
"expiration_date": "2026-05-15T00:00:00Z"
}
```
- `image_url` (string): รูปภาพที่แสดงในรายการ inbox
- `expiration_date` (timestamp): เวลาที่รายการจะถูกลบออกจาก inbox
## NotificationPriority enum
ควบคุมลำดับความสำคัญของการแจ้งเตือนบนอุปกรณ์เป้าหมาย ตั้งแต่ `PRIORITY_MIN` (ต่ำสุด) ถึง `PRIORITY_MAX` (สูงสุด)
- `PRIORITY_UNSPECIFIED`
- `PRIORITY_MIN`
- `PRIORITY_LOW`
- `PRIORITY_DEFAULT`
- `PRIORITY_HIGH`
- `PRIORITY_MAX`
## ตัวอย่าง: ส่งพุชไปยังเซกเมนต์
```bash
curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"segment": {
"application": "XXXXX-XXXXX",
"platforms": ["IOS", "ANDROID"],
"code": "active_users",
"payload": {
"content": {
"localized_content": {
"en": {
"ios": { "title": "Hello", "body": "Hello, world!" },
"android": { "title": "Hello", "body": "Hello, world!" }
},
"es": {
"ios": { "title": "¡Hola!", "body": "¡Hola, mundo!" },
"android": { "title": "¡Hola!", "body": "¡Hola, mundo!" }
}
}
},
"open_action": { "link": { "url": "https://example.com/promo" } }
},
"schedule": { "at": "2026-05-01T12:00:00Z" },
"message_type": "MESSAGE_TYPE_MARKETING"
}
}'
```
## ตัวอย่าง: พุชธุรกรรมตาม User ID
```bash
curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"transactional": {
"application": "XXXXX-XXXXX",
"platforms": ["IOS", "ANDROID"],
"users": { "list": ["customer-42"] },
"payload": {
"content": {
"localized_content": {
"default": {
"ios": { "title": "Your order", "body": "Order #42 has shipped." },
"android": { "title": "Your order", "body": "Order #42 has shipped." }
}
}
},
"custom_data": { "order_id": "42" }
},
"schedule": { "at": "2026-05-01T12:00:00Z" },
"message_type": "MESSAGE_TYPE_TRANSACTIONAL"
}
}'
```