अपना वेबहुक सेट करें

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

पार्टनर-लेवल और एजेंट-लेवल वेबहुक

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

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

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

अपना पार्टनर-लेवल वेबहुक सेट करें

पार्टनर-लेवल वेबहुक सेट करने के लिए, यह तरीका अपनाएं:

  1. Business Communications डेवलपर कंसोल खोलें और अपने Business Messages Google खाते से साइन इन करें.
  2. खाता सेटिंग खोलें.
  3. पक्का करें कि सही पार्टनर खाता चुना गया हो.
  4. Business Messages के वेबहुक यूआरएल के लिए, कॉन्फ़िगर करें पर क्लिक करें.
  5. वेबहुक एंडपॉइंट यूआरएल के लिए, अपने ऐप्लिकेशन का यूआरएल + "/callback/" डालें. उदाहरण के लिए, "https://PROJECT_ID.appspot.com/callback/" जैसा कुछ हो सकता है.
  6. अपनी clientToken वैल्यू नोट करें. आपको इस बात की पुष्टि करनी होगी कि आपको जो मैसेज मिल रहे हैं वे Google से आ रहे हैं या नहीं.
  7. अपने वेबहुक को कॉन्फ़िगर करें, ताकि बताए गए clientToken पैरामीटर के साथ पोस्ट अनुरोध स्वीकार किया जा सके. साथ ही, रिस्पॉन्स पैरामीटर के तौर पर सीक्रेट पैरामीटर की सादे टेक्स्ट वाली वैल्यू के साथ 200 OK जवाब भेजे. उदाहरण के लिए, मान लें कि आपके वेबहुक को जानकर दिए गए बॉडी कॉन्टेंट के साथ एक POST अनुरोध मिलता है:

    {
    "clientToken":"SJENCPGJESMGUFPY",
      "secret":"0123456789"
    }
    

    ऐसे में, आपके वेबहुक की मदद से clientToken वैल्यू की पुष्टि की जानी चाहिए. अगर clientToken सही है, तो जवाब के मुख्य हिस्से के तौर पर 0123456789 के साथ 200 OK रिस्पॉन्स दें.

  8. कंसोल में, पुष्टि करें पर क्लिक करें. जब Business Messages आपके वेबहुक की पुष्टि करेगा, तो डायलॉग बंद हो जाएगा.

एजेंट-लेवल का वेबहुक सेट करें

आपको अपने एजेंट-लेवल वेबहुक के मैसेज भेजे जाते हैं. इसके बजाय, अगर किसी खास एजेंट को किसी दूसरे वेबहुक पर भेजना है, तो एजेंट-लेवल का वेबहुक सेट करें.

  1. Business Communications डेवलपर कंसोल खोलें और अपने Business Messages Google खाते से साइन इन करें.
  2. अपने एजेंट पर क्लिक करें.
  3. इंटिग्रेशन पर क्लिक करें.
  4. वेबहुक के लिए, कॉन्फ़िगर करें पर क्लिक करें.
  5. वेबहुक एंडपॉइंट यूआरएल के लिए, अपने वेबहुक का यूआरएल डालें. यह यूआरएल "https://" से शुरू होता है.
  6. अपनी clientToken वैल्यू नोट करें. आपको इस बात की पुष्टि करनी होगी कि आपको जो मैसेज मिल रहे हैं वे Google से आ रहे हैं या नहीं.
  7. अपने वेबहुक को कॉन्फ़िगर करें, ताकि बताए गए clientToken पैरामीटर से एक पोस्ट अनुरोध स्वीकार किया जा सके. साथ ही, सीक्रेट पैरामीटर की वैल्यू के साथ 200 OK जवाब भेजें. उदाहरण के लिए, मान लें कि आपके वेबहुक को नीचे दी गई बॉडी सामग्री के साथ POST अनुरोध मिलता है:

    {
      "clientToken":"SJENCPGJESMGUFPY",
      "secret":"0123456789"
    }
    

    ऐसे में, आपके वेबहुक की मदद से clientToken की वैल्यू की पुष्टि की जानी चाहिए. अगर clientToken सही है, तो 200 OK रिस्पॉन्स को 0123456789 में सेट सीक्रेट यूआरएल पैरामीटर के साथ दिखाएं.

  8. कंसोल में, पुष्टि करें पर क्लिक करें. जब Business Messages आपके वेबहुक की पुष्टि करेगा, तो डायलॉग बंद हो जाएगा.