মেসেজিং API v2 ওভারভিউ

মেসেজিং API v2 হল Pushwoosh সমর্থিত প্রতিটি চ্যানেলে আউটবাউন্ড মেসেজ তৈরি করার জন্য একটি একক REST/JSON এন্ডপয়েন্ট:

পুশ: iOS, Android, Huawei, Baidu, macOS, Amazon, Windows, Safari, Chrome, Firefox, IE
ইমেল
SMS
Telegram, Kakao, LINE, WhatsApp

চ্যানেল পেলোডের প্রকার দ্বারা নির্বাচিত হয় (payload পুশ / SMS / মেসেঞ্জারের জন্য, email_payload ইমেলের জন্য)।

টার্গেটিং অনুরোধের প্রকার দ্বারা নির্বাচিত হয় (segment অডিয়েন্স সেগমেন্টের জন্য, transactional সুস্পষ্ট ডিভাইস বা ব্যবহারকারী তালিকার জন্য)।

বেস URL

https://api.pushwoosh.com

আপনি যদি একটি ডেডিকেটেড রিজিয়ন বা প্রাইভেট ডেপ্লয়মেন্ট ব্যবহার করেন, তাহলে আপনার Pushwoosh কাস্টমার সাকসেস ম্যানেজারের সাথে সঠিক বেস URL নিশ্চিত করুন।

অথেন্টিকেশন

প্রতিটি অনুরোধে একটি Authorization হেডার অন্তর্ভুক্ত থাকতে হবে, যেখানে একটি সার্ভার-সাইড Pushwoosh API অ্যাক্সেস টোকেন থাকবে:

Authorization: Token YOUR_API_TOKEN

সার্ভার-টু-সার্ভার API কলের জন্য আপনি যে টোকেনটি ব্যবহার করেন, সেটিই ব্যবহার করুন। এই টোকেনটি ক্লায়েন্ট অ্যাপ্লিকেশনগুলিতে প্রকাশ করবেন না।

মেথড

Notify: POST /messaging/v2/notify। একটি একক মেসেজ (সেগমেন্ট বা ট্রানজ্যাকশনাল) তৈরি করুন এবং পাঠান।

অনুরোধ এবং প্রতিক্রিয়া ফরম্যাট

কন্টেন্ট টাইপ: application/json।
ফিল্ডের নাম snake_case ব্যবহার করে। oneof গ্রুপগুলি নেস্টেড অবজেক্ট হিসাবে প্রদর্শিত হয় যেখানে ঠিক একটি কী সেট করা থাকে।
Enum মানগুলি তাদের স্ট্রিং নাম হিসাবে সিরিয়ালাইজ করা হয় (উদাহরণস্বরূপ, "IOS", "MESSAGE_TYPE_MARKETING")।
সফল প্রতিক্রিয়াগুলি একটি JSON বডি সহ HTTP 200 রিটার্ন করে; ত্রুটিগুলি স্ট্যান্ডার্ড gRPC-গেটওয়ে এরর এনভেলপ ব্যবহার করে — { "code": ..., "message": ..., "details": [...] }।

দ্রুত শুরু

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "code": "active_users",
      "payload": {
        "content": {
          "localized_content": {
            "en": {
              "ios":     { "body": "Hello from v2!" },
              "android": { "body": "Hello from v2!" }
            }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" },
      "message_type": "MESSAGE_TYPE_MARKETING"
    }
  }'

পরবর্তী পদক্ষেপ

Notify

পেলোড রেফারেন্স

ইমেল পেলোড রেফারেন্স

v1 থেকে মাইগ্রেশন