अपना पहला एजेंट बनाएं

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

अपना एजेंट बनाएं

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

इस क्विकस्टार्ट में, आपको ये काम करने होंगे:

  • पार्टनर के तौर पर रजिस्टर करें
  • एक ब्रैंड और एजेंट बनाएं
  • इसके अलावा, Business Messages की मदद से बातचीत में दी जाने वाली सुविधाओं के बारे में भी जानें हेल्पर बॉट
  • मैसेज भेजने और पाने के लिए, अपने एजेंट को सेट अप करें

सैंपल का इस्तेमाल किए बिना एजेंट बनाने के लिए, अपना एजेंट बनाएं पर जाएं.

पार्टनर के तौर पर रजिस्टर करें

  1. खोलें Business Communications डेवलपर कंसोल पर क्लिक करें.
  2. Business Messages में जाकर, पार्टनर खाता बनाएं पर क्लिक करें.

  3. अपने पार्टनर की जानकारी डालें:

    फ़ील्ड मान
    आपका नाम आपका पूरा नाम
    पार्टनर का नाम आपके संगठन का नाम
    पार्टनर वेबसाइट आपके संगठन की वेबसाइट
    क्षेत्र वह इलाका जहां आपको Business Messages सेवा को होस्ट करना है

  4. Google Play डेवलपर की ओर से Business Messages की सेवा की शर्तें.

  5. बनाएं पर क्लिक करें.

अब आपको Business Messages के पार्टनर के तौर पर रजिस्टर कर लिया गया है. आपके लिए एक नया Google Cloud प्रोजेक्ट बनाया गया है. इसमें Business Messages और Business Communications एपीआई चालू हैं. आपके पास इस प्रोजेक्ट का ऐक्सेस नहीं है. साथ ही, इससे आपके किसी भी मौजूदा Google Cloud प्रोजेक्ट में रुकावट नहीं आएगी.

अब आपके पास Business Messages और Business Communications एपीआई का ऐक्सेस है.

सेवा खाता बनाना

  1. Business Communications डेवलपर कंसोल होम पेज पर, पार्टनर खाता सेटिंग पर क्लिक करें.
  2. बाएं नेविगेशन में, क्लिक करें सेवा खाता.

  3. बनाएं पर क्लिक करें. इसके बाद, बनाएं पर क्लिक करें.

    आपका ब्राउज़र, सेवा खाते की कुंजी डाउनलोड करता है. इसे स्टोर में रखें स्थान. वेब ऐप्लिकेशन डिप्लॉय करने के लिए, आपको बाद में इस कुंजी की ज़रूरत होगी और आने वाले समय में Business Messages और Business Communications एपीआई को ऐक्सेस किया जा सकेगा.

एक ब्रैंड और एजेंट बनाएं

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

  1. Business Communications डेवलपर खोलें कंसोल और अपने Business Messages के Google खाते से साइन इन करें.
  2. एजेंट बनाएं पर क्लिक करें.
  3. एजेंट टाइप के लिए, Business Messages को चुनें.
  4. ब्रैंड का नाम और एजेंट का नाम के लिए वैल्यू डालें.
  5. इनमें से कोई एक काम करें:
    • एजेंट के साथ हुई बातचीत के बारे में जानने के लिए उपलब्ध सुविधाओं के लिए, Business Messages हेल्पर बॉट चालू करें को चुनें.
    • अपने एजेंट को पसंद के मुताबिक बनाने और उसे मैसेज मैनेज करने के लिए तैयार करने के लिए, चुने हुए का निशान हटाएं Business Messages हेल्पर बॉट को चालू करें.
  6. एजेंट बनाएं पर क्लिक करें.

अगर आपने Business Messages हेल्पर बॉट को चालू किया है, तो तुरंत बातचीत शुरू की जा सकती है. या फिर, मैसेज मैनेज करने के लिए अपने एजेंट को सेट अप करें पर जाएं.

Business Messages हेल्पर बॉट की मदद से, सुविधाओं के बारे में जानें

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

हेल्पर बॉट की मदद से, ये काम किए जा सकते हैं

  • बेहतर सुविधाओं के बारे में जानें
  • सुविधाओं को लागू करने का तरीका जानें
  • एजेंट को सेटअप करने के लिए संसाधन देखें

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

हेल्पर बॉट की मदद से बातचीत शुरू करना

Business Messages हेल्पर बॉट को चालू करने के बाद, बातचीत शुरू की जा सकती है. एजेंट बनाए जाने के तुरंत बाद, एक डायलॉग बॉक्स खुलता है, ताकि आपको शुरुआत करने में मदद मिल सके.

हेल्पर बॉट के साथ इंटरैक्ट करने के लिए, इस डायलॉग बॉक्स में यह तरीका अपनाएं:

  1. एजेंट के टेस्ट यूआरएल को ऐक्सेस करें. ऐसा करने के लिए, ये तरीके आज़माए जा सकते हैं:

    • Android बटन या iOS बटन पर क्लिक करें. इसके बाद, क्यूआर कोड स्कैन करें संबंधित मोबाइल डिवाइस के साथ और लॉन्च करें पर क्लिक करें. इसके अलावा, कॉपी करने के लिए Android यूआरएल कॉपी करें या iOS यूआरएल कॉपी करें पर क्लिक करें टेस्ट यूआरएल.
    • अपने ईमेल पते पर यूआरएल भेजने के लिए, भेजें पर क्लिक करें.

  2. अपने मोबाइल डिवाइस पर यूआरएल खोलें. (iOS डिवाइसों के लिए ज़रूरी है कि Google Maps app.)

हेल्पर बॉट को बंद करें

अपने एजेंट को ज़रूरत के मुताबिक बनाने और उसे लॉन्च के लिए तैयार करने से पहले, आपको ये काम करने होंगे Business Messages हेल्पर बॉट को बंद करें.

हेल्पर बॉट को बंद करने के लिए,

  1. Business Communications डेवलपर खोलें कंसोल पर क्लिक करें.
  2. अपना एजेंट चुनें.
  3. बाईं ओर मौजूद नेविगेशन में, इंटिग्रेशन पर क्लिक करें.
  4. हेल्पर बॉट के लिए, बंद करें पर क्लिक करें.

हेल्पर बॉट बंद होने पर, यह आपका एजेंट. अब आप इन शर्तों को पूरा करने के लिए अपना एजेंट सेट अप कर सकते हैं मैसेज भेजने का फ़्लो.

मैसेज मैनेज करने के लिए अपना एजेंट सेट अप करें

इस गाइड में, आपको Google Cloud Platform (GCP) पर इको बॉट को वेबहुक को उपयोगकर्ता के मैसेज प्रोसेस करने के लिए बनाया गया है.

Echo Bot एक सैंपल ऐप्लिकेशन है. इसकी मदद से, उपयोगकर्ता को मैसेज फिर से दिखते हैं. यह आपको बेहतर सुविधाओं के साथ एक्सपेरिमेंट करने की अनुमति देता है, जैसे कि सुझाई गई कार्रवाइयां और रिच कार्ड, आपके एजेंट से बातचीत की जा सकती है. इको बॉट का इस्तेमाल शुरुआती दौर के तौर पर आपके एजेंट को डेवलप करने के लिए.

आपको ये चरण पूरे करने होंगे:

  • इको बॉट सैंपल को GCP में डिप्लॉय करें
  • Business Messages के पार्टनर खाते के लिए, वेबहुक यूआरएल कॉन्फ़िगर करें
  • अपने एजेंट के बारे में बुनियादी जानकारी दें

इस गाइड के आखिर में, आपका एजेंट मैसेज भेजने और पाने के लिए तैयार हो जाएगा.

वेब ऐप्लिकेशन को GCP में डिप्लॉय करें

Business Messages, उपयोगकर्ताओं के मैसेज को वेबहुक पर फ़ॉरवर्ड करता है आपके इन्फ़्रास्ट्रक्चर में बेहतरीन है. इस गाइड में, आपको Echo Bot सैंपल को डिप्लॉय करना होगा. सोर्स कोड को पहले से कॉन्फ़िगर किए गए वेबहुक में. अगर आपके पास पहले से ही वेब इन्फ़्रास्ट्रक्चर है, तो तो उस वेबहुक पर नया वेबहुक बनाया जा सकता है. सेवा का इस्तेमाल कर रहे हैं, लेकिन आपको लॉजिक खुद कॉन्फ़िगर करना होगा. यहां जाएं: पार्टनर-लेवल का वेबहुक सेट करना देखें.

क्लाउड एनवायरमेंट बनाना

आपको Echo Bot सैंपल को डिप्लॉय करने के लिए क्लाउड एनवायरमेंट की ज़रूरत होगी.

क्लाउड एनवायरमेंट के तौर पर GCP प्रोजेक्ट बनाने के लिए, यह तरीका अपनाएं:

  1. खोलें Google Cloud Console प्रोजेक्ट सिलेक्टर.

    अगर आपने कभी Google Cloud प्रोजेक्ट नहीं बनाया है, तो आपको शर्तें और सेवाएं स्वीकार करनी होंगी.

  2. प्रोजेक्ट बनाएं पर क्लिक करें.

  3. अपने नए प्रोजेक्ट का नाम और जगह डालें

    • आपका प्रोजेक्ट आईडी अपने-आप जनरेट होता है. यह आपके प्रोजेक्ट के नाम के नीचे दिखता है.
    • जगह फ़ील्ड में, ब्राउज़ करें पर क्लिक करके अपने प्रोजेक्ट के लिए संभावित जगहें देखें. अगर आपको अपना Google Workspace संगठन नहीं मिल रहा है, तो इसका मतलब है कि आपने Google Workspace खाते से साइन इन नहीं किया है. किसी संगठन के बिना भी प्रोजेक्ट बनाया जा सकता है. हालांकि, कुछ सुविधाएं उपलब्ध नहीं हैं. ज़्यादा जानकारी के लिए, संगठन के संसाधन के फ़ायदे देखें.

  4. बनाएं पर क्लिक करें.

  5. मेन्यू पर क्लिक करें.

  6. बिलिंग पर क्लिक करें.

  7. बिलिंग खाता लिंक करें पर क्लिक करें.

  8. प्रोजेक्ट के लिए, नया बिलिंग खाता बनाएं या कोई मौजूदा बिलिंग खाता जोड़ें. पेमेंट के तरीकों के बारे में जानने के लिए, Google Cloud Free Program की सुविधाएं देखें.

इको बॉट सैंपल डिप्लॉय करें

  1. gcloud सीएलआई इंस्टॉल करें. Google Cloud पर सैंपल कोड को डिप्लॉय करने के लिए, इस कोड का इस्तेमाल किया जा सकता है.

  2. Echo Bot का सैंपल डाउनलोड करें और एक्सट्रैक्ट करें (Node.js, Java, Python).

  3. डाउनलोड की गई JSON क्रेडेंशियल फ़ाइल कॉपी करें सैंपल के संसाधन फ़ोल्डर में सेवा खाता बनाएं और क्रेडेंशियल का नाम बदलकर "bm-agent-service-account-Credentials.json" करें. इस क्रेडेंशियल फ़ाइल का पाथ आपके डाउनलोड किए गए सैंपल पर निर्भर करता है.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. किसी टर्मिनल में, सैंपल की Full_sample डायरेक्ट्री पर जाएं.

  5. सैंपल डिप्लॉय करने के लिए, किसी टर्मिनल में इन कमांड को चलाएं:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID, आपके उस प्रोजेक्ट का प्रोजेक्ट आईडी है जिसमें आपने बनाया है क्लाउड एनवायरमेंट बनाना. प्रोजेक्ट आईडी, Google Cloud के प्रोजेक्ट डैशबोर्ड पर मौजूद होता है.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID, आपके उस प्रोजेक्ट का प्रोजेक्ट आईडी है जिसमें आपने बनाया है क्लाउड एनवायरमेंट बनाना. प्रोजेक्ट आईडी, Google Cloud के प्रोजेक्ट डैशबोर्ड पर मौजूद होता है.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID, आपके उस प्रोजेक्ट का प्रोजेक्ट आईडी है जिसमें आपने बनाया है क्लाउड एनवायरमेंट बनाना. प्रोजेक्ट आईडी, Google Cloud के प्रोजेक्ट डैशबोर्ड पर मौजूद होता है.

  6. आखिरी निर्देश के आउटपुट में, डिप्लॉय किए गए ऐप्लिकेशन का यूआरएल देखें. यह आपके वेबहुक यूआरएल का बेस है:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

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

अब जब Echo Bot को डिप्लॉय किया जा चुका है, आपको एक वेबहुक यूआरएल (जो कि ऑपरेट करने के लिए) मैसेज पाना.

  1. खोलें खाता सेटिंग पर जाकर देखें.
  2. पक्का करें कि सही पार्टनर खाता चुना गया है.
  3. Business Messages के वेबहुक यूआरएल के लिए, कॉन्फ़िगर करें पर क्लिक करें.

  4. वेबहुक एंडपॉइंट यूआरएल के लिए, अपने ऐप्लिकेशन का यूआरएल + "/callback" डालें.

    आपका एंडपॉइंट इस फ़ॉर्मैट में होगा: "https://PROJECT_ID.appspot.com/callback".

    यह एंडपॉइंट, आपके सैंपल के ऐप्लिकेशन लॉजिक में पहले से तय होता है GCP पर डिप्लॉय किया गया है.

  5. Developer Console में, पुष्टि करें पर क्लिक करें.

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

Business Communications API की मदद से अपना वेबहुक कॉन्फ़िगर करने के लिए, देखें उदाहरण: वेबहुक यूआरएल अपडेट करें.

Business Messages के टेस्ट फ़्रेमवर्क का इस्तेमाल किया जा सकता है ताकि यह जांच की जा सके कि आपका वेबहुक, Business Messages के पेलोड का जवाब दे रहा है या नहीं.

एजेंट की जानकारी डालें

अपने एजेंट का सेटअप पूरा करने के लिए, कुछ बुनियादी जानकारी दें.

  1. Business Communications डेवलपर खोलें कंसोल पर क्लिक करें.
  2. बाईं ओर मौजूद नेविगेशन में, एजेंट की जानकारी पर क्लिक करें.

  3. वैल्यू को जैसे चाहें अपडेट करें या नीचे दिए गए सुझावों का इस्तेमाल करें:

    फ़ील्ड मान
    वेलकम मैसेज Echo Bot बातचीत में आपका स्वागत है!
    निजता नीति https://policies.google.com/privacy

  4. सेव करें पर क्लिक करें.

बातचीत शुरू करें

इको बॉट के साथ इंटरैक्ट करने के लिए, यह तरीका अपनाएं:

  1. Business Communications डेवलपर खोलें कंसोल पर क्लिक करें.
  2. बाईं ओर मौजूद नेविगेशन में, एजेंट की जानकारी पर क्लिक करें.
  3. एजेंट टेस्ट यूआरएल में, Android बटन या iOS बटन पर क्लिक करें.

  4. उससे जुड़े मोबाइल डिवाइस से क्यूआर कोड स्कैन करें या कॉपी करें पर क्लिक करें एजेंट के टेस्ट यूआरएल को कॉपी करने के लिए, Android यूआरएल या iOS यूआरएल कॉपी करें.

    अपने ईमेल पते पर यूआरएल भेजने के लिए, भेजें पर भी क्लिक किया जा सकता है.

  5. अपने मोबाइल डिवाइस पर यूआरएल खोलें. (iOS डिवाइसों के लिए ज़रूरी है कि Google Maps ऐप्लिकेशन.)

आपके एजेंट का वेलकम मैसेज आपका स्वागत करता है. इस समय, आपके पास इको बॉट. इसमें उन मैसेज को भी शामिल किया जाता है जो आपको वापस भेजे जाते हैं. साथ ही, आपके पास ये विकल्प हैं विशिष्ट स्ट्रिंग भेजकर रिच सुविधाओं को शुरू करें: “कैरोसेल”, “कार्ड”, “चिप”.

अगले चरण

अपना पहला एजेंट बनाने के बाद, अब Business Messages के बारे में ज़्यादा जानें इस प्लैटफ़ॉर्म पर और क्या-क्या किया जा सकता है.