Business Messages में रजिस्टर करें

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

जब उपयोगकर्ता को ऐसा ब्रैंड मिलता है जिसे आप Google Search या Google Maps पर मैनेज करते हैं, तो खोज के नतीजों में Chat का विकल्प दिखता है. जब उपयोगकर्ता Chat पर क्लिक करता है, तो वह ब्रैंड के एजेंट को मैसेज भेज सकता है. एजेंट आपको उपयोगकर्ता के संदेश मिलने और उनका जवाब देने की सुविधा देता है.

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

Business Messages में पार्टनर के तौर पर रजिस्टर करके, ब्रैंड के लिए एजेंट बनाकर, अपने एजेंट को असरदार बनाने वाले एपीआई का इस्तेमाल करके, आप ग्राहक सेवाओं, बिक्री, और दूसरे कारोबारी ऐप्लिकेशन के लिए मैसेज सेवा देने की सुविधा चालू कर सकते हैं.

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

  3. अपने पार्टनर की जानकारी के लिए वैल्यू डालें:

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

  1. Business Messages की सेवा की शर्तें पढ़ें और स्वीकार करें.

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

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

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

Business Messages और Business Communications एपीआई को एपीआई कॉल की सुरक्षित तरीके से पुष्टि करने के लिए, आपको एक सेवा खाता कुंजी और oauth2l कमांड लाइन टूल की ज़रूरत होगी.

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

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

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

अपनी किताब सेट करें

Business Messages और Business Communications एपीआई चालू है, इसलिए मैसेज पाने के लिए, आपको अपने वेबहुक यूआरएल की जानकारी देनी होगी.

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

  6. बताए गए clientToken पैरामीटर वाले POST अनुरोध को स्वीकार करने के लिए, अपने वेबहुक को कॉन्फ़िगर करें. इसके बाद, रिस्पॉन्स के मुख्य हिस्से के तौर पर secret पैरामीटर की सादे लेख वाली वैल्यू के साथ 200 OK जवाब भेजें.

    उदाहरण के लिए, अगर आपके वेबहुक को नीचे दिए गए बॉडी कॉन्टेंट के साथ POST का अनुरोध मिलता है, तो

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

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

  7. कंसोल में, पुष्टि करें पर क्लिक करें.

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

वेबहुक यूआरएल अपडेट करें को देखें और जानें कि Business Communication API से अपने वेबहुक को कैसे कॉन्फ़िगर करें.

पार्टनर की जानकारी पाएं

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

यह निर्देश चलाएं. PARTNER_ID को अपने पार्टनर आईडी से बदलें.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
get-partner.sh

पार्टनर की जानकारी अपडेट करें

अपने पार्टनर की जानकारी अपडेट करने के लिए, Business Communications डेवलपर कंसोल में खाता सेटिंग पेज का इस्तेमाल करें या नीचे दिए गए निर्देश चलाएं.

PARTNER_ID को अपने पार्टनर आईडी से बदलें(पार्टनर आईडी, Business Communications डेवलपर कंसोल में मिलता है). साथ ही, UPDATED_FIELDS को आपके अपडेट किए गए फ़ील्ड के नामों से बदलें


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'
update-partner.sh

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

उदाहरण: डिसप्ले नेम अपडेट करना

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

उदाहरण: वेबहुक यूआरएल अपडेट करें

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

अगले चरण

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

अगर ऐसा नहीं है, तो बातचीत में अपने ब्रैंड को शामिल करने के लिए, एजेंट बनाने का तरीका जानें. साथ ही, लोगों से मैसेज पाने के लिए, वेबहुक को कॉन्फ़िगर करने का तरीका जानें.