Kakao API

createKakaoMessage

ใช้สำหรับส่งข้อความ Kakao ไปยังผู้ใช้

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

ข้อกำหนดเบื้องต้น

ก่อนใช้ endpoint นี้ โปรดตรวจสอบให้แน่ใจว่า:

กำหนดค่าแพลตฟอร์ม Kakao แล้ว: แอปพลิเคชัน Pushwoosh ของคุณต้องได้รับการกำหนดค่าข้อมูลประจำตัวของ Kakao เรียนรู้เพิ่มเติม
เทมเพลตได้รับการอนุมัติแล้ว: ต้องสร้างและอนุมัติเทมเพลต Kakao ก่อนจึงจะสามารถใช้งานได้ เรียนรู้เพิ่มเติม
อุปกรณ์ได้รับการลงทะเบียนแล้ว: อุปกรณ์ต้องลงทะเบียนด้วยคำนำหน้า kakao: เพื่อให้รู้จักว่าเป็น endpoint ของ Kakao

Request body

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
auth*	Yes	string	API access token จาก Pushwoosh Control Panel
application*	Yes	string	รหัสแอปพลิเคชัน Pushwoosh
notifications*	Yes	array	อาร์เรย์ของอ็อบเจกต์การแจ้งเตือน ดูรายละเอียดด้านล่าง

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

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
send_date*	Yes	string	วันที่และเวลาที่จะส่งข้อความ ใช้รูปแบบ `YYYY-MM-DD HH:MM:SS` (UTC) หรือ `"now"` เพื่อส่งทันที เวลาทั้งหมดจะถูกตีความว่าเป็น UTC
devices*	Required if `users` is not provided	array[string]	รายการโทเค็นอุปกรณ์ แต่ละโทเค็นต้องมีคำนำหน้า `kakao:` (เช่น `"kakao:user_token"`)
users*	Required if `devices` is not provided	array[string]	รายการ User ID ที่ต้องการส่งถึง
template*	Yes	string	ชื่อเทมเพลต Kakao ต้องเป็นเทมเพลตที่ได้รับการอนุมัติล่วงหน้า เรียนรู้เพิ่มเติม
kakao_content_variables	No	object	คู่คีย์-ค่าสำหรับการแทนที่ตัวแปรในเทมเพลต คีย์ต้องตรงกับตัวแปรที่กำหนดไว้ในเทมเพลต Kakao ของคุณ เป็นทางเลือกแต่ช่วยให้สามารถปรับแต่งข้อความ Kakao ของคุณแบบไดนามิกได้

พารามิเตอร์ที่ห้ามใช้

พารามิเตอร์ต่อไปนี้ไม่ได้รับอนุญาตสำหรับ endpoint นี้ และจะส่งผลให้เกิดข้อผิดพลาดในการตรวจสอบความถูกต้อง:

platforms: แพลตฟอร์มถูกตั้งค่าเป็น Kakao โดยอัตโนมัติ
filter: ไม่รองรับการกรองอุปกรณ์
filter_code: ไม่รองรับรหัสตัวกรอง
conditions: ไม่รองรับการกำหนดเป้าหมายตามเงื่อนไข

ตัวอย่าง Request

{
  "request": {
    "auth": "your-api-access-token",        // required. API access token from Pushwoosh Control Panel.
    "application": "XXXXX-XXXXX",           // required. Pushwoosh application code.
    "notifications": [
      {
        "send_date": "now",                 // required. YYYY-MM-DD HH:MM:SS (UTC) OR "now".
        "devices": ["kakao:user123@kakao.com", "kakao:device_abc"],  // required if users is not provided. Device tokens with kakao: prefix.
        "users": ["user_001", "user_002"],  // required if devices is not provided. User IDs to target.
        "template": "welcome_message",      // required. Kakao template name (must be pre-approved).
        "kakao_content_variables": {        // optional. Template variable substitution.
          "user_name": "John Doe",
          "order_number": "12345"
        }
      }
    ]
  }
}

ตัวอย่าง Response

{
  "status_code": 200,
  "response": {
    "Messages": ["MESSAGE_ID_1"],
    "Warnings": [],
    "UnknownDevices": {},
    "UnknownUsers": {},
    "FailedDevices": {},
    "UnknownPhoneNumbers": {}
  }
}

ฟิลด์	ประเภท	คำอธิบาย
`Messages`	array[string]	อาร์เรย์ของ ID ข้อความที่สร้างขึ้นสำหรับการติดตาม
`Warnings`	array	คำเตือนใดๆ ที่สร้างขึ้นระหว่างการประมวลผล
`UnknownDevices`	object	อุปกรณ์ที่ไม่พบ
`UnknownUsers`	object	User ID ที่ไม่สามารถระบุได้
`FailedDevices`	object	อุปกรณ์ที่ล้มเหลวระหว่างการประมวลผล
`UnknownPhoneNumbers`	object	หมายเลขโทรศัพท์ที่ไม่พบ

{
  "status_code": 210,
  "status_message": "Error description"
}

ข้อความแสดงข้อผิดพลาดทั่วไป

ข้อความแสดงข้อผิดพลาด	สาเหตุ
`Missing required parameter: send_date`	ไม่ได้ระบุฟิลด์ `send_date` ในการแจ้งเตือน
`Missing required parameter: devices or users`	ไม่ได้ระบุอาร์เรย์ `devices` หรือ `users`
`Invalid Kakao devices list`	โทเค็นอุปกรณ์อย่างน้อยหนึ่งรายการไม่มีคำนำหน้า `kakao:`
`Invalid parameter: platforms`	พยายามตั้งค่าแพลตฟอร์มด้วยตนเอง (ไม่ได้รับอนุญาต)
`Kakao template is required`	ไม่ได้ระบุชื่อเทมเพลต
`Invalid Kakao template`	เทมเพลตที่ระบุไม่มีอยู่
`Kakao template not approved`	เทมเพลตมีอยู่แต่ไม่ได้รับการอนุมัติจาก Kakao
`Please configure Kakao platform`	แอปพลิเคชันไม่ได้กำหนดค่าข้อมูลประจำตัวของ Kakao

{
  "status_code": 500,
  "status_message": "Internal server error"
}

ตัวอย่างโค้ด

curl -X POST "https://api.pushwoosh.com/json/1.3/createKakaoMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "auth": "your-api-access-token",
      "application": "XXXXX-XXXXX",
      "notifications": [
        {
          "send_date": "now",
          "devices": ["kakao:user123@kakao.com", "kakao:device_abc"],
          "template": "welcome_message",
          "kakao_content_variables": {
            "user_name": "John Doe",
            "order_number": "12345"
          }
        }
      ]
    }
  }'

<?php
$url = 'https://api.pushwoosh.com/json/1.3/createKakaoMessage';

$data = [
    'request' => [
        'auth' => 'your-api-access-token',
        'application' => 'XXXXX-XXXXX',
        'notifications' => [
            [
                'send_date' => 'now',
                'devices' => ['kakao:user123@kakao.com', 'kakao:device_abc'],
                'template' => 'welcome_message',
                'kakao_content_variables' => [
                    'user_name' => 'John Doe',
                    'order_number' => '12345'
                ]
            ]
        ]
    ]
];

$options = [
    'http' => [
        'header'  => "Content-Type: application/json\r\n",
        'method'  => 'POST',
        'content' => json_encode($data)
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;

import requests

url = "https://api.pushwoosh.com/json/1.3/createKakaoMessage"

payload = {
    "request": {
        "auth": "your-api-access-token",
        "application": "XXXXX-XXXXX",
        "notifications": [
            {
                "send_date": "now",
                "devices": ["kakao:user123@kakao.com", "kakao:device_abc"],
                "template": "welcome_message",
                "kakao_content_variables": {
                    "user_name": "John Doe",
                    "order_number": "12345"
                }
            }
        ]
    }
}

response = requests.post(url, json=payload)
print(response.json())

ตัวอย่าง: การส่งไปยังผู้ใช้แทนอุปกรณ์

{
  "request": {
    "auth": "your-api-access-token",
    "application": "XXXXX-XXXXX",
    "notifications": [
      {
        "send_date": "now",
        "users": ["user_001", "user_002", "user_003"],
        "template": "promotion_alert",
        "kakao_content_variables": {
          "discount_percent": "20",
          "promo_code": "SAVE20"
        }
      }
    ]
  }
}

ตัวอย่าง: ข้อความที่ตั้งเวลาไว้

{
  "request": {
    "auth": "your-api-access-token",
    "application": "XXXXX-XXXXX",
    "notifications": [
      {
        "send_date": "2024-12-25 09:00:00",
        "devices": ["kakao:user123"],
        "template": "holiday_greeting"
      }
    ]
  }
}