इवेंट पाएं

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

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

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

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

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

उदाहरण

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

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

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

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

सदस्यता छोड़ने की वजहें, 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)	START
  स्पेन (ES), मेक्सिको (MX)	ALTA
  फ़्रांस (FR)	Démarrer
  ब्राज़ील (BR)	começar

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

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

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

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

एजेंट के लॉन्च की स्थिति में बदलाव हुआ है

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

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

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

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

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

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

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 फ़ील्ड, एजेंट के लॉन्च की नई स्थिति दिखाता है. यहां संभावित वैल्यू दी गई हैं:

डेटा फ़ील्ड में, 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"
}

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

ये ऐसे बदलाव हैं जिनकी अनुमति है. आम तौर पर, समीक्षा और लागू करने की प्रोसेस के दौरान, मोबाइल और इंटरनेट सेवा देने वाली कंपनियां इन्हें मैनेज करती हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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