לוקליזציה ולוקאלים

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

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

לוקאל של משתמש

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

Business Messages משתמשת במקום של המשתמש כדי לשנות את השפה בממשק המשתמש ולשנות את השפה של מחרוזות שנוצרות על ידי הפלטפורמה.

userDeviceLocale יכול להשתנות במהלך שיחה אם המשתמש משנה את השפה של המכשיר או עובר בין מכשירים עם הגדרות לוקאל שונות. אם סוכנים יקראו את userDeviceLocale, הם צריכים לבדוק אם הערך השתנה בכל הודעה חדשה, ולהתאים את עצמם בהתאם. לדוגמה, ייתכן שסוכן יזהה שינוי בלוק ולשאול את המשתמש אם הוא רוצה להמשיך לתקשר בשפה הנוכחית או לעבור לשפה שתואמת ללוקאל החדש.

userDeviceLocale צוין לפי המכשיר של המשתמש ויכול להיות כל תג שפה של IETF BCP 47.

הנציג ולוקאל המיקום

הנציגים והמיקומים יכולים לציין הגדרות שיחה לכל אחד מהלוקאלים שבהם הם תומכים. לדוגמה, נציג עשוי לציין הודעת פתיחה באנגלית עבור הלוקאל "en", ושיש לו את אותה הודעה בספרדית עבור הלוקאל "es", או שמיקום אחד עשוי לציין הגדרות ללוקאל "fr" ולמיקום אחר לא.

אם לנציג או למיקום יש הגדרות שיחה ללוקאל, ב-Business Messages ההנחה היא שהסוכן או המיקום תומכים בלוקאל הזה. סוכנים ומיקומים יכולים להגדיר את הלוקאל שמוגדר כברירת המחדל (defaultLocale) שבו הם בדרך כלל מתקשרים.

במאמר עדכון של אזור ברירת המחדל מוסבר איך מעדכנים את הלוקאל של ברירת המחדל. במאמר התחלת השיחה מוסבר איך מתחילים שיחות מקומיות.

לוקאל נפתר

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

הפיצ'ר Business Messages משתמש בלוקאל שעבר פתרון כדי לבחור אילו הגדרות שיחה (כמו הודעות פתיחה והודעות אופליין) ובמחרוזות (כמו הצעת הבקשה לנציג תמיכה אנושית) להצגה. השיטה המומלצת היא שנציגים יתקשרו במיקום שנפתר כדי לשמור על חוויית משתמש עקבית.

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

עדכון של הלוקאל שמוגדר כברירת מחדל

כדי לציין אזור ברירת מחדל, צריך לשלוח בקשה ל-PATCH באמצעות Business Communications API כדי לעדכן את השדה defaultLocale של הנציג או של המיקום.

במאמר התחלת השיחה מוסבר איך משנים את ההגדרות של שיחות עם נציג או מיקום, למשל הודעת פתיחה או התחלת השיחה.

דרישות מוקדמות

לפני שמעדכנים את אזור ברירת המחדל, צריך את הפריטים הבאים:

  • נתיב למפתח חשבון השירות של פרויקט ה-GCP במחשב הפיתוח שלך

  • ללוקאל ברירת המחדל של הסוכן, סוכן name (לדוגמה, 'brands/12345/agents/67890')

    לא יודעים מה name של הנציג? תוכלו להיעזר בהוראות להצגת רשימה של כל הנציגים של מותג.

  • למיקום ברירת המחדל של המיקום, מיקום name (לדוגמה, "brands/12345/locations/67890")

    אם אינכם יודעים את הname של המיקום, קראו את המאמר הצגת כל המיקומים של מותג.

  • הלוקאל שמוגדר כברירת מחדל בתור קוד שפה לפי תקן ISO 639-1 בן שני תווים

  • הגדרות שיחה ספציפיות לאזור הרלוונטיות לנציג או למיקום. לפרטים נוספים, ראו התחלת השיחה.

שליחת בקשת העדכון

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

לוקאל ברירת המחדל של הנציג 


# This code sets the default locale of a Business Messages agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

# Replace the __BRAND_ID__, __AGENT_ID__ and __DEFAULT_LOCALE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "defaultLocale": "__DEFAULT_LOCALE__"
  }
}'
update-agent-bm-defaultLocale.sh

לאפשרויות עיצוב וערכים, קראו את המאמר BusinessMessagesAgent.

לוקאל ברירת המחדל של המיקום 


# This code updates the default locale of an agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/locations/__LOCATION_ID__?updateMask=defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "defaultLocale": "en"
}'
update-location-bm-defaultLocale.sh

למידע על אפשרויות עיצוב וערך, קראו את המאמר brands.locations.