การส่งเทมเพลตข้อความ

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

โปรดเรียนรู้เพิ่มเติมเกี่ยวกับเทมเพลตข้อความที่ข้อความ, ข้อความที่เริ่มโดยธุรกิจ

ก่อนเริ่มต้น

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

ขั้นตอนที่ 1: สร้างเทมเพลตโดยใช้ตัวจัดการ WhatsApp

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

เมื่อสร้างเทมเพลตข้อความ คุณจะต้องมีสิ่งต่อไปนี้

1. ชื่อเทมเพลตข้อความ - มีได้เฉพาะอักขระที่มีทั้งตัวอักษรพิมพ์เล็กและตัวเลขและขีดล่าง ( _ ) เท่านั้น ไม่อนุญาตให้ใช้อักขระอื่นๆ หรือเว้นวรรค
2. ส่วนประกอบของเทมเพลตข้อความ — เติมเทมเพลตด้วยส่วนประกอบข้อความและ/หรือสื่อ ซึ่งรวมถึงตัวยึดพารามิเตอร์ตามต้องการ ตรวจสอบให้แน่ใจว่าไม่มีการขึ้นบรรทัดใหม่ แท็บ หรือช่องว่างติดต่อกันเกิน 4 ช่อง และมีความยาวไม่เกินที่กำหนดไว้ในตัวจัดการธุรกิจหรือ API การจัดการ WhatsApp Business
3. การแปลอื่นๆ ทั้งหมดที่ธุรกิจของคุณต้องการ

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

ดูขั้นตอนการสร้างเทมเพลตข้อความที่ละเอียดขึ้นในหัวข้อสร้างเทมเพลตข้อความสำหรับบัญชี WhatsApp Business API

ตัวอย่าง

การสร้างข้อความต้อนรับที่มีเทมเพลตข้อความชื่อ welcome และมีข้อความว่า

  "Welcome {{1}}. We look forward to serving you on WhatsApp." 

การสร้างข้อความยืนยันคำสั่งซื้อที่มีเทมเพลตข้อความชื่อ order_confirmation และมีข้อความว่า

  "Your order {{1}} for a total of {{2}} is confirmed. The expected delivery is {{3}}." 

การแปล

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

• การแปล
• ภาษาที่รองรับ

ขั้นตอนที่ 2: ส่งคำขอ POST ไปยัง /messages

เมื่อคุณมีเทมเพลตแล้ว คุณจะสามารถส่งเทมเพลตนั้นให้ลูกค้าของคุณผ่านอ็อบเจ็กต์ template ได้ดังนี้

POST /v1/messages
{
  "to": "recipient_wa_id",
  "type": "template",
  "template": {
        "namespace": "your-namespace",
        "name": "your-template-name",
        "language": {
            "code": "your-language-and-locale-code",
            "policy": "deterministic"
        },
        "components": [{
            "type": "body",
            "parameters": [
                {
                    "type": "text",
                    "text": "your-text-string"
                },
                {
                    "type": "currency",
                    "currency": {
                        "fallback_value": "$100.99",
                        "code": "USD",
                        "amount_1000": 100990
                    }
                },
                {
                    "type": "date_time",
                    "date_time" : {
                        "fallback_value": "February 25, 1977",
                        "day_of_week": 5,
                        "day_of_month": 25,
                        "year": 1977,
                        "month": 2,
                        "hour": 15,
                        "minute": 33
                    }
                },
                {
                "type": "date_time",
                    "date_time" : {
                    "fallback_value": "February 25, 1977",
                    "timestamp": 1485470276
                    }
                }
            ]
        }]
    }
}

พารามิเตอร์

• พารามิเตอร์ที่พบบ่อยสำหรับคำขอส่งข้อความทั้งหมด
• พารามิเตอร์สำหรับเทมเพลตข้อความ: อ็อบเจ็กต์ template, อ็อบเจ็กต์ components, อ็อบเจ็กต์ parameters และอ็อบเจ็กต์ language
• ภาษา: ตัวเลือกของนโยบายภาษา, อ็อบเจ็กต์ language และพารามิเตอร์ที่แปลได้

ขั้นตอนที่ 3: ตรวจสอบการตอบกลับ API ของคุณ

การตอบกลับที่สำเร็จจะมีอ็อบเจ็กต์ messages ที่มี id

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

การตอบกลับที่ไม่สำเร็จจะมีอ็อบเจ็กต์ข้อผิดพลาดพร้อมสตริงข้อผิดพลาด รหัสข้อผิดพลาด และข้อมูลอื่นๆ โปรดดูข้อมูลเพิ่มเติมที่รหัสข้อผิดพลาดและรหัสสถานะ

ขีดจำกัดของข้อความเทมเพลตการตลาดต่อผู้ใช้

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

ขีดจำกัดนี้จะมีผลบังคับใช้กับข้อความเทมเพลตการตลาดซึ่งตามปกติแล้วจะเปิดการสนทนาทางการตลาดใหม่ขึ้นมา หากการสนทนาทางการตลาดเปิดอยู่แล้วระหว่างคุณกับผู้ใช้ WhatsApp ข้อความเทมเพลตการตลาดที่ส่งให้กับผู้ใช้ก็จะไม่ได้รับผลกระทบแต่อย่างใด

หากระบบไม่ได้ส่งข้อความเทมเพลตการตลาดให้กับผู้ใช้ที่กำหนดเนื่องจากข้อจำกัดดังกล่าว On-Premises API จะส่งคืนรหัสข้อผิดพลาด 1026 แต่โปรดทราบว่า รหัสข้อผิดพลาดนี้ครอบคลุมปัญหาต่างๆ มากมายที่อาจส่งผลให้ส่งข้อความไม่ถึงผู้รับ และเนื่องด้วยเหตุผลด้านความเป็นส่วนตัว เราจะไม่เปิดเผยว่าจริงๆ แล้วข้อความดังกล่าวไปไม่ถึงผู้รับเนื่องจากข้อจำกัดดังกล่าวหรือไม่ โปรดดูข้อมูลเพิ่มเติมที่ "เหตุใดอัตราการส่งจึงไม่เป็น 100%" ในคำถามที่พบบ่อย

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

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