इवेंट पाएं

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

इन इवेंट को उनके सोर्स के हिसाब से कैटगरी में बांटा जाता है:

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

आपका एजेंट, उपयोगकर्ता के डिवाइस पर जो स्टेटस इवेंट भेजता है उनके बारे में ज़्यादा जानने के लिए, इवेंट भेजना लेख पढ़ें.

टेक्स्ट, फ़ाइलें, जगह की जानकारी वगैरह जैसे उपयोगकर्ता के मैसेज मैनेज करने के तरीके के बारे में जानने के लिए, मैसेज पाना लेख पढ़ें.

उपयोगकर्ता के इवेंट

उपयोगकर्ता इवेंट, उपयोगकर्ता के डिवाइस से मिलने वाली सूचनाएं होती हैं.इनसे मैसेज की स्थिति या सदस्यता में हुए बदलावों की जानकारी मिलती है. जैसे, उपयोगकर्ता ने 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 में आरबीएम बातचीत की सदस्यता छोड़कर इस इवेंट को ट्रिगर करते हैं.

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

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

सदस्यता छोड़ने की सुविधा कैसे काम करती है

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

    कीवर्ड, उपयोगकर्ता के फ़ोन नंबर में मौजूद देश के दो अक्षरों वाले कोड से तय होता है. यहां दी गई टेबल में, उन देशों के लिए कीवर्ड की सूची दी गई है जहां यह सुविधा उपलब्ध है.

    देश (देश का कोड) सदस्यता छोड़ने के लिए कीवर्ड
    अमेरिका (US), भारत (IN), यूनाइटेड किंगडम (GB), जर्मनी (DE), नीदरलैंड्स (NL) बंद करें
    स्पेन (ES), मेक्सिको (MX) BAJA
    फ़्रांस (FR) STOP
    ब्राज़ील (BR) parar
  • सदस्यता छोड़ने के बाद भी, उपयोगकर्ता के इनबॉक्स में बातचीत बनी रहती है. हालांकि, अगर बातचीत की शिकायत स्पैम के तौर पर की जाती है, तो उसे स्पैम और ब्लॉक किए गए फ़ोल्डर में भेज दिया जाता है.

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

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

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

उदाहरण

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

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

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

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

चयन के दौरान होने वाले पक्षपात को कम करने के लिए, हर उपयोगकर्ता को पहले चार विकल्प किसी भी क्रम में दिखाए जाते हैं. यह क्रम, उपयोगकर्ता के हर विज़िट के दौरान एक जैसा रहता है. साथ ही, अन्य विकल्प सबसे नीचे ही रहता है.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • आरबीएम मैसेज सेवा के लिए, अपना वेबहुक कॉन्फ़िगर करें. उपयोगकर्ता के मैसेज और उपयोगकर्ता के इवेंट पाने के लिए, ऐसा करना ज़रूरी है.
  • उपयोगकर्ता इवेंट और एजेंट लॉन्च स्टेट इवेंट के बीच अंतर करने के लिए, 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 फ़ील्ड से, एजेंट के लॉन्च की नई स्थिति का पता चलता है. यहां संभावित वैल्यू दी गई हैं:

वैल्यू एजेंट लॉन्च की स्थिति विवरण
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"
}

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

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

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

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

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

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