কাকাও API

createKakaoMessage

ব্যবহারকারীদের কাকাও বার্তা পাঠাতে এই এন্ডপয়েন্টটি ব্যবহার করুন।

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

পূর্বশর্ত

এই এন্ডপয়েন্টটি ব্যবহার করার আগে, নিশ্চিত করুন:

কাকাও প্ল্যাটফর্ম কনফিগার করা আছে: আপনার Pushwoosh অ্যাপ্লিকেশনে অবশ্যই কাকাও ক্রেডেনশিয়াল কনফিগার করা থাকতে হবে। আরও জানুন
টেমপ্লেট অনুমোদিত: কাকাও টেমপ্লেট ব্যবহার করার আগে অবশ্যই তৈরি এবং অনুমোদিত হতে হবে। আরও জানুন
ডিভাইস নিবন্ধিত: কাকাও এন্ডপয়েন্ট হিসাবে স্বীকৃত হওয়ার জন্য ডিভাইসগুলিকে অবশ্যই 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	টেমপ্লেট ভেরিয়েবল প্রতিস্থাপনের জন্য কী-ভ্যালু পেয়ার। কীগুলি আপনার কাকাও টেমপ্লেটে সংজ্ঞায়িত ভেরিয়েবলের সাথে মিলতে হবে। ঐচ্ছিক কিন্তু আপনার কাকাও বার্তাগুলির গতিশীল ব্যক্তিগতকরণের অনুমতি দেয়।

নিষিদ্ধ প্যারামিটার

এই এন্ডপয়েন্টের জন্য নিম্নলিখিত প্যারামিটারগুলি অনুমোদিত নয় এবং এর ফলে একটি বৈধতা ত্রুটি হবে:

platforms: প্ল্যাটফর্মটি স্বয়ংক্রিয়ভাবে কাকাওতে সেট করা হয়
filter: ডিভাইস ফিল্টারিং সমর্থিত নয়
filter_code: ফিল্টার কোড সমর্থিত নয়
conditions: শর্তসাপেক্ষ টার্গেটিং সমর্থিত নয়

অনুরোধের উদাহরণ

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

প্রতিক্রিয়ার উদাহরণ

{
  "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	যে ফোন নম্বরগুলি খুঁজে পাওয়া যায়নি

{
  "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`	টেমপ্লেট বিদ্যমান কিন্তু কাকাও দ্বারা অনুমোদিত নয়
`Please configure Kakao platform`	অ্যাপ্লিকেশনে কাকাও ক্রেডেনশিয়াল কনফিগার করা নেই

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