การแปลและภาษา

ผู้ใช้สื่อสารจากสถานที่ต่างๆ และในหลายภาษา ตัวแทนที่ตอบสนองต่อความต้องการในการสื่อสารของผู้ใช้และแปลประสบการณ์การใช้งานให้เป็นภาษาท้องถิ่นจะเข้าถึงผู้ใช้ได้มากขึ้น สร้างประสบการณ์การใช้งานที่ตอบโจทย์ผู้ใช้ได้มากขึ้น และกระตุ้นให้เกิดการโต้ตอบซ้ำๆ มากกว่าตัวแทนที่ไม่ตอบสนอง 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 แบบ 2 ตัวอักษร

  • การตั้งค่าการสนทนาเฉพาะภาษาที่ตั้งไว้สำหรับตัวแทนหรือสถานที่ โปรดดู เริ่มการ สนทนา

ส่งคำขออัปเดต

หากต้องการอัปเดตตัวแทนหรือสถานที่ ให้เรียกใช้คำสั่งต่อไปนี้ แทนที่ตัวแปร ด้วยค่าที่ระบุไว้ใน ข้อกำหนดเบื้องต้น

ภาษาเริ่มต้นของตัวแทน 

# 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