เทมเพลตข้อความ

คุณต้องใช้เทมเพลตข้อความในการเปิดการสนทนาเพื่อการตลาด อรรถประโยชน์ และการยืนยันตัวตน การสนทนาเหล่านี้อาจเป็นข้อความการให้บริการลูกค้าหรือการเตือนความจำการนัดหมาย การอัพเดตการชำระเงินหรือการจัดส่ง การแจ้งเตือน และอื่นๆ

ข้อกำหนด

• เทมเพลตข้อความต้องได้รับอนุมัติเสียก่อนจึงจะนำไปใช้เปิดการสนทนาได้ เรียนรู้เพิ่มเติม
• หากต้องการเปิดการสนทนาเพื่อการตลาด อรรถประโยชน์ และการยืนยันตัวตนกับลูกค้า ลูกค้าจะต้องเลือกรับข้อความจากธุรกิจของคุณเสียก่อน เรียนรู้เพิ่มเติม

หมวดหมู่เทมเพลตที่รองรับ

โปรดดูที่หมวดหมู่

การแปล

เมื่อส่งเทมเพลตข้อความ คุณต้องระบุภาษาโดยใช้ช่อง language ธุรกิจของคุณมีหน้าที่รับผิดชอบในการแปลทั้งหมดที่คุณต้องการใช้

ภาษาที่รองรับ

แพ็คเกจภาษา

ระบบจัดเก็บเทมเพลตข้อความไว้ในแพ็คเกจภาษา โดยแพ็คเกจภาษาคือชุดรวมองค์ประกอบเทมเพลตข้อความสำหรับภาษาหรือรูปแบบภาษาเฉพาะ หากธุรกิจรองรับการแปลอย่างน้อยหนึ่งรายการสำหรับภาษาหรือรูปแบบภาษาหนึ่ง ระบบจะสร้างแพ็คเกจสำหรับภาษาหรือรูปแบบภาษานั้นขึ้น

เนมสเปซเทมเพลตข้อความคือชุดแพ็คเกจภาษาสำหรับธุรกิจเฉพาะ

ตัวเลือกนโยบายภาษา

หากส่งเทมเพลตข้อความโดยตั้งค่าช่อง language: policy เป็น deterministic ซึ่งเป็นค่าเริ่มต้น WhatsApp จะส่งเทมเพลตข้อความในภาษาและรูปแบบภาษาตรงตามที่ร้องขอ จากนั้นอุปกรณ์จะสืบค้นเซิร์ฟเวอร์เพื่อหาแพ็คเกจภาษาของภาษานั้นโดยเฉพาะ

เมื่อส่งข้อความนี้ไปยังอุปกรณ์ อุปกรณ์นั้นจะดำเนินการดังต่อไปนี้

• การตรวจสอบนโยบาย/กฎเกณฑ์ - "policy": "deterministic" และ "code": "en" ที่กำหนดให้จะมีแพ็คเกจ en ที่แคชบนอุปกรณ์หรือไม่

  • หากมี ให้ไปที่การตรวจสอบองค์ประกอบ
  • หากไม่มี ฉันสามารถค้นหาแพ็คเกจ en บนเซิร์ฟเวอร์ได้หรือไม่

    • หากได้ ให้อัพเดตแคชเฉพาะที่และไปที่การตรวจสอบองค์ประกอบ
    • หากไม่พบ ให้ลงบันทึกความล้มเหลว เซิร์ฟเวอร์จะส่งคืนข้อผิดพลาด structure_unavailable ผ่าน Webhook และจะไม่มีข้อความแสดงขึ้นบนอุปกรณ์

• ตรวจสอบองค์ประกอบ - มีองค์ประกอบ "element": "hello_world" อยู่หรือไม่

  • หากมี ให้แยกไฟล์พารามิเตอร์และแสดงข้อความบนอุปกรณ์
  • หากไม่มี:

    • หากแพ็คเกจภาษามาจากแคชเฉพาะที่ ให้ดาวน์โหลดแพ็คเกจ en ล่าสุดจากเซิร์ฟเวอร์และดำเนินการตรวจองค์ประกอบซ้ำ
    • หากเพิ่งดาวน์โหลดแพ็คเกจภาษาจากเซิร์ฟเวอร์ ให้ลงบันทึกความล้มเหลว เซิร์ฟเวอร์จะส่งคืนข้อผิดพลาด structure_unavailable ผ่าน Webhook และจะไม่มีข้อความแสดงบนอุปกรณ์

ระบบจะเพิกเฉยต่อการตั้งค่าภาษา/รูปแบบภาษาของอุปกรณ์

ปัญหาที่อาจเกิดขึ้นเมื่อใช้นโยบาย deterministic คือสิ่งที่คุณส่งคำขอมาไม่มีอยู่ ตรวจสอบให้แน่ใจดังนี้

• เนมสเปซถูกต้อง
• ชื่อองค์ประกอบถูกต้อง
• การแปลภาษา/รูปแบบภาษามีอยู่ในองค์ประกอบดังกล่าว
• จำนวนพารามิเตอร์ที่ส่งไปตรงกับที่ได้ระบุไว้ในเทมเพลตข้อความ

การแปลเป็นภาษาท้องถิ่น

เทมเพลตข้อความมอบการรองรับการแปลภาษาให้เลยโดยไม่ต้องตั้งค่าใดเพิ่มเติม โดยแปลข้อความตามการตั้งค่ารูปแบบภาษาของอุปกรณ์

พารามิเตอร์ที่แปลได้

เทมเพลตมีพารามิเตอร์ที่รวมเข้ากับข้อความได้แบบไดนามิก สำหรับตัวอย่างที่ใช้ในเอกสารนี้ เทมเพลตข้อความจะมีลักษณะดังนี้

"You made a purchase for {{1}} using a credit card ending in {{2}}."

สำหรับ "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" ที่มี "element_name": "purchase_with_credit_card" ค่าแรกที่คุณลงรายการจะแทนที่ตัวแปร {{1}} ในเทมเพลตข้อความ และค่าที่สองที่คุณลงรายการจะแทนที่ตัวแปร {{2}}

พารามิเตอร์เหล่านี้บางส่วน (เช่น date_time หรือ currency) สามารถแปลเป็นภาษาท้องถิ่นได้ เพื่อให้พารามิเตอร์แสดงอย่างเหมาะสมตามการตั้งค่าภาษาและรูปแบบภาษาของลูกค้า หากอุปกรณ์แปลพารามิเตอร์เป็นภาษาถิ่นไม่สำเร็จ อุปกรณ์จะคืนค่ากลับไปเป็นค่าเริ่มต้น fallback_value

หากคุณต้องระบุสกุลเงินและวันที่เพิ่มเติมจากค่า fallback_value ให้ใช้อ็อบเจ็กต์ currency และ date_time ซึ่งช่วยให้ไคลเอ็นต์สามารถแปลข้อมูลนี้เป็นภาษาท้องถิ่นในวิธีที่ดีที่สุดที่เป็นไปได้ และกลับไปใช้ค่าเริ่มต้น fallback_value หากไม่สามารถแปลข้อมูลเป็นภาษาท้องถิ่นได้

ตัวเลือก localizable_params จะแสดงในตารางด้านล่างดังนี้:

พารามิเตอร์

อ็อบเจ็กต์ currency

ไคลเอ็นต์ Whatsapp Business API พยายามจัดรูปแบบสกุลเงินตามการแปลเป็นภาษาท้องถิ่นที่ระบุ

ตัวอย่าง

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

อ็อบเจ็กต์ date_time

ไคลเอ็นต์ Whatsapp Business API พยายามจัดรูปแบบวันที่/เวลาตามการแปลเป็นภาษาท้องถิ่นที่ระบุ รูปแบบวันที่และเวลาที่รองรับ ได้แก่

• องค์ประกอบเวลา — เวลาที่รวบรวมขึ้นจากองค์ประกอบ (กล่าวคือวันของสัปดาห์ เดือน ชั่วโมง เป็นต้น) เวลาที่ระบุจะเท่ากัน ไม่ว่าไคลเอ็นต์จะอยู่ในโซนเวลาใดก็ตาม
• เวลา Unix — เวลาที่จะแสดงขึ้นอยู่กับโซนเวลาที่ไคลเอ็นต์อยู่

DateTime

DateTimeComponent

ตัวอย่าง

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

ขั้นตอนถัดไป

เอกสารนี้ประกอบด้วยข้อมูลอ้างอิงเกี่ยวกับเทมเพลตข้อความ สำหรับคำแนะนำเกี่ยวกับวิธีสร้างและส่งเทมเพลตให้ดูที่การส่งเทมเพลตข้อความ และสำหรับพารามิเตอร์ทั้งหมดที่สามารถใช้ในเทมเพลตข้อความได้ ให้ดูที่ข้อความ, เทมเพลตข้อความ

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager