বিষয়বস্তুতে যান
ব্যবহারকারী গাইডসাপোর্ট ডেমো অনুরোধ করুন সাইন ইন করুন
Pushwoosh.com

WhatsApp API

createWhatsAppMessage

Anchor link to

ব্যবহারকারীদের WhatsApp বার্তা পাঠাতে ব্যবহৃত হয়।

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

রিকোয়েস্ট বডি

Anchor link to
নাম
প্রয়োজনীয়
টাইপবিবরণ
auth*হ্যাঁstringPushwoosh কন্ট্রোল প্যানেল থেকে প্রাপ্ত API access token।
application*হ্যাঁstringPushwoosh অ্যাপ্লিকেশন কোড
notifications*হ্যাঁarrayকন্টেন্ট সেটিংস। বার্তা প্যারামিটারের JSON অ্যারে। নিচে বিস্তারিত দেখুন।

নোটিফিকেশন প্যারামিটার

Anchor link to
নাম
প্রয়োজনীয়টাইপবিবরণ
send_date*হ্যাঁstringনোটিফিকেশন পাঠানোর তারিখ এবং সময়। অবিলম্বে পাঠানোর জন্য YYYY-MM-DD HH:mm ফরম্যাট বা 'now' ব্যবহার করুন।
contentcontent_id প্রদান করা না হলে এটি প্রয়োজনীয়।stringWhatsApp বার্তার টেক্সট কন্টেন্ট।
content_idcontent প্রদান করা না হলে এটি প্রয়োজনীয়।stringআপনার Meta অ্যাকাউন্ট থেকে একটি পূর্ব-অনুমোদিত WhatsApp টেমপ্লেটের আইডেন্টিফায়ার।
devices*হ্যাঁarrayগ্রাহকের ফোন নম্বর (User ID-এর সাথে /registerDevice ব্যবহার করে যুক্ত থাকতে হবে এবং hwid প্যারামিটারে নির্দিষ্ট করতে হবে, অথবা use_auto_registration ব্যবহার করুন)। এখানে শুধুমাত্র একটি নম্বর নির্দিষ্ট করা যাবে।
use_auto_registrationনাbooleanযদি true সেট করা হয়, তাহলে devices প্যারামিটারে নির্দিষ্ট ফোন নম্বরটি স্বয়ংক্রিয়ভাবে রেজিস্টার হয়ে যাবে।
content_variablesনাobjectবার্তার কন্টেন্ট কাস্টমাইজ করার জন্য কন্টেন্ট ভেরিয়েবল। প্রতিটি প্লেসহোল্ডার সংশ্লিষ্ট ডাইনামিক মান দ্বারা প্রতিস্থাপিত হবে।
button_url_variablesনাobjectবাটনের জন্য ডাইনামিক URL ভেরিয়েবল। প্রতিটি কী একটি বাটন ইনডেক্সকে প্রতিনিধিত্ব করে, এবং এর মান হলো বাটনের URL-এ প্রতিস্থাপন করার জন্য ডাইনামিক ভেরিয়েবল। দ্রষ্টব্য: বাটন ইনডেক্সিং 0 থেকে শুরু হয়, যেখানে প্রথম বাটন 0, দ্বিতীয়টি 1, এবং এভাবেই চলতে থাকে।
header_variablesনাobjectWhatsApp টেমপ্লেট বার্তার হেডারের জন্য ভেরিয়েবল। type (যেমন, text, image, video, document) এবং সংশ্লিষ্ট মান নির্দিষ্ট করুন। উদাহরণ: "header_variables": {"image": "https://image-url.png"}
presetনাstringআপনার কন্ট্রোল প্যানেল থেকে WhatsApp প্রিসেট কোড।
languageনাstringWhatsApp টেমপ্লেটের ভাষা লোকেল (Meta WhatsApp টেমপ্লেট এডিটরের লোকেল-এর সাথে মিলতে হবে)। ডিফল্ট: "en_US"। উদাহরণ: "en_GB"।

রিকোয়েস্টের উদাহরণ

Anchor link to
{
  "request": {
    "application": "12XXX-67XXX",           // required. Pushwoosh application code.
    "auth": "yxoPUlwqm…………pIyEX4H",         // required. API access token from Pushwoosh Control Panel.
    "notifications": [{
      "send_date": "now",                   // required. YYYY-MM-DD HH:mm OR "now".
      "content": "Hello! {{1}}",            // required if content_id is not provided. Message text.
      "content_id": "hello_world",          // required if content is not provided. WhatsApp template identifier.
      "devices": ["whatsapp:+1234567890"],  // required. Customer WhatsApp phone number (must be associated
                                            //           with a UserId using /registerDevice and specified in
                                            //           the "hwid" parameter or use "use_auto_registration").
                                            //           Only one WhatsApp number can be specified here.
      "preset": "XXXXX-XXXXX",              // optional. WhatsApp Preset Code from your Control Panel.
      "content_variables": {                // optional. Content variables to customize the message content.
        "1": "John"
      },
      "header_variables": {                 // optional. Variables for the WhatsApp message header.
        "image": "https://image-url.png"
      },
      "language": "en_GB",                  // optional. Language locale for the WhatsApp template (must match the locale in Meta WhatsApp template editor). Default: "en_US".
      "use_auto_registration": true         // optional. Automatically register WhatsApp number specified
                                            //           in "devices" parameter.
    }]
  }
}

উদাহরণ: WhatsApp-এর মাধ্যমে একটি টু-ফ্যাক্টর অথেন্টিকেশন কোড পাঠানো

Anchor link to
{
    "request": {
        "application":"APP_CODE", "auth":"AUTH_TOKEN",
        "notifications":[{
            "send_date":"now",
            "content_id":"replace_with_your_meta_two_factor_template_name",
            "content_variables":{"1":"AUTH_CODE"},
            "button_url_variables":{"0":"AUTH_CODE"},
            "devices":["whatsapp:REPLACE_WITH_YOUR_PHONE_NO"]
        }]
    }
}

রেসপন্সের উদাহরণ

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

এরর রেসপন্স

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