ইভেন্ট রিসিভ করুন

আপনার এজেন্ট RBM প্ল্যাটফর্ম থেকে ওয়েবহুক ইভেন্ট পায়, যা আপনাকে ব্যবহারকারীর ইন্টার‍্যাকশন ও প্ল্যাটফর্ম-লেভেল আপডেট উভয় সম্পর্কেই বিজ্ঞপ্তি দেয়।

এইসব ইভেন্ট তাদের উৎস অনুযায়ী বিভাগ করা হয়েছে:

  • ব্যবহারকারীর ইভেন্ট: ব্যবহারকারীর ডিভাইস থেকে আপনার এজেন্টের কাছে পাঠানো বিজ্ঞপ্তি, যা আপনার এজেন্টের সাথে ইন্টার‍্যাকশনের ইঙ্গিত দেয়।
  • প্ল্যাটফর্ম ইভেন্ট: RBM প্ল্যাটফর্মের মাধ্যমে পাঠানো এজেন্টের লঞ্চ স্টেট পরিবর্তন এবং মেসেজের মেয়াদ শেষ হয়ে যাওয়া সংক্রান্ত বিজ্ঞপ্তি।

আপনার এজেন্ট ব্যবহারকারীর ডিভাইসে যে স্ট্যাটাস ইভেন্ট পাঠায় তার বিবরণ জানতে, ইভেন্ট পাঠান দেখুন।

টেক্সট, ফাইল, লোকেশন এবং অন্যান্য ব্যবহারকারীর মেসেজ কীভাবে ম্যানেজ করবেন সেই সম্পর্কে বিস্তারিত জানতে, মেসেজ পান বিকল্প দেখুন।

ব্যবহারকারীর ইভেন্ট

ব্যবহারকারীর ইভেন্ট হল ব্যবহারকারীর ডিভাইস থেকে পাওয়া বিজ্ঞপ্তি যা মেসেজের স্ট্যাটাস বা সাবস্ক্রিপশনে পরিবর্তন (যেমন, ব্যবহারকারী Google Messages-এ আনসাবস্ক্রাইব বা আবার সাবস্ক্রাইব করেছেন) সম্পর্কে জানায়।

সম্পূর্ণ ফর্ম্যাটিং ও ভ্যালু সংক্রান্ত বিকল্পের জন্য, UserEvent রেফারেন্স দেখুন।

ব্যবহারকারী এজেন্টের মেসেজ পান

এই ইভেন্ট থেকে বোঝা যায় যে ব্যবহারকারীর ডিভাইসে মেসেজটি সফলভাবে ডেলিভার করা হয়েছে।

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "DELIVERED",
  "eventId": "EVENT_ID",
  "messageId": "MESSAGE_ID",
  "agentId": "AGENT_ID"
}

ব্যবহারকারী এজেন্টের মেসেজ পড়ছেন

এই ইভেন্ট থেকে বোঝা যায় যে কোনও মেসেজ খোলা বা স্বীকার করা হয়েছে।

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "READ",
  "eventId": "EVENT_ID",
  "messageId": "MESSAGE_ID",
  "agentId": "AGENT_ID"
}

ব্যবহারকারী টাইপ করা শুরু করেন

এই ইভেন্ট থেকে বোঝা যায় যে ব্যবহারকারী উত্তর টাইপ করছেন।

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "IS_TYPING",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

ব্যবহারকারী সাজেস্ট করা অ্যাকশনে ট্যাপ করেন

ব্যবহারকারী কোনও সাজেস্ট করা অ্যাকশনে ট্যাপ করলে, আপনার এজেন্ট অ্যাকশনের পোস্টব্যাক ডেটা সহ একটি ইভেন্ট পায়।

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID",
  "suggestionResponse": {
    "postbackData": "postback_1234"
  }
}

ব্যবহারকারী কথোপকথন থেকে আনসাবস্ক্রাইব করেন

এই ইভেন্ট থেকে বোঝা যায় যে ব্যবহারকারী আপনার এজেন্ট এবং এটি যে ব্যবসার প্রতিনিধিত্ব করে তার থেকে অপ্রয়োজনীয় মেসেজ, যেমন প্রোমোশন, পাওয়ার জন্য আনসাবস্ক্রাইব করেছেন। Google Messages-এ RBM কথোপকথন থেকে আনসাবস্ক্রাইব করার মাধ্যমে ব্যবহারকারীরা এই ইভেন্ট ট্রিগার করেন।

JSON পেলোডের একটি উদাহরণ এখানে দেওয়া হল:

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "UNSUBSCRIBE",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

আনসাবস্ক্রাইব করার প্রসেস কীভাবে কাজ করে

  • চ্যাট মেনুতে সবসময় আনসাবস্ক্রাইব করুন বিকল্প উপলভ্য থাকে। প্রোমোশনাল ও মাল্টি-ইউজ এজেন্টের ক্ষেত্রে, নির্দিষ্ট সংখ্যক মেসেজ না পড়া থাকলে, এই বিকল্পটি সরাসরি চ্যাটে দেখানো হয় (নির্দিষ্ট নিয়ম দেশ অনুযায়ী আলাদা হয়)।
  • আনসাবস্ক্রাইব করুন বিকল্প বেছে নিলে, একই সাথে দুটি অ্যাকশন ট্রিগার হয়: Google Messages আপনার এজেন্টের কাছে দেশ-নির্দিষ্ট কীওয়ার্ড (যেমন, "STOP") পাঠায় এবং RBM প্ল্যাটফর্ম আপনার ওয়েবহুকে একটি UNSUBSCRIBE ইভেন্ট পাঠায়।

    ব্যবহারকারীর ফোন নম্বরের দুই অক্ষরের কান্ট্রি কোড থেকে কীওয়ার্ড নির্ধারণ করা হয়। নিম্নলিখিত সারণীতে প্রতিটি দেশের জন্য কীওয়ার্ডের তালিকা দেওয়া হয়েছে।

    দেশ (দেশের কোড) আনসাবস্ক্রাইব কীওয়ার্ড
    মার্কিন যুক্তরাষ্ট্র (US), ভারত (IN), যুক্তরাজ্য (GB), জার্মানি (DE), নেদারল্যান্ড (NL) থামুন
    স্পেন (ES), মেক্সিকো (MX) BAJA
    ফ্রান্স (FR) থামুন
    ব্রাজিল (BR) parar
  • ব্যবহারকারী আনসাবস্ক্রাইব করার পরে, কথোপকথনটি তার ইনবক্সে থেকে যায় যদি না স্প্যাম হিসাবে রিপোর্ট করা হয়, সেক্ষেত্রে এটি স্প্যাম এবং ব্লক করা ফোল্ডারে চলে যায়।

  • নীতি ও ব্যবসার নিয়ম লঙ্ঘন শনাক্ত করতে, কোনও ব্যবহারকারী আনসাবস্ক্রাইব করার পরে Google মেসেজের প্যাটার্ন মনিটর করে।

ব্যবসার নিয়ম

  • এই কথোপকথন ম্যানেজ করা RBM পার্টনার হিসেবে, আনসাবস্ক্রাইব করার জন্য ব্যবহারকারীর অনুরোধ মেনে চলা আপনার দায়িত্ব।
  • আপনি যদি মেসেজ থ্রেডের মধ্যে আনসাবস্ক্রাইব করার সুবিধা দিতে না পারেন, তাহলে আপনাকে অবিলম্বে একটি স্বীকৃতি মেসেজ পাঠাতে হবে, যাতে ওয়েবসাইট বা অ্যাপের একটি সরাসরি লিঙ্ক থাকবে, যেখানে ব্যবহারকারীরা তাদের সাবস্ক্রিপশন সংক্রান্ত পছন্দ ম্যানেজ করতে পারবেন।
  • ব্যবহারকারী আনসাবস্ক্রাইব করার পরে, অপ্রয়োজনীয় মেসেজ পাঠানো নিষিদ্ধ।
  • প্রয়োজনীয় মেসেজ এখনও অনুমোদিত। এর মধ্যে এগুলি অন্তর্ভুক্ত:
    • যাচাইকরণ, যেমন একবার ব্যবহারের পাসওয়ার্ড (OTP)
    • ব্যবহারকারী অনুরোধ করেছেন এবং সম্মতি দিয়েছেন এমন নির্দিষ্ট পরিষেবা সম্পর্কে বিজ্ঞপ্তি
    • ব্যবহারকারীর আনসাবস্ক্রাইব করার অনুরোধের কনফার্মেশন, সাথে তার যোগাযোগের পছন্দ আরও ম্যানেজ করার তথ্য

উদাহরণ

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

আনসাবস্ক্রাইব করার কারণ

কোনও ব্যবহারকারী আপনার এজেন্ট থেকে আনসাবস্ক্রাইব করলে, তিনি নিম্নলিখিত বিকল্প থেকে কারণ বেছে নিতে পারেন:

  • খুব বেশি মেসেজ
  • আমি এর জন্য কখনও সাইন-আপ করিনি
  • আমি আর আগ্রহী নই
  • এটি স্ক্যাম বলে মনে হচ্ছে
  • অন্যান্য

বেছে নেওয়ার ক্ষেত্রে পক্ষপাতিত্ব কমাতে, প্রথম চারটি বিকল্প প্রত্যেক ব্যবহারকারীর জন্য র‍্যান্ডমাইজড অর্ডারে দেখানো হয়। ব্যবহারকারী যতবারই ভিজিট করুন না কেন, এই ক্রম একই থাকে এবং অন্যান্য বিকল্পটি একদম নিচে স্থির থাকে।

ব্যবহারকারীরা কেন আনসাবস্ক্রাইব করছেন তা বুঝতে আপনাকে সাহায্য করার জন্য আনসাবস্ক্রাইব করার কারণগুলি একত্রিত করা হয় এবং Analytics ওভারভিউ-এ দেখানো হয়।

ব্যবহারকারী কথোপকথনে আবার সাবস্ক্রাইব করেন

এই ইভেন্ট থেকে বোঝা যায় যে কোনও ব্যবহারকারী আপনার এজেন্টের থেকে আবার মেসেজ পেতে চান, যার মধ্যে প্রচারের মতো অপ্রয়োজনীয় কন্টেন্টও অন্তর্ভুক্ত। ব্যবহারকারীরা Google Messages-এ আগে আনসাবস্ক্রাইব করা কোনও কথোপকথনে আবার সাবস্ক্রাইব করার মাধ্যমে এই ইভেন্ট ট্রিগার করতে পারেন।

JSON পেলোডের একটি উদাহরণ এখানে দেওয়া হল:

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "SUBSCRIBE",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

আবার সাবস্ক্রাইব করার প্রক্রিয়া কীভাবে কাজ করে

  • সাবস্ক্রাইব করুন বিকল্পটি চ্যাট মেনু এবং ইন-চ্যাট লিঙ্ক, দুটিতেই উপলভ্য। এটি ব্যবহারকারীদের এমন কথোপকথনে আবার সাবস্ক্রাইব করার অনুমতি দেয় যেখান থেকে তারা আনসাবস্ক্রাইব করেছিলেন।
  • সাবস্ক্রাইব করুন বিকল্প বেছে নিলে একই সাথে দুটি অ্যাকশন ট্রিগার হয়: Google Messages আপনার এজেন্টের কাছে দেশ-নির্দিষ্ট কীওয়ার্ড (যেমন, "START") পাঠায় এবং RBM প্ল্যাটফর্ম আপনার ওয়েবহুকে একটি SUBSCRIBE ইভেন্ট পাঠায়। ব্যবহারকারীর ফোন নম্বরের দুই অক্ষরের কান্ট্রি কোড থেকে নির্দিষ্ট কীওয়ার্ড নির্ধারণ করা হয়। নিম্নলিখিত সারণীতে কাজ করে এমন প্রতিটি দেশের জন্য কীওয়ার্ডের তালিকা দেওয়া হয়েছে।

    দেশ (দেশের কোড) কীওয়ার্ড সাবস্ক্রাইব করুন
    মার্কিন যুক্তরাষ্ট্র (US), ভারত (IN), যুক্তরাজ্য (GB), জার্মানি (DE), নেদারল্যান্ড (NL) শুরু করুন
    স্পেন (ES), মেক্সিকো (MX) ALTA
    ফ্রান্স (FR) Démarrer
    ব্রাজিল (BR) শুরু করুন

ব্যবসার নিয়ম

  • RBM পার্টনার হিসেবে আপনি এই কথোপকথন ম্যানেজ করেন, তাই আবার সাবস্ক্রাইব করার জন্য ব্যবহারকারীর অনুরোধ মেনে চলা আপনার দায়িত্ব।
  • আবার সাবস্ক্রাইব করার সুবিধা সব ধরনের মেসেজের ক্ষেত্রে প্রযোজ্য, যার মধ্যে প্রচারের মতো অপ্রয়োজনীয় কন্টেন্টও রয়েছে।
  • আনসাবস্ক্রাইব করার পরে কোনও ব্যবহারকারী আপনার ব্যবসাকে মেসেজ করলে, এটিকে আবার সাবস্ক্রাইব করার অনুরোধ হিসেবে বিবেচনা করা যেতে পারে।
  • কোনও ব্যবহারকারী মেসেজিং চ্যানেলের বাইরে (যেমন, আপনার ওয়েবসাইটে) আবার সাবস্ক্রাইব করলে, RBM পার্টনার হিসেবে তার স্ট্যাটাস আপডেট করা এবং সেই অনুযায়ী মেসেজ পাঠানো আবার শুরু করার দায়িত্ব আপনার।

প্ল্যাটফর্ম ইভেন্ট

এজেন্টের লঞ্চ স্টেট বা মেসেজের মেয়াদ শেষ হয়ে যাওয়া সংক্রান্ত পরিবর্তন সম্পর্কে আপনার এজেন্টকে জানাতে, RBM প্ল্যাটফর্ম, প্ল্যাটফর্ম ইভেন্ট পাঠায়।

এজেন্ট লঞ্চের স্ট্যাটাস পরিবর্তন করা হয়েছে

আপনার এজেন্টের লঞ্চ স্ট্যাটাসে প্রতিটি পরিবর্তনের জন্য RBM প্ল্যাটফর্ম একটি AgentLaunchEvent পাঠায়। যেমন, আপনার এজেন্টের স্ট্যাটাস PENDING থেকে LAUNCHED-এ পরিবর্তন হলে। ইভেন্টটি Pub/Sub মেসেজ হিসেবে ডেলিভার করা হয়। অন্যান্য ইভেন্ট থেকে এটিকে আলাদা করতে, agent_launch_event ভ্যালুর জন্য message.attributes.type পাথ চেক করুন।

ওয়েবহুক কনফিগারেশন

এইসব বিজ্ঞপ্তি পেতে, আপনি পার্টনার-লেভেল বা এজেন্ট-লেভেল ওয়েবহুক ব্যবহার করতে পারবেন।

পূর্বশর্ত

ইভেন্ট পেলোড স্ট্রাকচার

AgentLaunchEvent Pub/Sub মেসেজ হিসেবে ডেলিভার করা হয়।

একটা উদাহরণ দেওয়া হল:

{
  "message": {
    "attributes": {
      "business_id": "rbm-chatbot-id@rbm.goog",
      "event_type": "REJECTED",
      "product": "RBM",
      "project_number": "3338881441851",
      "type": "agent_launch_event"
    },
    "data": "....BASE64-encoded-JSON-with-notification...",
    "messageId": "14150481888479752",
    "message_id": "14150481888479752",
    "publishTime": "2025-03-05T18:50:21.88Z",
    "publish_time": "2025-03-05T18:50:21.88Z"
  },
  "subscription": "projects/rbm-partner-gcp/subscriptions/rbm-sub"
}

ইভেন্ট পেলোডে AgentLaunchEvent.LaunchState ফিল্ড এজেন্টের নতুন লঞ্চ স্টেট নির্দেশ করে। সম্ভাব্য ভ্যালুগুলি এখানে দেওয়া হল:

ভ্যালু এজেন্ট লঞ্চ স্টেট বিবরণ
PENDING বাকি আছে অনুরোধটি পর্যালোচনার জন্য পরিষেবা প্রদানকারীর কাছে পাঠানো হয়েছে।
LAUNCHED লঞ্চ করা হয়েছে প্রদত্ত পরিষেবা প্রদানকারীর মাধ্যমে মেসেজ পাঠানো যাবে।
REJECTED প্রদত্ত পরিষেবা প্রদানকারীর ক্ষেত্রে বাতিল করা হয়েছে বাতিল করার কারণ কমেন্টে উল্লেখ করা আছে।
SUSPENDED নির্দিষ্ট পরিষেবা প্রদানকারীর ক্ষেত্রে সাসপেন্ড করা হয়েছে সাসপেনশনের কারণ কমেন্টে উল্লেখ করা আছে।
UNLAUNCHED লঞ্চ করা হয়নি সব ক্যারিয়ার থেকে আনলঞ্চ করা হয়েছে এমন এজেন্টের জন্য এডিট করার অনুমতি দেওয়া হয়।

ডেটা ফিল্ডে Base64-এনকোড করা JSON অবজেক্ট থাকে, যাতে লঞ্চ স্টেট সম্পর্কিত বিবরণ থাকে। ডিকোড করা JSON-এর একটি উদাহরণ এখানে দেওয়া হল:

 {
      "eventId": "rbm-chatbot-id/0a7ed168-676e-4a56-b422-b23434",
      "agentId": "rbm-chatbot-id@rbm.goog",
      "botDisplayName": "RBM Welcome Bot 7 - RBM Chatbot name",
      "brandId": "bd38fbff-392a-437b-a6f2-7f2e43745b56",
      "brandDisplayName": "Chatbots brand",
      "regionId": "/v1/regions/fi-rcs",
      "oldLaunchState": "PENDING",
      "newLaunchState": "REJECTED",
      "actingParty": "rbm-support@google.com",
      "comment": "Carrier has rejected the launch: policy violation",
      "sendTime": "2025-03-05T18:50:19.386436Z"
}

পরিষেবা প্রদানকারীর মাধ্যমে শুরু করা লঞ্চ স্ট্যাটাস পরিবর্তন

পর্যালোচনা ও এনফোর্সমেন্ট প্রসেস চলাকালীন ক্যারিয়ার সাধারণত এইসব ট্রানজিশন ম্যানেজ করে:

পুরনো লঞ্চ স্টেট নতুন লঞ্চ স্ট্যাটাস ট্রিগার অ্যাকশন
PENDING LAUNCHED লঞ্চ করার অনুরোধ অনুমোদন করুন।
PENDING REJECTED লঞ্চ করার অনুরোধ বাতিল করুন।
LAUNCHED SUSPENDED এনফোর্সমেন্ট/অ্যাডমিন সংক্রান্ত কারণে সাসপেন্ড করা।
SUSPENDED LAUNCHED এজেন্টকে অ্যাক্টিভ স্ট্যাটাসে ফিরিয়ে আনুন।
SUSPENDED UNLAUNCHED এজেন্ট বন্ধ করুন।
REJECTED LAUNCHED আগে বাতিল করা লঞ্চের অনুরোধ অনুমোদন করুন।

পার্টনারের মাধ্যমে শুরু করা লঞ্চ স্ট্যাটাস পরিবর্তন

এগুলি হল অনুমোদিত ট্রানজিশন যা সাধারণত পার্টনাররা ম্যানেজ করেন:

পুরনো লঞ্চ স্টেট নতুন লঞ্চ স্ট্যাটাস ট্রিগার অ্যাকশন
UNSPECIFIED PENDING পর্যালোচনার জন্য জমা দিন।
PENDING UNLAUNCHED লঞ্চ করার বাকি থাকা অনুরোধ বাতিল করুন।
UNLAUNCHED PENDING পর্যালোচনার জন্য জমা দিন।
REJECTED PENDING পর্যালোচনার জন্য আবার জমা দিন।
SUSPENDED PENDING পর্যালোচনার জন্য আবার জমা দিন।

মেসেজের মেয়াদ শেষ হয়ে গেছে; প্রত্যাহার করা হয়েছে

এই ইভেন্ট থেকে বোঝা যায় যে মেসেজের টাইম টু লাইভ (TTL) শেষ হয়ে গেছে এবং মেসেজটি তুলে নেওয়া হয়েছে। আপনার ফলব্যাক মেসেজিং স্ট্র্যাটেজির জন্য এটি একটি ভালো ট্রিগার।

সম্পূর্ণ ফর্ম্যাটিং ও ভ্যালু সংক্রান্ত বিকল্পের জন্য, ServerEvent রেফারেন্স দেখুন।

{
  "phoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "agentId": "AGENT_ID",
  "eventType": "TTL_EXPIRATION_REVOKED",
  "eventId": "EVENT_ID",
  "sendTime": "TIMESTAMP"
}

মেসেজের মেয়াদ শেষ হয়ে গেছে; প্রত্যাহার করা যায়নি

এই ইভেন্ট থেকে বোঝা যায় যে মেসেজের TTL-এর মেয়াদ শেষ হয়ে গেছে, কিন্তু এটি সফলভাবে তুলে নেওয়া হয়নি।

সম্পূর্ণ ফর্ম্যাটিং ও ভ্যালু সংক্রান্ত বিকল্পের জন্য, ServerEvent রেফারেন্স দেখুন।

{
  "phoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "agentId": "AGENT_ID",
  "eventType": "TTL_EXPIRATION_REVOKE_FAILED",
  "eventId": "EVENT_ID",
  "sendTime": "TIMESTAMP"
}

মেসেজ ডেলিভারির কোনও গ্যারেন্টি নেই।

  • মেসেজটি ডেলিভার করা হলে, আপনার ওয়েবহুকে আপনি একটি DELIVERED ইভেন্ট পাবেন।
  • মেসেজ ডেলিভার করা না হলে, প্রত্যাহারের অনুরোধ পাঠাতে প্রত্যাহার API ব্যবহার করুন।

মেসেজটি যদি ওটিপি বা প্রতারণা সংক্রান্ত সতর্কতার মতো সময়-সংবেদনশীল হয়, তাহলে এসএমএসের মতো বিকল্প চ্যানেলের মাধ্যমে মেসেজ পাঠানোই সবচেয়ে ভালো, এমনকি এর ফলে ব্যবহারকারীর কাছে ডুপ্লিকেট মেসেজ গেলেও।