काकाओ API

createKakaoMessage

उपयोगकर्ताओं को काकाओ संदेश भेजने के लिए उपयोग किया जाता है।

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

नोट

यह एंडपॉइंट केवल काकाओ मैसेजिंग के लिए समर्पित है। मल्टी-चैनल मैसेजिंग के लिए, /createMessage का उपयोग करें।

पूर्वापेक्षाएँ

इस एंडपॉइंट का उपयोग करने से पहले, सुनिश्चित करें:

1. काकाओ प्लेटफ़ॉर्म कॉन्फ़िगर किया गया है: आपके Pushwoosh एप्लिकेशन में काकाओ क्रेडेंशियल कॉन्फ़िगर होने चाहिए। और जानें

2. टेम्प्लेट स्वीकृत हैं: काकाओ टेम्प्लेट का उपयोग करने से पहले उन्हें बनाया और स्वीकृत किया जाना चाहिए। और जानें

3. डिवाइस पंजीकृत हैं: काकाओ एंडपॉइंट के रूप में पहचाने जाने के लिए डिवाइस को kakao: उपसर्ग के साथ पंजीकृत किया जाना चाहिए।

अनुरोध बॉडी

नाम	आवश्यक	प्रकार	विवरण
auth*	हाँ	string	Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन।
application*	हाँ	string	Pushwoosh एप्लिकेशन कोड
notifications*	हाँ	array	अधिसूचना ऑब्जेक्ट्स का ऐरे। नीचे विवरण देखें।

अधिसूचना पैरामीटर

नाम	आवश्यक	प्रकार	विवरण
send_date*	हाँ	string	संदेश भेजने की तारीख और समय। तुरंत भेजने के लिए YYYY-MM-DD HH:MM:SS (UTC) प्रारूप या "now" का उपयोग करें। सभी समय UTC के रूप में माने जाते हैं।
devices*	यदि users प्रदान नहीं किया गया है तो आवश्यक है	array[string]	डिवाइस टोकन की सूची। प्रत्येक टोकन को kakao: के साथ उपसर्ग किया जाना चाहिए (उदाहरण के लिए, "kakao:user_token")।
users*	यदि devices प्रदान नहीं किया गया है तो आवश्यक है	array[string]	लक्षित करने के लिए उपयोगकर्ता आईडी की सूची।
template*	हाँ	string	काकाओ टेम्प्लेट का नाम। एक पूर्व-अनुमोदित टेम्प्लेट होना चाहिए। और जानें
kakao_content_variables	नहीं	object	टेम्प्लेट चर प्रतिस्थापन के लिए कुंजी-मूल्य जोड़े। कुंजियों को आपके काकाओ टेम्प्लेट में परिभाषित चरों से मेल खाना चाहिए। वैकल्पिक है लेकिन आपके काकाओ संदेशों के गतिशील निजीकरण की अनुमति देता है।

महत्वपूर्ण

आपको devices या users में से कोई एक प्रदान करना होगा, लेकिन दोनों खाली नहीं होने चाहिए।

निषिद्ध पैरामीटर

इस एंडपॉइंट के लिए निम्नलिखित पैरामीटर की अनुमति नहीं है और इससे एक सत्यापन त्रुटि होगी:

• platforms: प्लेटफ़ॉर्म स्वचालित रूप से काकाओ पर सेट हो जाता है।
• filter: डिवाइस फ़िल्टरिंग समर्थित नहीं है।
• filter_code: फ़िल्टर कोड समर्थित नहीं हैं।
• conditions: सशर्त लक्ष्यीकरण समर्थित नहीं है।

अनुरोध का उदाहरण

{
  "request": {
    "auth": "your-api-access-token",        // आवश्यक। Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन।
    "application": "XXXXX-XXXXX",           // आवश्यक। Pushwoosh एप्लिकेशन कोड।
    "notifications": [
      {
        "send_date": "now",                 // आवश्यक। YYYY-MM-DD HH:MM:SS (UTC) या "now"।
        "devices": ["kakao:user123@kakao.com", "kakao:device_abc"],  // यदि users प्रदान नहीं किया गया है तो आवश्यक है। kakao: उपसर्ग के साथ डिवाइस टोकन।
        "users": ["user_001", "user_002"],  // यदि devices प्रदान नहीं किया गया है तो आवश्यक है। लक्षित करने के लिए उपयोगकर्ता आईडी।
        "template": "welcome_message",      // आवश्यक। काकाओ टेम्प्लेट का नाम (पूर्व-अनुमोदित होना चाहिए)।
        "kakao_content_variables": {        // वैकल्पिक। टेम्प्लेट चर प्रतिस्थापन।
          "user_name": "John Doe",
          "order_number": "12345"
        }
      }
    ]
  }
}

प्रतिक्रिया का उदाहरण

200

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

फ़ील्ड	प्रकार	विवरण
Messages	array[string]	ट्रैकिंग के लिए बनाए गए संदेश आईडी का ऐरे
Warnings	array	प्रसंस्करण के दौरान उत्पन्न कोई भी चेतावनी
UnknownDevices	object	वे डिवाइस जो नहीं मिल सके
UnknownUsers	object	उपयोगकर्ता आईडी जिन्हें हल नहीं किया जा सका
FailedDevices	object	वे डिवाइस जो प्रसंस्करण के दौरान विफल हो गए
UnknownPhoneNumbers	object	वे फ़ोन नंबर जो नहीं मिल सके

210

{
  "status_code": 210,
  "status_message": "त्रुटि का विवरण"
}

सामान्य त्रुटि संदेश

त्रुटि संदेश	कारण
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	टेम्प्लेट मौजूद है लेकिन काकाओ द्वारा अनुमोदित नहीं है
Please configure Kakao platform	एप्लिकेशन में काकाओ क्रेडेंशियल कॉन्फ़िगर नहीं हैं

500

{
  "status_code": 500,
  "status_message": "आंतरिक सर्वर त्रुटि"
}

कोड के उदाहरण

cURL

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

<?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;

Python

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"
      }
    ]
  }
}