הרשמה ב-Business Messages

כשנרשמים כשותפים ב-Business Messages, אפשר להפעיל שיחות בין משתמשים ומותגים על ידי יצירת נציגים – ישויות שיחה שמייצגות פונקציות עסקיות, כמו תמיכה באתר, ומיקומי מותגים.

כשמשתמש מוצא מותג שאתם מנהלים בחיפוש Google או במפות Google, תוצאות החיפוש מציגות את האפשרות צ'אט. כשהמשתמש לוחץ על Chat, הוא יכול לשלוח הודעות לסוכן המותג. הנציג מאפשר לכם לקבל את ההודעות של המשתמש ולהגיב עליהן.

הרשמה כשותפים

כשנרשמים כשותפים ב-Business Messages, יוצרים נציגים של מותגים ומשתמשים בממשקי API של הנציג, אפשר להפעיל חוויות צ'אט בשירותי הלקוחות, במכירות ובאפליקציות עסקיות אחרות.

  1. פותחים את מסוף המפתחים של תקשורת עסקית.
  2. בקטע Business Messages, לוחצים על יצירת חשבון שותף.

  3. מזינים את הערכים של פרטי השותף:

    שדה ערך
    איך קוראים לך? שמך המלא
    שם השותף שם הארגון שלך
    האתר של השותף האתר של הארגון שלך
    אזור האזור שבו רוצים לארח את השירות Business Messages

  1. קוראים ומאשרים את התנאים וההגבלות של Business Messages.

  2. לוחצים על יצירה.

ודאו שאתם רשומים כשותפים של Business Messages ויש לכם גישה ל-Business Messages ול-Business Communications APIs. Business Messages API שולח הודעות למשתמשים, ואילו Business Communications API מנהל את הנציגים.

יצירה של חשבון שירות

כדי לבצע אימות מאובטח של קריאות ל-API ב-Business Messages וב-Business Communications APIs, צריך מפתח של חשבון שירות וכלי שורת הפקודה oauth2l.

  1. בדף הבית של Business Communications Developer Console, לוחצים על הגדרות חשבון שותף.
  2. בחלונית הניווט הימנית, לוחצים על Service account.

  3. לוחצים על Create key ואז על Create.

    הדפדפן מוריד את המפתח של חשבון השירות. מאחסנים את המפתח של חשבון השירות במיקום מאובטח ופרטי. אין לשתף את המפתח באופן ציבורי. אפשר יהיה להשתמש במפתח הזה מאוחר יותר כדי לגשת ל-Business Messages ול-Business Communication APIs.

הגדרת חוברת האינטרנט

עכשיו, כש-Business Messages ו-Business Communications API מופעלים, צריך לציין את ה-webhook URL כדי להתחיל לקבל הודעות.

  1. פותחים את הגדרות החשבון ב-Business Communications Developer Console.
  2. מוודאים שנבחר חשבון השותף הנכון.
  3. ליד כתובת ה-URL של ה-webhook של Business, לוחצים על Configure (הגדרה).
  4. בשדה webhook URL של נקודת הקצה מזינים את ה-webhook URL שמתחילים ב-https:// .
  5. שימו לב לערך של clientToken. יהיה עליכם לוודא שהודעות שאתם מקבלים מגיעות מ-Google.

  6. מגדירים את התגובה לפעולה מאתר אחר (webhook) כך שתקבל בקשה מסוג POST עם הפרמטר clientToken שצוין, וישלח תגובה 200 OK עם ערך הטקסט הפשוט של הפרמטר secret כגוף התגובה.

    לדוגמה, אם ה-webhook שלכם יקבל בקשת POST עם התוכן הבא בגוף ההודעה

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

    ה-webhook שלך צריך לאשר את הערך של clientToken. אם התגובה הנכונה היא clientToken, עליך להחזיר תגובה של 200 OK כגוף התגובה (0123456789).

  7. במסוף, לוחצים על אימות.

    כשמערכת Business Messages מאמתת את התגובה לפעולה מאתר אחר (webhook), תיבת הדו-שיח נסגרת.

במאמר דוגמה לעדכון webhook URL מוסבר איך להגדיר את ה-webhook עם ממשקי ה-API של תקשורת עסקית.

קבלת מידע על שותף

כדי לקבל את פרטי השותף הנוכחיים שלכם, אתם יכולים לבצע שאילתה ל-Business Connect 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 Developer Console או להריץ את הפקודות הבאות.

מחליפים את PARTNER_ID במזהה השותף(מזהה השותף נמצא ב-Business Communications Developer Console). בנוסף, מחליפים את 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',
}"

דוגמה: עדכון webhook URL

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',
      },
    },
  ],
}"

השלבים הבאים

עכשיו, כשאתם שותפים רשומים והפעלתם את ממשקי ה-API, תוכלו להתחיל לפתח עם Business Messages. רוצה לנסות מהר? כאן מוסבר איך יוצרים את הנציג הראשון.

אחרת, מומלץ ליצור נציגים שמייצגים את המותגים שלכם בשיחות, ולהגדיר את התגובה לפעולה מאתר אחר (webhook) כדי לקבל הודעות ממשתמשים.