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

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

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

চ্যানেল পেলোড টাইপ দ্বারা নির্বাচিত হয় (payload পুশ / এসএমএস / মেসেঞ্জারের জন্য, 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। একটি একক মেসেজ তৈরি এবং পাঠান (সেগমেন্ট বা ট্রানজ্যাকশনাল)।
Cancel: POST /messaging/v2/cancel। পূর্বে তৈরি করা একটি মেসেজ বাতিল করুন যা এখনও ডেলিভার করা হয়নি।
Update: POST /messaging/v2/update। এখনও নির্ধারিত একটি মেসেজকে একটি নতুন ডেফিনিশন দিয়ে প্রতিস্থাপন করুন।

রিকোয়েস্ট এবং রেসপন্স ফরম্যাট

কন্টেন্ট টাইপ: application/json।
ফিল্ডের নাম snake_case ব্যবহার করে। oneof গ্রুপগুলি নেস্টেড অবজেক্ট হিসাবে প্রদর্শিত হয় যেখানে ঠিক একটি কী সেট করা থাকে।
এনুম ভ্যালুগুলি তাদের স্ট্রিং নাম হিসাবে সিরিয়ালাইজ করা হয় (উদাহরণস্বরূপ, "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"
    }
  }'

SMTP এর মাধ্যমে ইমেল পাঠানো

যদি কোনো সার্ভিস ইতিমধ্যেই SMTP ব্যবহার করে, তাহলে আপনি সরাসরি Notify কল করার পরিবর্তে SMTP গেটওয়ে এর মাধ্যমে ট্রানজ্যাকশনাল ইমেল জমা দিতে পারেন। গেটওয়ে প্রতিটি মেসেজকে এই API-তে একটি ট্রানজ্যাকশনাল Notify হিসাবে ফরোয়ার্ড করে, তাই একই অথেন্টিকেশন এবং ইমেল পেলোড নিয়ম প্রযোজ্য।

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

নোটিফাই

আপডেট