การส่งเทมเพลตข้อความแบบอินเทอร์แอคทีฟ

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

ปุ่มที่กำหนดไว้ล่วงหน้ามี 2 ประเภทดังนี้

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

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

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

คุณต้องดำเนินการต่อไปนี้

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

เมื่อเทมเพลตข้อความได้รับอนุมัติแล้ว คุณสามารถใช้ API เพื่อส่งข้อความได้

ข้อจำกัด

• สำหรับเทมเพลตการกระตุ้นให้ดำเนินการ คุณสามารถเพิ่มปุ่มได้ 2 ปุ่ม โดยจะเพิ่มปุ่มแต่ละประเภทได้ไม่เกิน 1 ปุ่ม (โทรไปยังหมายเลขโทรศัพท์และเข้าชมเว็บไซต์)
• สำหรับเทมเพลตการตอบกลับด่วน คุณสามารถเพิ่มได้สูงสุด 3 ปุ่ม

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

POST /v1/messages
{
    "to": "recipient_wa_id",
    "type": "template",
    "template": {
        "namespace": "your-namespace",
        "language": {
            "policy": "deterministic",
            "code": "your-language-and-locale-code"
        },
        "name": "your-template-name",
        "components": [
            {
                "type" : "header",
                "parameters": [
                    {
                        "type": "text",
                        "text": "replacement_text"
                    }
                ]
            # end header
            },
            {
                "type" : "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "replacement_text"
                    },
                    {
                        "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, #OR
                            "timestamp": 1485470276
                        }
                    },
                    {
                        ...
                        # Any additional template parameters
                    }
                ] 
            # end body
            },

            # The following part of this code example includes several possible button types, 
            # not all are required for an interactive message template API call.
            {
                "type": "button",
                "sub_type" : "quick_reply",
                "index": "0", 
                "parameters": [
                    {
                        "type": "payload",
                        # Business Developer-defined payload
                        "payload":"aGlzIHRoaXMgaXMgY29vZHNhc2phZHdpcXdlMGZoIGFTIEZISUQgV1FEV0RT"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type" : "url",
                "index": "1", 
                "parameters": [
                    {
                        "type": "text",
                        # Business Developer-defined dynamic URL suffix
                        "text": "9rwnB8RbYmPF5t2Mn09x4h"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type" : "url",
                "index": "2",
                "parameters": [
                    {                    
                        "type": "text",
                        # Business Developer-defined dynamic URL suffix
                        "text": "ticket.pdf"
                    }
                ]
            }
        ]
    }
}

พารามิเตอร์

• พารามิเตอร์ที่พบบ่อยสำหรับคำขอส่งข้อความทั้งหมด
• พารามิเตอร์สำหรับเทมเพลตข้อความ:

  • อ็อบเจ็กต์ template
  • อ็อบเจ็กต์ components: สำหรับเทมเพลตข้อความแบบอินเทอร์แอคทีฟ ให้ใส่ประเภท button และช่อง sub_type
  • อ็อบเจ็กต์ parameters

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาดที่รหัสข้อผิดพลาดและรหัสสถานะ

ขั้นตอนที่ 3 (ดำเนินการหรือไม่ก็ได้): จัดการกับการดำเนินการของผู้ใช้

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

การเรียกกลับจากการคลิกปุ่มตอบกลับด่วน

{
    "contacts": [
        {
            "profile": {
                "name": "Kerry Fisher"
            },
            "wa_id": "16505551234"
        }
    ],
    "messages": [
        {
            "button": {
                "payload": "No-Button-Payload",
                "text": "No"
            },
            "context": {
                "from": "16315558007",
                "id": "gBGGFmkiWVVPAgkgQkwi7IORac0"
            },
            "from": "16505551234",
            "id": "ABGGFmkiWVVPAgo-sKD87hgxPHdF",
            "timestamp": "1591210827",
            "type": "button"
        }
    ]
    # If there are any errors, an errors field (array) will be present        
    "errors": [ { ... } ]
}

ตัวอย่าง

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

การเตือนความจำเกี่ยวกับการเดินทาง

ตัวอย่างนี้แสดงการสร้างเทมเพลตข้อความสื่อแบบอินเทอร์แอคทีฟพร้อมปุ่มตอบกลับด่วน

1. สร้างเทมเพลตข้อความสื่อแบบอินเทอร์แอคทีฟในตัวจัดการธุรกิจของคุณ

2. การเรียกใช้ API messages จะเพิ่มลงในข้อมูลพารามิเตอร์

POST /v1/messages
{
    "to": "your-test-recipient-wa-id",
    "recipient_type": "individual",
    "type": "template",
    "template": {
        "namespace": "88b39973_f0d5_54e1_29cf_e80f1e3da4f2",
        "name": "upcoming_trip_reminder",
        "language": {
            "code": "en",
            "policy": "deterministic"
        },
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "text",
                        "text": "12/26"
                    }
                ]
            },
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "*Ski Trip*"
                    },
                    {
                        "type": "date_time",
                        "date_time" : {
                            "fallback_value": "29th July 2019, 8:00am",
                            "day_of_month": "29",
                            "year": "2019",
                            "month": "7",
                            "hour": "8",
                            "minute": "00"
                        }
                    },
                    {
                            "type": "text",
                            "text": "*Squaw Valley Ski Resort, Tahoe*"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "quick_reply",
                "index": 0,
                "parameters": [
                    {
                        "type": "payload",
                        "payload": "Yes-Button-Payload"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "quick_reply",
                "index": 1,
                "parameters": [
                    {
                        "type": "payload",
                        "payload": "No-Button-Payload"
                    }
                ]
            }
        ]
    }
}

3. ลูกค้าของคุณจะได้รับข้อความเตือนความจำเกี่ยวกับการเดินทางพร้อมปุ่มตอบกลับด่วน

การจัดส่งสินค้า

ตัวอย่างนี้แสดงการสร้างเทมเพลตข้อความสื่อแบบอินเทอร์แอคทีฟพร้อมปุ่ม URL และปุ่มหมายเลขโทรศัพท์

1. สร้างเทมเพลตข้อความสื่อแบบอินเทอร์แอคทีฟในตัวจัดการธุรกิจของคุณ

2. การเรียกใช้ API messages จะเพิ่มลงในข้อมูลพารามิเตอร์

POST /v1/messages
{
    "to": "your-test-recipient-wa-id",
    "recipient_type": "individual",
    "type": "template",
    "template": {
        "namespace": "88b39973_f0d5_54e1_29cf_e80f1e3da4f2",
        "name": "oculus_shipment_update",
        "language": {
            "code": "en",
            "policy": "deterministic"
        },
        "components": [
            {
                "type": "header",
                "parameters": [{
                    "type": "image",
                    "image": {
                        "link": "link-to-your-image"
                    }
                }]
            },
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Anand"
                    },
                    {
                        "type": "text",
                        "text": "Quest"
                    },
                    {
                        "type": "text",
                        "text": "113-0921387"
                    },
                    {
                        "type": "date_time",
                        "date_time" : {
                            "fallback_value": "23rd Nov 2019",
                            "day_of_month": "20",
                            "year": "2019",
                            "month": "9"
                        }
                    }
                ] 
            },
            {
                "type": "button",
                "index": "0",
                "sub_type": "url",
                "parameters": [
                    {
                        "type": "text",
                        "text": "1Z999AA10123456784"
                    }
                ]
            }
        ]
    }
}

3. ลูกค้าของคุณจะได้รับข้อความการจัดส่งสินค้าพร้อมปุ่ม URL และปุ่มโทรศัพท์ดังนี้