ข้ามไปยังเนื้อหา
คู่มือผู้ใช้การสนับสนุน ขอสาธิต เข้าสู่ระบบ
Pushwoosh.com

SMS API

createSMSMessage เลิกใช้งานแล้ว

Anchor link to

ใช้เพื่อส่งการแจ้งเตือนทาง SMS ไปยังผู้ใช้

POST https://api.pushwoosh.com/json/1.3/createSMSMessage

เนื้อหาของคำขอ

Anchor link to
ชื่อจำเป็นประเภทคำอธิบาย
auth*ใช่stringโทเค็นการเข้าถึง API จาก Pushwoosh Control Panel
application*ใช่stringรหัสแอปพลิเคชัน Pushwoosh
notifications*ใช่arrayการตั้งค่าเนื้อหา อาร์เรย์ JSON ของพารามิเตอร์ข้อความ ดูรายละเอียดด้านล่าง

พารามิเตอร์การแจ้งเตือน

ชื่อจำเป็นประเภทคำอธิบาย
send_date*ใช่stringวันที่และเวลาที่จะส่งการแจ้งเตือน ใช้รูปแบบ YYYY-MM-DD HH:mm หรือ now เพื่อส่งทันที
content*ใช่stringเนื้อหาข้อความของข้อความ SMS
devices*ใช่arrayหมายเลขโทรศัพท์ของลูกค้า (ต้องเชื่อมโยงกับ UserId โดยใช้ /registerDevice และระบุในพารามิเตอร์ hwid หรือใช้ use_auto_registration) สามารถระบุได้เพียงหมายเลขเดียวที่นี่
use_auto_registrationไม่booleanหากตั้งค่าเป็น true หมายเลขโทรศัพท์ที่ระบุในพารามิเตอร์ devices จะถูกลงทะเบียนโดยอัตโนมัติ
dynamic_content_placeholdersไม่objectตัวยึดตำแหน่งเนื้อหาแบบไดนามิกเพื่อปรับแต่งเนื้อหาข้อความ ตัวยึดตำแหน่งแต่ละตัวจะถูกแทนที่ด้วยค่าไดนามิกที่สอดคล้องกัน
presetไม่stringรหัส Preset SMS จาก Control Panel ของคุณ

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

Anchor link to
{
  "request": {
    "application": "12345-67891",    // จำเป็น รหัสแอปพลิเคชัน Pushwoosh
    "auth": "yxoPUlwqm…………pIyEX4H",  // จำเป็น โทเค็นการเข้าถึง API จาก Pushwoosh Control Panel
    "notifications": [{
      "send_date": "now",            // จำเป็น YYYY-MM-DD HH:mm หรือ "now"
      "content": "Hello!",           // จำเป็น ข้อความ SMS (สตริง)
      "devices": ["+1234567890"],    // จำเป็น หมายเลขโทรศัพท์ของลูกค้า (ต้องเชื่อมโยงกับ
                                     //           UserId โดยใช้ /registerDevice และระบุใน
                                     //           พารามิเตอร์ "hwid" หรือใช้ "use_auto_registration")
                                     //           สามารถระบุได้เพียงหมายเลขเดียวที่นี่
      "preset": "XXXXX-XXXXX",       // ไม่จำเป็น รหัส Preset SMS จาก Control Panel ของคุณ
      "use_auto_registration": true  // ไม่จำเป็น ลงทะเบียนหมายเลขโทรศัพท์ที่ระบุ
                                     //           ในพารามิเตอร์ "devices" โดยอัตโนมัติ
    }]
  }
}

ตัวอย่างการตอบกลับ

Anchor link to
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "9648-0B10ECB6-0D9F214D"
    ]
  }
}

การตอบกลับข้อผิดพลาด

Anchor link to
{
  "status_code": 210,
  "status_message": "Invalid devices list. \"devices\" must be an array.",
  "response": {
    "Messages": []
  }
}

หากต้องการดูสถิติ SMS ให้ใช้วิธีการ totalsByIntervals

คุณยังสามารถดูสถิติสำหรับแต่ละข้อความได้ในส่วน ประวัติข้อความ