इस पेज का अनुवाद Cloud Translation API से किया गया है.

स्टोर से ऑनलाइन पिकअप खरीदें: बोनसेज का खाना - पहला भाग - शुरू करना

1. परिचय

पिछला अपडेट: 11-05-2022

Business Messages में आपका स्वागत है!

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

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

एक अच्छा डिजिटल एजेंट कैसे बनता है?

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

आपको क्या बनाना है

इस कोडलैब में, आपको Bonjour Meal नाम की एक काल्पनिक कंपनी के लिए, Business Messages पर डिजिटल एजेंट बनाना है. यह डिजिटल एजेंट, "आपका कारोबार किस समय बंद होता है?" या "क्या ऑनलाइन खरीदारी की जा सकती है?" जैसे कुछ आसान सवालों के जवाब देगा.

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

इस कोडलैब में, आपका ऐप्लिकेशन

सुझाव वाले चिप की मदद से सवालों के जवाब देना
उपयोगकर्ता को ऐसे सवाल पूछने के लिए गाइड करें जिनके जवाब आपका डिजिटल एजेंट दे सकता है
उपयोगकर्ता की दिलचस्पी बनाए रखने के लिए, बातचीत वाली बेहतर सुविधाएं दें

ध्यान दें: इस कोडलैब को आसान बनाने और Business Messages का बेहतर अनुभव देने के बुनियादी तरीकों के बारे में बताने के लिए, हम Google Cloud Platform (GCP) का इस्तेमाल कर रहे हैं. इससे, एजेंट इन्फ़्रास्ट्रक्चर के साथ काम करने वाला वेब ऐप्लिकेशन डिप्लॉय किया जा सकेगा. अपने वेब ऐप्लिकेशन को डिप्लॉय करने के लिए, GCP एक बेहतरीन विकल्प है. हालांकि, इसका इस्तेमाल करना ज़रूरी नहीं है.

आपको इनके बारे में जानकारी मिलेगी

Google Cloud Platform पर App Engine पर वेब ऐप्लिकेशन को डिप्लॉय करने का तरीका. इसके अलावा, अपने लोकल ऐप्लिकेशन की सार्वजनिक तौर पर जांच करने के लिए, ngrok का इस्तेमाल किया जा सकता है.
उपयोगकर्ताओं से मैसेज पाने के लिए, वेब ऐप्लिकेशन वेबहुक की मदद से अपने Business Messages खाते को कॉन्फ़िगर करने का तरीका
Business Messages API की मदद से, कार्ड, कैरसेल, और बातचीत वाले सुझाव जैसी रिच सुविधाएं भेजने का तरीका
Business Messages आपके मैसेज कैसे भेजता है

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

आपको इन चीज़ों की ज़रूरत होगी

Business Communications के डेवलपर खाते के लिए रजिस्टर करना
Android 5 या उसके बाद के वर्शन वाला डिवाइस या Google Maps ऐप्लिकेशन वाला iOS डिवाइस
वेब ऐप्लिकेशन प्रोग्रामिंग का अनुभव
इंटरनेट कनेक्शन!

2. सेट अप करना

एपीआई चालू करना

इस कोडलैब में, हम Django ऐप्लिकेशन के साथ काम करेंगे. इसलिए, App Engine पर ऐप्लिकेशन को डिप्लॉय करने के लिए, हम Cloud Build API का इस्तेमाल करेंगे. इसके अलावा, अगर ngrok का इस्तेमाल किया जा रहा है, तो Cloud Build API को चालू करने की ज़रूरत नहीं है.

Cloud Build API को चालू करने के लिए:

Google Cloud Console में, Cloud Build API खोलें.
चालू करें पर क्लिक करें.

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

Business Communications और Business Messages API को ऐक्सेस करने के लिए, आपको एक सेवा खाता बनाना होगा. Business Communications Developer Console में, सेवा खाता बनाने के लिए दस्तावेज़ में दिया गया तरीका अपनाएं.

Django Python EchoBot का शुरुआती कोड डिप्लॉय करना

टर्मिनल में, Django Echo Bot सैंपल को अपने प्रोजेक्ट की वर्किंग डायरेक्ट्री में क्लोन करें. इसके लिए, यह निर्देश इस्तेमाल करें:

$ git clone https://github.com/google-business-communications/bm-bonjour-meal-django-starter-code

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

bm-bonjour-meal-django-starter-code/bonjourmeal-codelab/step-1/resources/bm-agent-service-account-credentials.json

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

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

$ gcloud config set project PROJECT_ID*
$ gcloud app create
$ gcloud app deploy

PROJECT_ID, उस प्रोजेक्ट का प्रोजेक्ट आईडी है जिसका इस्तेमाल आपने एपीआई के साथ रजिस्टर करने के लिए किया था.

आखिरी कमांड के आउटपुट में, डिप्लॉय किए गए ऐप्लिकेशन का यूआरएल नोट करें:

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

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

अपना वेबहुक कॉन्फ़िगर करना

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

वेबहुक यूआरएल, ऐप्लिकेशन का यूआरएल + "/callback/" होगा. उदाहरण के लिए, यह कुछ ऐसा हो सकता है: https://PROJECT_ID.appspot.com/callback/

Business Communications Console के खाता सेटिंग पेज पर जाएं. नेविगेशन बार में सबसे ऊपर दाएं कोने में, आपको अपने GCP प्रोजेक्ट का नाम दिखेगा. अगर आपको कोई ड्रॉपडाउन दिखता है, तो अपना GCP प्रोजेक्ट चुनना न भूलें.

तकनीकी पीओसी की जानकारी भरें. इसके बाद, डिप्लॉय किए गए ऐप्लिकेशन के लिए वेबहुक को वेबहुक यूआरएल से अपडेट करें.

अपने GCP प्रोजेक्ट के रेफ़रंस के बगल में मौजूद, सेव करें पर क्लिक करें.

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

Business Communications Developer Console का इस्तेमाल करना

Business Communications Console में, सबसे ऊपर बाईं ओर मौजूद लोगो पर क्लिक करके, कंसोल के डैशबोर्ड पर वापस जाएं. इसके बाद, एजेंट बनाएं पर क्लिक करें. एजेंट बनाते समय ही ब्रैंड भी बनाया जाता है. एजेंट टाइप के लिए, कारोबार को भेजे जाने वाले मैसेज चुनें. साथ ही, पक्का करें कि पार्टनर की जानकारी सही हो.

ब्रैंड में, उस ब्रैंड का नाम डालें जिसे आपको बनाना है. ब्रैंड वह कारोबार है जिसके साथ काम किया जा रहा है. साथ ही, ग्राहक एजेंट से बातचीत कर सकते हैं. एजेंट का नाम में बताएं कि आपको उपयोगकर्ताओं को Business Messages की बातचीत में क्या दिखाना है. काल्पनिक Bonjour Meal के मामले में, Bonjour Rail एक रेलवे कंपनी है, जो Bonjour Meal रेस्टोरेंट को मैनेज करती है. इसलिए, मैं ब्रैंड के तौर पर Bonjour Rail और एजेंट के तौर पर Bonjour Meal की जानकारी दूंगा.

एजेंट, बातचीत करने वाली ऐसी इकाई होती है जो ब्रैंड की ओर से बातचीत करती है.

एजेंट बनाएं पर क्लिक करें और कंसोल को कुछ समय दें. ब्रैंड और एजेंट बनाने के लिए, Business Communications API को कई अनुरोध करने में कुछ सेकंड लगते हैं. एजेंट और ब्रैंड बनाने के लिए, Business Communications API का सीधे तौर पर इस्तेमाल किया जा सकता है. दस्तावेज़ देखें और जानें कि कंसोल के काम करने के तरीके के हिसाब से, कर्ल अनुरोध कैसा दिखेगा.

पहली बातचीत करना

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

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

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

अपने एजेंट के बातचीत वाले प्लैटफ़ॉर्म को चालू करने के लिए, लॉन्च करें पर टैप करें.

एजेंट से इंटरैक्ट करें और जानें कि यह क्या-क्या कर सकता है. ज़्यादातर मामलों में, आपको यह दिखेगा कि बातचीत वाली सुविधा सिर्फ़ आपके मैसेज को दोहराएगी. "नमस्ते, दुनिया!" जैसा कोई मैसेज भेजें. आपको एजेंट से वही मैसेज वापस मिलेगा.

डिप्लॉय किए गए ऐप्लिकेशन में, Business Messages पर उपलब्ध बेहतर सुविधाओं को दिखाने के लिए कुछ लॉजिक भी शामिल हैं.

"कार्ड" भेजने पर, आपको रिच कार्ड दिखेगा
"चिप" भेजने पर, सुझाव वाले चिप दिखेंगे
"कैरसेल" भेजने पर, रिच कार्ड का कैरसेल दिखेगा

बधाई हो! यह आपके एजेंट की आपसे पहली बातचीत है!

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

वेलकम मैसेज अपडेट करना और बातचीत वाले चिप इस्तेमाल करना

आइए, Developer Console का इस्तेमाल करके कुछ अभ्यास करें. एजेंट के वेलकम मैसेज में बदलाव करने का तरीका जानें. साथ ही, उपयोगकर्ता के साथ बातचीत करने में मदद करने के लिए, सुझाव वाले चिप का इस्तेमाल करने का तरीका जानें.

एजेंट की खास जानकारी वाले पेज पर जाएं और एजेंट की जानकारी चुनें. नीचे की ओर स्क्रोल करके, वेलकम मैसेज और बातचीत शुरू करने के लिए सवालों वाले सेक्शन पर जाएं.

वेलकम मैसेज (पीले रंग का इनपुट फ़ील्ड) को इस तरह अपडेट करें:

Bonjour के 'खाना बनाने में मदद करने वाले एजेंट' में आपका स्वागत है. मैं आपके मैसेज को दोहरा सकता हूं और आपको इस प्लैटफ़ॉर्म पर उपलब्ध कुछ बेहतर सुविधाएं दिखा सकता हूं. इन सुझावों को आज़माएं!

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

बदलाव करने के बाद, Console में एजेंट की जानकारी इस तरह दिखती है:

कंसोल की दाईं ओर, आपको एजेंट के दिखने का तरीका दिखता है. ध्यान दें कि आपने वेलकम मैसेज में जो बदलाव किया है वह उसमें दिख रहा है. साथ ही, उसके नीचे सुझाव वाले चिप भी दिख रहे हैं.

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

माफ़ करें, हम इन बदलावों को बातचीत में तुरंत नहीं देख पाएंगे. ऐसा इसलिए है, क्योंकि पिछला डेटा, Business Messages के इन्फ़्रास्ट्रक्चर में कैश मेमोरी में सेव होता है. कैश मेमोरी करीब-करीब हर दो घंटे में मिटाई जाती है. इसलिए, आपको कल इसे आज़माने में कोई समस्या नहीं होगी.

इस बीच, आइए देखें कि यह सुविधा कैसे काम करती है.

4. स्टार्टर कोड का विश्लेषण करना

सोर्स कोड का खास व्यू

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

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

हाई लेवल पर, Django यूआरएल को व्यू पर भेजेगा. साथ ही, व्यू लॉजिक एक टेंप्लेट बनाता है, जो ब्राउज़र में रेंडर होता है. आइए, प्रोजेक्ट के urls.py फ़ाइल पर एक नज़र डालते हैं.

bm-django-echo-bot/bmcodelab/urls.py [31 से 37 लाइनें]

from django.urls import include, path
import bopis.views as bopis_views

urlpatterns = [
    path('', bopis_views.landing_placeholder),
    path('callback/', bopis_views.callback),
]

यहां दो रूट तय किए गए हैं. इसलिए, अगर उन दो यूआरएल की पहचान की जाती है, तो Django लॉजिक को लागू कर सकता है. प्रोजेक्ट का यूआरएल https://PROJECT_ID.appspot.com/ है. इसलिए, प्रोजेक्ट के लिए ये रूट उपलब्ध हैं:

https://PROJECT_ID.appspot.com/
https://PROJECT_ID.appspot.com/callback/

दोनों यूआरएल रूट, bopis_views पर ले जाते हैं, जो bopis/views.py से आता है. आइए, देखते हैं कि इस फ़ाइल में क्या हो रहा है. शुरू करने के लिए, पहले bopis_views.landing_placeholder को समझते हैं.

bm-django-echo-bot/bonjourmeal-codelab/step-1/bopis/views.py [Lines 302-309]

... 
def landing_placeholder(request):
    return HttpResponse("<h1>Welcome to the Bonjour Meal Codelab</h1>
    <br/><br/>
    To message your Bonjour Meal agent, go to the Developer Console and retrieve
    the Test URLs for the agent you have created as described in the codelab
    <a href='https://codelabs.developers.google.com/codelabs/'>here</a>.")
...

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

दूसरा यूआरएल, bopis/views.py में मौजूद callback नाम के फ़ंक्शन पर ले जाता है. आइए, इस फ़ंक्शन के बारे में जानते हैं.

bm-django-echo-bot/bopis/views.py [Lines 60-101]

...
def callback(request):
    """
    Callback URL. Processes messages sent from user.
    """
    if request.method == "POST":
        request_data = request.body.decode('utf8').replace("'", '"')
        request_body = json.loads(request_data)

        print('request_body: %s', request_body)

        # Extract the conversation id and message text
        conversation_id = request_body.get('conversationId')
        print('conversation_id: %s', conversation_id)

        # Check that the message and text body exist

        if 'message' in request_body and 'text' in request_body['message']:
            message = request_body['message']['text']

            print('message: %s', message)
            route_message(message, conversation_id)
        elif 'suggestionResponse' in request_body:
            message = request_body['suggestionResponse']['postbackData']

            print('message: %s', message)
            route_message(message, conversation_id)
        elif 'userStatus' in request_body:
            if 'isTyping' in request_body['userStatus']:
                print('User is typing')
            elif 'requestedLiveAgent' in request_body['userStatus']:
                print('User requested transfer to live agent')

        return HttpResponse("Response.")

    elif request.method == "GET":
        return HttpResponse("This webhook expects a POST request.")
...

यहां दिया गया लॉजिक, message या suggestionResponse के लिए अनुरोध बॉडी को पार्स करता है और उस जानकारी को route_message नाम के फ़ंक्शन में भेजता है. इसके बाद, मैसेज मिलने की पुष्टि करने के लिए, Business Messages के इन्फ़्रास्ट्रक्चर को HttpResponse दिखाता है.

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

Business Messages, मैसेज के कॉन्टेंट को JSON पेलोड के तौर पर आपके वेबहुक पर भेजता है. यहां इसे लाइव एजेंट को भेजा जाता है या बॉट के तौर पर जवाब देने के लिए किसी लॉजिक पर भेजा जाता है. हमारे मामले में, रूटिंग मेकैनिज़्म route_message है. आइए इस पर एक नज़र डालें.

bm-django-echo-bot/bopis/views.py [लाइनें 105-122]

...
def route_message(message, conversation_id):
    '''
    Routes the message received from the user to create a response.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    normalized_message = message.lower()

    if normalized_message == CMD_RICH_CARD:
        send_rich_card(conversation_id)
    elif normalized_message == CMD_CAROUSEL_CARD:
        send_carousel(conversation_id)
    elif normalized_message == CMD_SUGGESTIONS:
        send_message_with_suggestions(conversation_id)
    else:
        echo_message(message, conversation_id)
...

इस लॉजिक से, उपयोगकर्ता को मिले मैसेज की जांच शुरू होती है. सबसे पहले, सभी वर्णों को छोटा करके मैसेज को सामान्य किया जाता है. नॉर्मलाइज़ होने के बाद, यह जांच की जाती है कि मैसेज, फ़ाइल में सबसे ऊपर बताई गई किसी भी कॉन्स्टेंट से मेल खाता है या नहीं.

bm-django-echo-bot/bopis/views.py [लाइनें 40-42]

...
# Set of commands the bot understands
CMD_RICH_CARD = 'card'
CMD_CAROUSEL_CARD = 'carousel'
CMD_SUGGESTIONS = 'chips'
...

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

मैसेज भेजना

इसलिए, अब आपको इस बारे में पता चल गया होगा कि वेब ऐप्लिकेशन को मैसेज कैसे मिलते हैं. यह काम, वेबहुक करता है.

लेकिन, Business Messages का इस्तेमाल करके, ऐप्लिकेशन किसी उपयोगकर्ता को आउटबाउंड मैसेज कैसे भेजता है?

जब आपका इन्फ़्रास्ट्रक्चर उपयोगकर्ता को जवाब देता है, तो आप Business Messages API को जवाब भेजते हैं. इसके बाद, यह एपीआई उपयोगकर्ता को मैसेज भेजता है.

Business Messages API में Python, Node.js, और Java की लाइब्रेरी हैं. हमारे पास एक REST API भी है. अगर आपका इन्फ़्रास्ट्रक्चर ऐसी भाषा में नहीं है जिसकी लाइब्रेरी हमारे पास है, तो सीधे तौर पर इसकी मदद से अनुरोध किए जा सकते हैं. किसी खास बातचीत के आईडी पर मैसेज भेजने के लिए, cURL का इस्तेमाल कैसे किया जाता है, यह जानने के लिए मैसेज भेजना लेख पढ़ें.

इस कोडलैब के लिए, हम Python क्लाइंट लाइब्रेरी का इस्तेमाल करने पर फ़ोकस करेंगे. यह लाइब्रेरी, Bonjour Meal के स्टार्टर कोड में पहले से ही इंटिग्रेट है. इस कोड को आपके GCP प्रोजेक्ट पर App Engine में डिप्लॉय किया गया है या ngrok की मदद से लोकल तौर पर चलाया जा रहा है.

आइए, echo_message फ़ंक्शन को देखें और जानें कि Business Messages पर मैसेज भेजने के लिए, हम एपीआई के साथ कैसे इंटरैक्ट करते हैं.

bm-django-echo-bot/bopis/views.py [Lines 199-212]

...
def echo_message(message, conversation_id):
    '''
    Sends the message received from the user back to the user.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text=message)

    send_message(message_obj, conversation_id)
...

इस फ़ंक्शन में, echo_message फ़ंक्शन में पास किए गए मैसेज वैरिएबल की मदद से, BusinessMessagesMessage को इंस्टैंशिएट किया जाता है. इंस्टैंशिएट होने के बाद, ऑब्जेक्ट को बातचीत आईडी के साथ send_message को पास कर दिया जाता है.

bm-django-echo-bot/bopis/views.py [लाइनें 214-236]

...
def send_message(message, conversation_id):
    '''
    Posts a message to the Business Messages API, first sending
    a typing indicator event and sending a stop typing event after
    the message has been sent.

    Args:
        message (obj): The message object payload to send to the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    credentials = ServiceAccountCredentials.from_json_keyfile_name(
        SERVICE_ACCOUNT_LOCATION,
        scopes=['https://www.googleapis.com/auth/businessmessages'])

    client = bm_client.BusinessmessagesV1(credentials=credentials)

    # Create the message request
    create_request = BusinessmessagesConversationsMessagesCreateRequest(
        businessMessagesMessage=message,
        parent='conversations/' + conversation_id)

    bm_client.BusinessmessagesV1.ConversationsMessagesService(
        client=client).Create(request=create_request)
...

send_message फ़ंक्शन, आपके सेवा खाते के क्रेडेंशियल का इस्तेमाल करके यह पुष्टि करता है कि आपके पास इस बातचीत में मैसेज भेजने की अनुमति है. साथ ही, यह Business Messages क्लाइंट को इंस्टैंशिएट करता है और दिए गए conversation ID को मैसेज भेजने का अनुरोध करता है.

रिच फ़ीचर भी इस send_message फ़ंक्शन का इस्तेमाल करते हैं. हालांकि, ये ऐसे मैसेज बनाते हैं जो रिच कार्ड, कैरसेल, और सुझाव वाले चिप के लिए खास होते हैं. रिच कार्ड और कैरसेल में ग्राफ़िक एसेट शामिल की जा सकती हैं. वहीं, सुझाव वाले चिप में postback_data होता है, ताकि कॉलबैक लॉजिक उसे सही तरीके से पार्स कर सके.

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

जब आप तैयार हों, तो आइए Bonjour Meal एजेंट को पसंद के मुताबिक बनाएं.

5. अपने एजेंट को पसंद के मुताबिक बनाना

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

ठीक है, यह बहुत अच्छा नहीं है. असल में, यह कुछ खाली लग रहा है और हमारे कारोबार को सही तरीके से नहीं दिखा रहा है. सौभाग्य से, हमारे पास एजेंट के साथ काम करने वाले कोड की बुनियादी जानकारी है. साथ ही, हमारे पास ऐसे टूल हैं जिनकी मदद से हम अपने एजेंट को अपनी पसंद के मुताबिक बना सकते हैं.

इस कोडलैब के बाकी हिस्से में, हम एजेंट को इनके साथ जोड़ेंगे:

असल लोगो को शामिल करना
बेहतर वेलकम मैसेज
कारोबार के खुले होने के समय की जानकारी देना
उपयोगकर्ता को बताएं कि सामान ऑनलाइन खरीदने की सुविधा जल्द ही उपलब्ध होगी
बातचीत को आसान बनाने के लिए, बातचीत वाले सुझाव वाले चिप का इस्तेमाल करना

हम Business Communications Console का इस्तेमाल करके, लोगो और वेलकम मैसेज को अपडेट करेंगे. हालांकि, आपके पास सीधे Business Communications API का इस्तेमाल करके भी ऐसा करने का विकल्प है. इसके बाद, हमें सोर्स कोड को अपडेट करना होगा, ताकि कारोबार के खुले होने के समय की जानकारी देने के लिए सही मैसेज भेजे जा सकें. साथ ही, Bonjour Meal जल्द ही ऑनलाइन शॉपिंग की सुविधा उपलब्ध कराएगा. इसके बाद, हम Business Communications Console पर वापस आ जाएंगे और बातचीत के सुझाव वाले चिप बनाएंगे. इनसे, बातचीत को ऐसे अनुभवों तक ले जाने में मदद मिलेगी जिनमें डिजिटल एजेंट काम करता है.

लोगो शामिल करना

Business Communications कंसोल में, अपना एजेंट चुनें और एजेंट की जानकारी पर जाएं. हमें कारोबार का लोगो अपडेट करना है, जैसा कि यहां पीले रंग में दिखाया गया है.

अपलोड करें पर क्लिक करें. इसके बाद, अपलोड करने या यूआरएल से इंपोर्ट करने के लिए कोई इमेज चुनें.

दस्तावेज़ में लोगो डिज़ाइन के दिशा-निर्देश देखें. इससे आपको अपने लोगो इस्तेमाल करने के सबसे सही तरीकों के बारे में पता चलेगा.

आइए, उस लोगो को अपलोड करें जो इस कोडलैब की शुरुआत में क्लोन किए गए सोर्स कोड में मौजूद है. यह आपको डेटा स्टोर करने की जगह की ./assets/ डायरेक्ट्री में दिखेगी. इस फ़ाइल का नाम "bonjour_meal-logo.png" है. फ़ाइल को वेब ब्राउज़र पर मौजूद मॉडल में खींचकर लाया जा सकता है. इसके बाद, इमेज की क्वालिटी में बदलाव करने और उसे काटने के लिए, आपको एक आसान बदलाव करने वाला टूल दिखेगा. इमेज का रिज़ॉल्यूशन और काट-छांट करें, ताकि इमेज का साइज़ 50 केबी या उससे कम हो. इमेज से संतुष्ट होने पर, पुष्टि करने के लिए नीले सर्कल में मौजूद सही का निशान पर क्लिक करें. इसके बाद, मॉडल के सबसे नीचे मौजूद चुनें पर क्लिक करें.

आखिर में, एजेंट की जानकारी पेज पर सबसे ऊपर दाईं ओर मौजूद, सेव करें पर क्लिक करें. इस बदलाव को आपके डिवाइस पर दिखने में कुछ समय लगेगा, क्योंकि एजेंट की जानकारी हमारे सर्वर में कैश मेमोरी में सेव होती है. बदलाव होने के दो घंटे के अंदर यह जानकारी दिखने लगती है.

वेलकम मैसेज अपडेट करना

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

Business Communications Console में, अपना एजेंट चुनें और एजेंट की जानकारी पर जाएं. नीचे की ओर स्क्रोल करके, वेलकम मैसेज इनपुट फ़ील्ड पर जाएं. यहां मैसेज अपडेट किया जा सकता है.

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

"Bonjour Meal में आपका स्वागत है. मैं एक असिस्टेंट हूं. Bonjour Meal के बारे में आपके सवालों के जवाब देने में मेरी मदद मिल सकती है. इनमें से कुछ विकल्प आज़माएं."

आखिर में, एजेंट की जानकारी पेज पर सबसे ऊपर दाईं ओर मौजूद, सेव करें पर क्लिक करें. फिर से, कैश मेमोरी के हमारे तरीके की वजह से, इस बदलाव को दिखने में कुछ समय लगेगा. ऐसा इसलिए किया जाता है, ताकि आपको तेज़ी से जानकारी मिल सके!

कारोबार के खुले होने के समय की जानकारी देना

उपयोगकर्ताओं को यह जानकारी देने के लिए, हम Business Messages API का इस्तेमाल करके, उपयोगकर्ता को कस्टम मैसेज भेजेंगे.

आपको याद होगा कि मैसेज, views.py के route_message फ़ंक्शन में पार्स किए जाते हैं. यह फ़ंक्शन सबसे पहले स्ट्रिंग को सामान्य बनाता है. इसके बाद, यह जांचना शुरू करता है कि सामान्य किया गया मैसेज, हार्ड कोड किए गए किसी पैरामीटर से मेल खाता है या नहीं. आसानी के लिए, एक और शर्त जोड़ें. इसमें हम यह देखेंगे कि नॉर्मलाइज़ किया गया मैसेज, एक नए कॉन्स्टेंट से मेल खाता है या नहीं. हम इस कॉन्स्टेंट को CMD_BUSINESS_HOURS_INQUIRY कहेंगे और इसमें "business-hours-inquiry" वैल्यू होगी. अगर शर्त सही होती है, तो हम send_message_with_business_hours नाम के फ़ंक्शन को लागू करेंगे.

route_message फ़ंक्शन अब इस तरह दिखेगा:

bm-django-echo-bot/bopis/views.py

...
def route_message(message, conversation_id):
    '''
    Routes the message received from the user to create a response.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    normalized_message = message.lower()

    if normalized_message == CMD_RICH_CARD:
        send_rich_card(conversation_id)
    elif normalized_message == CMD_CAROUSEL_CARD:
        send_carousel(conversation_id)
    elif normalized_message == CMD_SUGGESTIONS:
        send_message_with_suggestions(conversation_id)
    elif normalized_message == CMD_BUSINESS_HOURS_INQUIRY:
        send_message_with_business_hours(conversation_id)
    else:
        echo_message(message, conversation_id)
...

कोड के काम करने के लिए, हमें दो और बदलाव करने होंगे. पहला, अन्य कॉन्स्टेंट के साथ CMD_BUSINESS_HOURS_INQUIRY तय करना. दूसरा, फ़ंक्शन send_message_with_business_hours तय करना और Business Messages API का इस्तेमाल करके मैसेज भेजना.

सबसे पहले, फ़ाइल में सबसे ऊपर मौजूद कॉन्स्टेंट को अन्य कॉन्स्टेंट के एलान के साथ तय करें:

bm-django-echo-bot/bopis/views.py

...
# Set of commands the bot understands
CMD_RICH_CARD = 'card'
CMD_CAROUSEL_CARD = 'carousel'
CMD_SUGGESTIONS = 'chips'
CMD_BUSINESS_HOURS_INQUIRY = 'business-hours-inquiry'
...

अब, send_message_with_business_hours की परिभाषा तय करने के लिए. इस फ़ंक्शन को फ़ाइल में कहीं भी तय किया जा सकता है. इसके लिए, Python के सही सिंटैक्स का इस्तेमाल करें. यह फ़ंक्शन, echo_message की तरह ही सिर्फ़ एक मैसेज भेजता है. इसलिए, इस फ़ंक्शन को तय करने के लिए, इसका इस्तेमाल टेंप्लेट के तौर पर किया जा सकता है.

bm-django-echo-bot/bopis/views.py

...
def send_message_with_business_hours(conversation_id):

    message = '''Thanks for contacting us! The hours for the store are:\n
    MON 8am - 8pm\n
    TUE 8am - 8pm\n
    WED 8am - 8pm\n
    THU 8am - 8pm\n
    FRI 8am - 8pm\n
    SAT 8am - 8pm\n
    SUN 8am - 8pm
    '''

    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text=message)

    send_message(message_obj, conversation_id)
...

इसके बाद, जब कोई व्यक्ति "business-hours-inquiry" मैसेज भेजेगा, तो हमारा बॉट उसे कारोबार के खुले होने के समय की जानकारी दे पाएगा. आपको इस तरह का मैसेज दिख सकता है:

सोर्स कोड को GCP पर डिप्लॉय करने के बाद, बदलाव तुरंत दिखने लगेंगे. हम Google Cloud Platform में वेब ऐप्लिकेशन को उसी तरह से कैश मेमोरी में सेव नहीं करते जिस तरह एजेंट की जानकारी को सेव किया जाता है. इसलिए, आपको इस सुविधा को तुरंत आज़माने का मौका मिलेगा.

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

उपयोगकर्ता को यह बताना कि ऑनलाइन खरीदारी की सुविधा जल्द ही उपलब्ध होगी

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

सामान्य किए गए मैसेज को पार्स करें और CMD_ONLINE_SHOPPING_INQUIRY नाम के कॉन्स्टेंट की शर्त की जांच करें. इस कॉन्स्टेंट की वैल्यू "online-shopping-inquiry" पर सेट है. शर्त सही होने पर, send_online_shopping_info_message को ट्रिगर किया जाता है.

bm-django-echo-bot/bopis/views.py

...
# Set of commands the bot understands
CMD_RICH_CARD = 'card'
CMD_CAROUSEL_CARD = 'carousel'
CMD_SUGGESTIONS = 'chips'
CMD_BUSINESS_HOURS_INQUIRY = 'business-hours-inquiry'
CMD_ONLINE_SHOPPING_INQUIRY = 'online-shopping-inquiry'
...
...
...
def route_message(message, conversation_id):
    '''
    Routes the message received from the user to create a response.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    normalized_message = message.lower()

    if normalized_message == CMD_RICH_CARD:
        send_rich_card(conversation_id)
    elif normalized_message == CMD_CAROUSEL_CARD:
        send_carousel(conversation_id)
    elif normalized_message == CMD_SUGGESTIONS:
        send_message_with_suggestions(conversation_id)
    elif normalized_message == CMD_BUSINESS_HOURS_INQUIRY:
        send_message_with_business_hours(conversation_id)
    elif normalized_message == CMD_ONLINE_SHOPPING_INQUIRY:
        send_online_shopping_info_message(conversation_id)
    else:
        echo_message(message, conversation_id)
...

अब send_online_shopping_info_message की परिभाषा बताई गई है. हमें यह मैसेज, इमेज के साथ रिच कार्ड में भेजना है. इसलिए, send_rich_card फ़ंक्शन को कॉपी करके, send_online_shopping_info_message को तय करने के लिए टेंप्लेट के तौर पर इस्तेमाल करें.

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

bm-django-echo-bot/bopis/views.py

...
def send_online_shopping_info_message(conversation_id):
    fallback_text = ('Online shopping will be available soon!')

    rich_card = BusinessMessagesRichCard(
        standaloneCard=BusinessMessagesStandaloneCard(
            cardContent=BusinessMessagesCardContent(
                title='Online shopping info!',
                description='Thanks for your business, we are located in SF near the Golden Gate Bridge. Online shopping is not yet available, please check back with us in a few days.',
                suggestions=[],
                media=BusinessMessagesMedia(
                    height=BusinessMessagesMedia.HeightValueValuesEnum.MEDIUM,
                    contentInfo=BusinessMessagesContentInfo(
                        fileUrl=SAMPLE_IMAGES[4],
                        forceRefresh=False
                    ))
                )))

    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        richCard=rich_card,
        fallback=fallback_text)

    send_message(message_obj, conversation_id)
...

बहुत बढ़िया! हमारा डिजिटल एजेंट, अब ऑनलाइन खरीदारी के बारे में पूछने वाले उपयोगकर्ताओं को जवाब दे सकता है. फ़िलहाल, हमारा डिजिटल एजेंट ऑनलाइन शॉपिंग की सुविधा नहीं देता. इसलिए, हम उपयोगकर्ता को एक मैसेज भेजते हैं, जिसमें उन्हें बताया जाता है कि यह सुविधा जल्द ही उपलब्ध होगी. जब कोई उपयोगकर्ता ऑनलाइन शॉपिंग के बारे में पूछता है, तो हमारा डिजिटल एजेंट ऐसा दिखता है.

उपयोगकर्ता को कारोबार के खुले होने के समय के बारे में पूछताछ करने की अनुमति देने के लिए, हमने जो बदलाव किया था उसी तरह, ngrok का इस्तेमाल करने पर या GCP App Engine में कोड को डिप्लॉय करने के तुरंत बाद, यह बदलाव दिख सकता है.

अगले लेख में, हम बातचीत शुरू करने वाले सवालों और सुझाव वाले चिप का इस्तेमाल करेंगे, ताकि बातचीत को सही दिशा में ले जाया जा सके.

बातचीत को दिशा देने के लिए चिप का इस्तेमाल करना

हमने सोर्स कोड में कुछ बदलाव किए हैं और अपडेट किया गया डिजिटल एजेंट डिप्लॉय किया है. हालांकि, हम कभी नहीं चाहेंगे कि उपयोगकर्ता कारोबार के बारे में पूछताछ करने के लिए, "business-hours-inquiry" या "online-shopping-info" टाइप करें. बातचीत शुरू करने के लिए कुछ ऐसे सवालों को अपडेट करें कि बातचीत शुरू करने पर, उपयोगकर्ता को न सिर्फ़ एक अच्छा वेलकम मैसेज मिले, बल्कि बातचीत शुरू करने के लिए कुछ सवाल भी दिखें.

Business Communications Console पर जाएं और अपने एजेंट का एजेंट की जानकारी पेज ऐक्सेस करें. हमने पहले "चिप", "कार्ड", और "कैरसेल" के लिए, बातचीत शुरू करने के तरीके तय किए थे. हालांकि, वे अब भी काम करते हैं, लेकिन अब वे हमारे कारोबार के काम के नहीं हैं. इन बेहतर सुविधाओं को दिखाना जारी रखने के लिए, उन्हें छोड़ा जा सकता है या हटाया जा सकता है. ऐसा करने पर, आपका डिजिटल एजेंट, खास तौर पर Bonjour Meal के कारोबार के लिए बातचीत शुरू करने वाले वाक्यांश दिखाएगा.

हम बातचीत शुरू करने के लिए दो नए सवाल जोड़ रहे हैं. पहले सवाल के लिए, टेक्स्ट को "आपके कारोबार के खुले होने का समय क्या है?" पर सेट करें. साथ ही, पोस्टबैक डेटा को "business-hours-inquiry" पर सेट करें. बातचीत शुरू करने के लिए दूसरे सवाल के टेक्स्ट को "क्या यहां खरीदारी की जा सकती है?" पर सेट करें. साथ ही, पोस्टबैक डेटा को "online-shopping-info" पर सेट करें.

इसका नतीजा, नीचे दिए गए स्क्रीनशॉट जैसा कॉन्फ़िगरेशन होना चाहिए:

Business Communications Console में किए गए अन्य बदलावों की तरह ही, आपको अपने मोबाइल डिवाइस पर ये बदलाव दिखने में कुछ समय लगेगा.

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

फ़ंक्शन के आखिर में, यह जोड़ें:

bm-django-echo-bot/bopis/views.py

...
def send_online_shopping_info_message(conversation_id):
...
    # at the end of the function, send a message with suggestions
    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text='Let us know how else we can help you:',
        fallback='Please let us know how else we can help you.',
        suggestions=[
            BusinessMessagesSuggestion(
                reply=BusinessMessagesSuggestedReply(
                text='Business hours',
                postbackData='business-hours-inquiry')
            ),
        ])

    send_message(message_obj, conversation_id)
...

# Let's do the same with the business hours
def send_message_with_business_hours(conversation_id):
...
    # at the end of the function, send a message with suggestions
    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text='Let us know how else we can help you:',
        fallback='Please let us know how else we can help you.',
        suggestions=[
            BusinessMessagesSuggestion(
                reply=BusinessMessagesSuggestedReply(
                text='Can I purchase online?',
                postbackData='online-shopping-inquiry')
            ),
        ])

    send_message(message_obj, conversation_id)
...

ध्यान रखें कि BusinessMessagesSuggestion में मौजूद टेक्स्ट फ़ील्ड में 25 से ज़्यादा वर्ण नहीं डाले जा सकते. इस बारे में दस्तावेज़ में बताया गया है.

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

6. बधाई हो

बधाई हो, आपने Business Messages में अपना पहला डिजिटल एजेंट बना लिया है!

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

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

यहां एक टीज़र दिया गया है, जिसमें बताया गया है कि यह कैसा दिख सकता है.

मैं बातचीत वाली सुविधा को बेहतर कैसे बनाऊं?

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

कॉन्टेक्स्ट दें और दर्शकों की उम्मीदें तय करें

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

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

उपयोगकर्ता को फ़ंक्शन उपलब्ध कराना

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

उपयोगकर्ता की दिलचस्पी बनाए रखना

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

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

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

आगे क्या करना है?

जब आप तैयार हों, तब Business Messages में ज़्यादा जटिल इंटरैक्शन के बारे में जानने के लिए, यहां दिए गए कुछ विषयों को देखें

रेफ़रंस दस्तावेज़

SuggestedReply
Business Messages के मैसेज का रेफ़रंस दस्तावेज़
RichCard के लिए JSON की परिभाषा