इवेंट पाएं

आपका एजेंट, 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",
  "text": "Hi",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

उपयोगकर्ता ने कोई फ़ाइल भेजी

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "userFile": {
    "payload": {
      "mimeType": "image/gif",
      "fileSizeBytes": 127806,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c9",
      "fileName": "4_animated.gif"
    }
  },
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

उपयोगकर्ता, सुझाए गए जवाब पर टैप करता है

जब कोई उपयोगकर्ता सुझाए गए जवाब पर टैप करता है, तो आपके एजेंट को एक इवेंट मिलता है. इसमें जवाब का पोस्टबैक डेटा और टेक्स्ट होता है.

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID",
  "suggestionResponse": {
    "postbackData": "postback_1234",
    "text": "Hello there!"
  }
}

उपयोगकर्ता, सुझाई गई किसी कार्रवाई पर टैप करता है

जब कोई उपयोगकर्ता सुझाई गई कार्रवाई पर टैप करता है, तो आपके एजेंट को कार्रवाई के पोस्टबैक डेटा के साथ एक इवेंट मिलता है.

{
  "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)	बंद करें
स्पेन (ES), मेक्सिको (MX)	BAJA
फ़्रांस (FR)	बंद करें
ब्राज़ील (BR)	parar

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

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

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

उदाहरण

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

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

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

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

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

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

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

यहां JSON पेलोड का एक उदाहरण दिया गया है:

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

फिर से सदस्यता लेने की सुविधा कैसे काम करती है

सदस्यता लें विकल्प, चैट मेन्यू और चैट में मौजूद लिंक, दोनों से उपलब्ध होता है. इससे उपयोगकर्ता, उस बातचीत की सदस्यता फिर से ले सकते हैं जिसकी सदस्यता उन्होंने छोड़ दी थी.

सदस्यता लें को चुनने पर, एक साथ दो कार्रवाइयां ट्रिगर होती हैं: Google Messages आपके एजेंट को देश के हिसाब से कीवर्ड भेजता है. उदाहरण के लिए, "START". साथ ही, RBM प्लैटफ़ॉर्म आपके वेबुक को SUBSCRIBE इवेंट भेजता है. खास कीवर्ड, उपयोगकर्ता के फ़ोन नंबर के दो अक्षर वाले देश कोड से तय होता है. यहां दी गई टेबल में, हर उस देश के लिए कीवर्ड दिए गए हैं जहां यह सुविधा उपलब्ध है.

देश (देश का कोड)	कीवर्ड की सदस्यता लें
अमेरिका (US), भारत (IN), यूनाइटेड किंगडम (GB), जर्मनी (DE)	शुरू करें
स्पेन (ES), मेक्सिको (MX)	ALTA
फ़्रांस (FR)	Démarrer
ब्राज़ील (BR)	शुरू करें

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

इस बातचीत को मैनेज करने वाले आरबीएम पार्टनर के तौर पर, यह आपकी ज़िम्मेदारी है कि आप सदस्यता फिर से लेने के लिए उपयोगकर्ता के अनुरोध का पालन करें.
फिर से सदस्यता लेने की सुविधा, हर तरह के मैसेज पर लागू होती है. इसमें प्रमोशन जैसे गैर-ज़रूरी कॉन्टेंट भी शामिल है.
अगर कोई उपयोगकर्ता सदस्यता छोड़ने के बाद आपके कारोबार को मैसेज करता है, तो इसे सदस्यता फिर से लेने का अनुरोध माना जा सकता है.
अगर कोई उपयोगकर्ता मैसेजिंग चैनल के बाहर (उदाहरण के लिए, आपकी वेबसाइट पर) फिर से सदस्यता लेता है, तो 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": "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`	किसी एजेंट को बंद करना.

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

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

लॉन्च की पुरानी स्थिति	लॉन्च की नई स्थिति	कार्रवाई ट्रिगर करना
`UNSPECIFIED`	`PENDING`	समीक्षा के लिए सबमिट करें.
`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 इवेंट मिलेगा.
अगर मैसेज डिलीवर नहीं हुआ है, तो रद्द करने का अनुरोध भेजने के लिए, रद्द करने वाले एपीआई का इस्तेमाल करें.

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