API การจัดการเทมเพลต

              
              Authorization: Basic ${base64_auth_string}

            

              
              GET https://wa.api.engagelab.cc/v1/templates?tag_id=101

            

              
              GET https://wa.api.engagelab.cc/v1/templates?tag_id=ungrouped

            

              
              // อาร์เรย์ JSON ที่แต่ละออบเจ็กต์คือข้อมูลของเทมเพลตหนึ่งรายการ
[
    {
        "id": "406979728071589", // รหัสเทมเพลต
        "name": "code", // ชื่อเทมเพลต
        "language": "zh_CN", // ภาษาของเทมเพลต
        "status": "APPROVED", // สถานะ; APPROVED หมายถึงอนุมัติแล้วและใช้งานได้
        "category": "OTP", // หมวดหมู่; ปัจจุบันรองรับ OTP/TRANSACTIONAL/MARKETING
        "components": [ // เนื้อหาเทมเพลต; อาจมี HEADER/BODY/FOOTER/BUTTON
            {
                "type": "HEADER",
                "format": "text", // รูปแบบ; รองรับ text/image/location/video/document ค่าเริ่มต้นคือ TEXT
                "text": "รหัสยืนยันการลงทะเบียน" // เนื้อหาข้อความ; จำเป็นเมื่อ format เป็น text
            },
            {
                "type": "BODY",
                "text": "รหัสยืนยันของคุณคือ {{1}} กรุณากรอกภายใน 5 นาที" // ข้อความที่อยู่ในวงเล็บปีกกาคู่ {{}} คือตัวแปรของเทมเพลต
            }
        ],
        "tags": [ // แท็กที่กำหนดให้เทมเพลตนี้; อาร์เรย์ว่างหากยังไม่ได้กำหนดแท็ก
            {
                "id": "101",
                "name": "แจ้งเตือนการจัดส่ง"
            }
        ]
    },
    ......
]

            

              
              GET https://wa.api.engagelab.cc/v1/templates/406979728071589

            

              
              {
    "id": "406979728071589", // รหัสเทมเพลต
    "name": "code", // ชื่อเทมเพลต
    "language": "zh_CN", // ภาษาของเทมเพลต
    "status": "APPROVED", // สถานะ; APPROVED หมายถึงอนุมัติแล้วและใช้งานได้
    "category": "OTP", // หมวดหมู่; ปัจจุบันรองรับ OTP/TRANSACTIONAL/MARKETING
    "components": [ // เนื้อหาเทมเพลต; อาจมี HEADER/BODY/FOOTER/BUTTON
        {
            "type": "HEADER",
            "format": "text", // รูปแบบ; รองรับ text/image/location/video/document ค่าเริ่มต้นคือ TEXT
            "text": "รหัสยืนยันการลงทะเบียน" // เนื้อหาข้อความ; จำเป็นเมื่อ format เป็น text
        },
        {
            "type": "BODY",
            "text": "รหัสยืนยันของคุณคือ {{1}} กรุณากรอกภายใน 5 นาที" // ข้อความที่อยู่ในวงเล็บปีกกาคู่ {{}} คือตัวแปรของเทมเพลต
        }
    ],
    "tags": [ // แท็กที่กำหนดให้เทมเพลตนี้; อาร์เรย์ว่างหากยังไม่ได้กำหนดแท็ก
        {
            "id": "101",
            "name": "แจ้งเตือนการจัดส่ง"
        }
    ]
}

            

              
              POST '/v1/media/handles' 
--header 'Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0' 
--form 'file=@"/Users/demo/files/demopic.jpeg"'

            

              
              {
    "handle_id": "4::aW1hZ2UvanBlZw==:ARb2JGd8LbvJbfmpMASFAlczcn4hxLC6tkwjasjD4WL6_i34tIisq0IdWNFFFj1KwJMRXPU4xwygHSJd4DHu1f19LcBBl2qeb8EuEcgnIUPYIQ:e:1682169041:4985146461608173:100084026087657:ARazr9kxfzKshJE4WpY"
}

            

              
              {
    "code": 3002,
    "message": "whatsapp.template field must be set correctly when type is template"
}

            

              
              {
    "name": "template_name", // ชื่อเทมเพลต; อนุญาตให้ใช้ชื่อซ้ำได้; รองรับเฉพาะตัวพิมพ์เล็ก ตัวเลข และขีดล่าง
    "language": "zh_CN", // ภาษาของเทมเพลต; เทมเพลตชื่อเดียวกันห้ามใช้ภาษาซ้ำกัน
    "category": "OTP", // หมวดหมู่; ปัจจุบันรองรับ OTP/TRANSACTIONAL/MARKETING
    "components": [
        { // เนื้อหาเทมเพลต
            "type": "BODY", // บล็อกเนื้อหา; ปัจจุบันรองรับ HEADER/BODY/FOOTER/BUTTONS
            "text": "define var as {{1}}" // ตัวข้อความ; ไม่ต้องส่งฟิลด์ format เมื่อ body เป็นข้อความ
          "example": {
                "body_text": [
                    [
                        "var1"
                    ]
                ]
            }
        },
        {
            "type": "HEADER",
            "format": "image", // ประเภทเนื้อหา; รองรับ text/image/video/document/location
            "example": {
                "header_handle": [
                    "https://jiguang.cn/demopic.jpg"
                ]
            }
        },
        {
            "type": "FOOTER",
            "text": "footer only support text without variable"
        },
        {
            "type": "BUTTONS",
            "buttons": [
                {
                    "type": "PHONE_NUMBER", // ประเภทปุ่ม; รองรับ PHONE_NUMBER/URL/QUICK_REPLY              
                    "text": "this is a phone number",
                    "phone_number": "8613800138000"
                }
            ]
        }
    ]
}

            

              
              {
    "name": "copycodetmpl",
    "language": "zh_CN",
    "category": "AUTHENTICATION",
    "components": [
        {
            // body เป็นสิ่งจำเป็น
            "type": "BODY",
            "add_security_recommendation": true  // จะเพิ่มข้อความแนะนำด้านความปลอดภัยหรือไม่
            
        },
        {
            // footer เป็นตัวเลือก
            "type": "FOOTER",		
            "code_expiration_minutes": 2    // เพิ่มการแสดงเวลาหมดอายุ ช่วง [1,90]; หากไม่ต้องการก็ไม่ต้องส่งฟิลด์นี้
        },
        {
            "type": "BUTTONS",          
            "buttons": [
                {
                    "type": "OTP",
                    "otp_type": "copy_code",
                    "text": "copy it"      // จำกัดความยาว 25 อักขระ
                }
            ]
        }
    ]
}

            

              
              {
    "name": "copycodetmpl",
    "language": "zh_CN",
    "category": "AUTHENTICATION",
    "components": [
        {
            "type": "BODY",
            "text": "*{{1}}* คือรหัสยืนยันของคุณ เพื่อความปลอดภัย กรุณาอย่าแชร์รหัสนี้",
            "example": {
                "body_text": [
                    ["123456"]
                ]
            }
        },
        {
            "type": "FOOTER",
            "text": "รหัสนี้จะหมดอายุใน 2 นาที"
        },
        {
            "type": "BUTTONS",
            "buttons": [{
              "type": "URL",
              "text": "Copy code",
              "url": "https://www.whatsapp.com/otp/code/?otp_type=COPY_CODE&code=otp{{1}}",
              "example": [
                  "https://www.whatsapp.com/otp/code/?otp_type=COPY_CODE&code=otp123456"
              ]
          }]
        }
    ]
}

            

              
              {
    "name": "copycodetmpl",
    "language": "zh_CN",
    "category": "AUTHENTICATION",
    "components": [
        {
            // body เป็นสิ่งจำเป็น
            "type": "BODY",
            "add_security_recommendation": true  // จะเพิ่มข้อความแนะนำด้านความปลอดภัยหรือไม่
            
        },
        {
            // footer เป็นตัวเลือก
            "type": "FOOTER",		
            "code_expiration_minutes": 2    // เพิ่มการแสดงเวลาหมดอายุ ช่วง [1,90]; หากไม่ต้องการก็ไม่ต้องส่งฟิลด์นี้
        },
        {
            "type": "BUTTONS",          
            "buttons": [
                {
                    "type": "OTP",
                    "otp_type": "one_tap",
                    "text": "auto1",      // จำกัดความยาว 25 อักขระ
                    "autofill_text": "auto1",      // จำกัดความยาว 25 อักขระ
                    "package_name": "ppssd",    
                    "signature_hash": "asds"  
                }
            ]
        }
    ]
}

            

              
              {
    "name": "copycodetmpl",
    "language": "zh_CN",
    "category": "AUTHENTICATION",
    "components": [
        {
            "type": "BODY",
            "text": "*{{1}}* คือรหัสยืนยันของคุณ เพื่อความปลอดภัย กรุณาอย่าแชร์รหัสนี้",
            "example": {
                "body_text": [
                    ["123456"]
                ]
            }
        },
        {
            "type": "FOOTER",
            "text": "รหัสนี้จะหมดอายุใน 2 นาที"
        },
        {
            "type": "BUTTONS",
            "buttons": [{
                "type": "URL",
                "text": "copy1",
                "url": "https://www.whatsapp.com/otp/code/?otp_type=ONE_TAP&cta_display_name=auto1&package_name=ppssd&signature_hash=asds&code=otp{{1}}",
                "example": ["https://www.whatsapp.com/otp/code/?otp_type=ONE_TAP&cta_display_name=auto1&package_name=ppssd&signature_hash=asds&code=otp123456"]
            }]
        }
    ]
}

            

              
              {
    "template_id": "1275172986566180"		// รหัสเทมเพลต
}

            

              
              {
    "code": 5002,
    "message": "Invalid parameter. code:100:2388042"
}

            

              
              {
    "components": [{                        // เนื้อหาเทมเพลต
        "type": "BODY",                     // บล็อกเนื้อหา
        "text": "define var as {{1}}", 
        "example": {
            "body_text": [["var1"]]
        }
    },{
        "type": "HEADER",
        "format": "image",                  // ประเภทเนื้อหา: image/video/document
        "example": {
            // หมายเหตุ: ตรงนี้ต้องกรอก handle_id ที่ได้จาก endpoint อัปโหลด ไม่รองรับการกรอก URL รูปภาพโดยตรงอีกต่อไป
            "header_handle": ["4::aW1hZ2UvanBlZw==:ARb2JGd8LbvJbfmpMASFAlcz..."]
        }
    },{
        "type": "FOOTER",
        "text": "footer only support text without variable"
    },{
        "type": "BUTTONS",
        "buttons": [{                                     
            "type": "PHONE_NUMBER",              
            "text": "this is a phone number",              
            "phone_number": "8613800138000"
        }]
    }]
}

            

              
              {
    "code": 0,
    "message": "success"
}

            

              
              {
    "code": 5002,
    "message": "Invalid parameter. code:100:2593002"
}

            

              
              {
    "code": 0,
    "message": "success"
}


            

              
              {
    "code": 2004,
    "message": "something error"
}

            

              
              GET https://wa.api.engagelab.cc/v1/template-tags

            

              
              [
    {
        "id": "101",
        "name": "แจ้งเตือนการจัดส่ง",
        "template_count": 3
    },
    {
        "id": "102",
        "name": "บริการหลังการขาย",
        "template_count": 0
    }
]

            

              
              {
    "name": "แจ้งเตือนการจัดส่ง"
}

            

              
              {
    "id": "101",
    "name": "แจ้งเตือนการจัดส่ง"
}

            

              
              {
    "code": 3003,
    "message": "template tag name already exists"
}

            

              
              {
    "name": "บริการหลังการขาย"
}

            

              
              {
    "id": "101",
    "name": "บริการหลังการขาย"
}

            

              
              {
    "code": 4001,
    "message": "template tag not found"
}

            

              
              DELETE https://wa.api.engagelab.cc/v1/template-tags/101

            

              
              {
    "affected_template_count": 3
}

            

              
              {
    "code": 4001,
    "message": "template tag not found"
}

            

              
              {
    "tag_ids": ["101", "102"]
}

            

              
              {
    "code": 0,
    "message": "success"
}

            

              
              {
    "code": 4001,
    "message": "template not found"
}

            

              
              {
    "code": 4001,
    "message": "template tag not found"
}

            

              
              {
    "code": 3002,
    "message": "template tag IDs must be provided as an array"
}