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

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

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

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

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

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

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

‫userDeviceLocale מוגדר על ידי המכשיר של המשתמש ויכול להיות כל תג שפה של IETF BCP 47.

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

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

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

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

לוקאל שנפתר

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

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

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

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

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

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

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

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

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

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

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

# 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__"
  }
}'

אפשרויות העיצוב והערכים מפורטות במאמר בנושא 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"
}'

אפשרויות העיצוב והערכים מפורטות במאמר בנושא brands.locations.