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

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

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

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

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

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

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

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

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

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

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

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

לוקאל שטופל

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

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

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

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

כדי לציין לוקאל ברירת מחדל, צריך לשלוח בקשת PATCH בעזרת התקשורת העסקית 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.