इवेंट पाएं

आपका एजेंट, 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 बातचीत से ऑप्ट आउट करके इस इवेंट को ट्रिगर करते हैं.

अहम जानकारी: डेवलपर को नए UNSUBSCRIBE और SUBSCRIBE वेबहुक इवेंट पर स्विच करने में मदद करने के लिए, Google Messages, वेबहुक इवेंट के साथ-साथ "STOP" और "START" मैसेज भी भेज रहा है. फ़िलहाल, STOP/START लॉजिक का इस्तेमाल किया जा सकता है. हालांकि, हमारा सुझाव है कि आप UNSUBSCRIBE और SUBSCRIBE इवेंट को हैंडल करने के लिए, अपने लॉजिक को अपडेट करें. ऐसा इसलिए, क्योंकि जीएसएमए के स्पेसिफ़िकेशन के मुताबिक, इनका इस्तेमाल करना ज़रूरी होगा.

यहां 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)	STOP
  ब्राज़ील (BR)	parar

• सदस्यता छोड़ने के बाद, बातचीत उपयोगकर्ता के इनबॉक्स में ही रहती है. हालांकि, अगर इसकी शिकायत स्पैम के तौर पर की जाती है, तो इसे स्पैम और ब्लॉक किए गए फ़ोल्डर में भेज दिया जाता है.

• नीति और कारोबार के नियमों के उल्लंघन का पता लगाने के लिए, Google किसी उपयोगकर्ता के सदस्यता छोड़ने के बाद, मैसेज के पैटर्न पर नज़र रखता है.

कारोबार के नियम

• इस बातचीत को मैनेज करने वाले आरबीएम पार्टनर के तौर पर, यह आपकी ज़िम्मेदारी है कि आप सदस्यता छोड़ने के लिए किए गए उपयोगकर्ता के अनुरोध का पालन करें.
• अगर मैसेज थ्रेड में सदस्यता रद्द करने की सुविधा उपलब्ध नहीं है, तो आपको तुरंत एक मैसेज भेजना होगा. इसमें सदस्यता रद्द करने की पुष्टि की गई हो. साथ ही, इसमें वेबसाइट या ऐप्लिकेशन का डायरेक्ट लिंक भी दिया गया हो, जहां लोग सदस्यता से जुड़ी अपनी प्राथमिकताओं को मैनेज कर सकें.
• उपयोगकर्ता के सदस्यता छोड़ने के बाद, उसे गै़र-ज़रूरी मैसेज नहीं भेजे जा सकते.
• ज़रूरी मैसेज अब भी भेजे जा सकते हैं. इनमें ये शामिल हैं:
  • पुष्टि करने से जुड़ी जानकारी, जैसे कि एक बार इस्तेमाल होने वाले पासवर्ड (ओटीपी)
  • उपयोगकर्ता ने जिस सेवा के लिए अनुरोध किया है और जिसके लिए उसने सहमति दी है उससे जुड़ी सूचनाएं
  • उपयोगकर्ता के सदस्यता छोड़ने के अनुरोध की पुष्टि करने वाला ईमेल. इसमें, कम्यूनिकेशन से जुड़ी प्राथमिकताओं को मैनेज करने के बारे में जानकारी दी जाती है

उदाहरण

अगर कोई उपयोगकर्ता, एयरलाइन एजेंट से सदस्यता रद्द करता है और एजेंट कई तरह के काम के लिए सदस्यता का इस्तेमाल करता है, तो आपको मार्केटिंग मैसेज भेजना बंद करना होगा. हालांकि, अगर उपयोगकर्ता ने किसी फ़्लाइट के अपडेट पाने के लिए साफ़ तौर पर सहमति दी है, तो आपको फ़्लाइट के अपडेट भेजने की अनुमति है.

सदस्यता छोड़ने की वजहें

जब कोई व्यक्ति आपके एजेंट की सदस्यता छोड़ता है, तो वह इनमें से कोई वजह चुन सकता है:

• स्पैम
• कभी साइन अप नहीं किया
• बहुत ज़्यादा मैसेज आते हैं
• अब कोई दिलचस्पी नहीं है
• अन्य

सदस्यता छोड़ने की वजहें, Analytics की खास जानकारी में दिखाई जाती हैं. इससे पार्टनर को यह समझने में मदद मिलती है कि उपयोगकर्ता सदस्यता क्यों छोड़ रहे हैं.

उपयोगकर्ता ने बातचीत की सदस्यता फिर से ली हो

इस इवेंट से पता चलता है कि कोई उपयोगकर्ता, आपके एजेंट से फिर से मैसेज पाना चाहता है. इनमें प्रमोशन जैसे ग़ैर-ज़रूरी कॉन्टेंट भी शामिल है. उपयोगकर्ता इस इवेंट को ट्रिगर कर सकते हैं. इसके लिए, उन्हें उस बातचीत की सदस्यता फिर से लेनी होगी जिसकी सदस्यता उन्होंने Google Messages में पहले छोड़ी थी.

अहम जानकारी: डेवलपर को नए UNSUBSCRIBE और SUBSCRIBE वेबहुक इवेंट पर स्विच करने में मदद करने के लिए, Google Messages, वेबहुक इवेंट के साथ-साथ "STOP" और "START" मैसेज भी भेज रहा है. फ़िलहाल, STOP/START लॉजिक का इस्तेमाल किया जा सकता है. हालांकि, हमारा सुझाव है कि आप UNSUBSCRIBE और SUBSCRIBE इवेंट को हैंडल करने के लिए, अपने लॉजिक को अपडेट करें. ऐसा इसलिए, क्योंकि जीएसएमए के स्पेसिफ़िकेशन के मुताबिक, इनका इस्तेमाल करना ज़रूरी होगा.

यहां 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)	começar

कारोबार के नियम

• इस बातचीत को मैनेज करने वाले आरबीएम पार्टनर के तौर पर, यह आपकी ज़िम्मेदारी है कि आप सदस्यता फिर से लेने के लिए उपयोगकर्ता के अनुरोध का पालन करें.
• फिर से सदस्यता लेने का विकल्प, हर तरह के मैसेज के लिए उपलब्ध होता है. इसमें प्रमोशन जैसे गैर-ज़रूरी कॉन्टेंट भी शामिल है.
• अगर कोई उपयोगकर्ता सदस्यता छोड़ने के बाद आपके कारोबार को मैसेज भेजता है, तो इसे फिर से सदस्यता लेने का अनुरोध माना जा सकता है.
• अगर कोई उपयोगकर्ता मैसेजिंग चैनल के बाहर (उदाहरण के लिए, आपकी वेबसाइट पर) फिर से सदस्यता लेता है, तो RBM पार्टनर के तौर पर यह आपकी ज़िम्मेदारी है कि आप उसकी स्थिति को अपडेट करें और उसके हिसाब से मैसेज भेजना फिर से शुरू करें.

प्लैटफ़ॉर्म इवेंट

RBM प्लैटफ़ॉर्म, प्लैटफ़ॉर्म इवेंट भेजता है. इससे आपके एजेंट को एजेंट के लॉन्च स्टेटस या मैसेज की समयसीमा खत्म होने में हुए बदलावों के बारे में सूचना मिलती है.

एजेंट लॉन्च करने की स्थिति बदल गई है

आरबीएम प्लैटफ़ॉर्म, आपके एजेंट के लॉन्च स्टेटस में हुए हर बदलाव के लिए AgentLaunchEvent भेजता है. उदाहरण के लिए, जब आपके एजेंट की स्थिति PENDING से बदलकर LAUNCHED हो जाती है. यह इवेंट, Pub/Sub मैसेज के तौर पर डिलीवर किया जाता है. इसे अन्य इवेंट से अलग करने के लिए, वैल्यू agent_launch_event के लिए message.attributes.type पाथ देखें.

वेबबुक कॉन्फ़िगरेशन

इन सूचनाओं को पाने के लिए, पार्टनर-लेवल या एजेंट-लेवल के वेबहुक का इस्तेमाल किया जा सकता है.

ज़रूरी शर्तें

• RBM मैसेजिंग के लिए, वेबहुक कॉन्फ़िगर करें. यह उपयोगकर्ताओं के मैसेज और इवेंट पाने के लिए ज़रूरी है.
• उपयोगकर्ता इवेंट और एजेंट लॉन्च की स्थिति वाले इवेंट के बीच अंतर करने के लिए, वैल्यू agent_launch_event के लिए message.attributes.type पाथ देखें.

इवेंट पेलोड का स्ट्रक्चर

AgentLaunchEvent को Pub/Sub मैसेज के तौर पर डिलीवर किया जाता है. यहां एक उदाहरण दिया गया है:

{
  "message": {
    "attributes": {
      "business_id": "[e-mail]",
      "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": "[e-mail]",
      "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": "[e-mail]",
      "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	किसी एजेंट को बंद करें.

पार्टनर की ओर से शुरू किए गए लॉन्च की स्थिति में बदलाव

ये ऐसे ट्रांज़िशन हैं जिनकी अनुमति है. आम तौर पर, इन्हें पार्टनर मैनेज करते हैं:

लॉन्च की पुरानी स्थिति	लॉन्च की नई स्थिति	कार्रवाई ट्रिगर करना
UNSPECIFIED	PENDING	समीक्षा के लिए सबमिट करें.
PENDING	UNLAUNCHED	लॉन्च करने के ऐसे अनुरोध को रद्द करें जिसे मंज़ूरी नहीं मिली है.
UNLAUNCHED	PENDING	समीक्षा के लिए सबमिट करें.
REJECTED	PENDING	समीक्षा के लिए फिर से सबमिट करें.

मैसेज की समयसीमा खत्म हो गई है; न्योता वापस ले लिया गया है

इस इवेंट से पता चलता है कि मैसेज का टाइम टू लिव (टीटीएल) खत्म हो गया है और मैसेज को रद्द कर दिया गया है. यह फ़ॉलबैक मैसेजिंग की रणनीति के लिए एक अच्छा ट्रिगर है.

फ़ॉर्मैटिंग और वैल्यू के सभी विकल्पों के लिए, ServerEvent रेफ़रंस देखें.

{
  "phoneNumber": "[phone number]" ,
  "messageId": "[RCS message ID]",
  "agentId": [bot ID],
  "eventType": "TTL_EXPIRATION_REVOKED",
  "eventId": "[unique ID]",
  "sendTime": "[time stamp]"
}

मैसेज की समयसीमा खत्म हो गई है; ऐक्सेस वापस नहीं लिया जा सका

इस इवेंट से पता चलता है कि मैसेज का टीटीएल खत्म हो गया है, लेकिन इसे रद्द नहीं किया जा सका.

फ़ॉर्मैटिंग और वैल्यू के सभी विकल्पों के लिए, ServerEvent रेफ़रंस देखें.

{
  "phoneNumber": "[phone number]",
  "messageId": "[RCS message ID]",
  "agentId": "[bot ID]",
  "eventType": "TTL_EXPIRATION_REVOKE_FAILED",
  "eventId": "[unique ID]",
  "sendTime": "[time stamp]"
}

मैसेज डिलीवर होने की कोई गारंटी नहीं है.

• अगर मैसेज डिलीवर हो गया है, तो आपको अपने वेबहुक पर DELIVERED इवेंट मिलेगा.
• अगर मैसेज डिलीवर नहीं हुआ है, तो रद्द करने का अनुरोध भेजने के लिए, रद्द करने वाले एपीआई का इस्तेमाल करें.

अगर मैसेज में समयसीमा से जुड़ी जानकारी है, जैसे कि ओटीपी या धोखाधड़ी की चेतावनी, तो उसे एसएमएस जैसे किसी दूसरे चैनल से भेजें. भले ही, इससे उपयोगकर्ता को डुप्लीकेट मैसेज मिलें.