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

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

• अगर आपने 7 मार्च, 2022 से पहले पार्टनर खाते के लिए रजिस्टर किया है, तो आपको Business Messages API चालू करना होगा. Business Communications API और Business Messages API को चालू करना लेख पढ़ें.

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

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

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

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

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

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

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

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

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

4. 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 हेल्पर बॉट, आपको अपने एजेंट के साथ तेज़ी से बातचीत शुरू करने की सुविधा देता है, ताकि आपको इस प्लैटफ़ॉर्म की सुविधाओं के बारे में जानकारी मिल सके. हेल्पर बॉट को चालू करना ज़रूरी नहीं है. हालांकि, अपना पहला एजेंट बनाते समय आपको ऐसा करने का सुझाव दिया जाता है.

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

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

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

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

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

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

1. एजेंट के टेस्ट यूआरएल ऐक्सेस करें. ऐसा करने के कुछ तरीके यहां दिए गए हैं:

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

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

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

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

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

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

हेल्पर बॉट को बंद करने पर, यह आपके एजेंट के लिए मैसेज भेजने और पाने की सुविधा नहीं देता. अब आपके पास अपने एजेंट को सेट अप करने का विकल्प है, ताकि वह मैसेज भेजने की प्रक्रिया को मैनेज कर सके.

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

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

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

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. Business Communications डेवलपर कंसोल में खाता सेटिंग खोलें.
2. पक्का करें कि सही पार्टनर खाता चुना गया है.
3. Business Messages के वेबहुक यूआरएल के लिए, कॉन्फ़िगर करें पर क्लिक करें.

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

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

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

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

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

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

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 के बारे में ज़्यादा जानें. साथ ही, यह भी जानें कि इस प्लैटफ़ॉर्म पर क्या-क्या किया जा सकता है.

• Business Messages के काम करने के तरीके के बारे में ज़्यादा जानें.

• Business Messages की ज़रूरी शर्तें और दिशा-निर्देश पढ़ें.

• मैसेज पाने का तरीका पढ़कर, इको बॉट में बदलाव करें और अपने कारोबारी नियम के मुताबिक जवाब दें.

• अपने इन्फ़्रास्ट्रक्चर की पुष्टि करें.

• ज़्यादा एजेंट और जगहें लॉन्च करें.