Send Zalo Trading message

HTTP request

POST https://rest.esms.vn/mainservice.svc/json/SendZaloFollowerMessage_V5_post_json/

• Content Type: text/plain

• Response Type: application/json

curl --location 'https://rest.esms.vn/mainservice.svc/json/SendZaloFollowerMessage_V5_post_json/' \
--header 'Content-Type: text/plain' \
--data '{
    "ApiKey": "{{ApiKey}}",
    "SecretKey": "{{SecretKey}}",
    "OAID": "{{OAID}}",
    "RequestId": "96accf59-0c41-4bc7-a5c4-4a466c2e41c2", 
    "Payload": {
        "recipient": {
            "user_id": "{{user_id}}"
        },
        "message": {
            "attachment": {
                "type": "template",
                "payload": {
                    "template_type": "transaction_order",
                    "language": "VI",
                    "elements": [
                        {
                            "image_url": "https://minio.esms.vn/blogimg/agent-1/BlogImg/full_cccc34d4-3a46-4644-8613-1b226203c5d5.png",
                            "type": "banner"
                        },
                        {
                            "type": "header",
                            "content": "Trạng thái đơn hàng",
                            "align": "left"
                        },
                        {
                            "type": "text",
                            "align": "left",
                            "content": "• Cảm ơn bạn đã mua hàng tại cửa hàng.<br>• Thông tin đơn hàng của bạn như sau:"
                        },
                        {
                            "type": "table",
                            "content": [
                                {
                                    "value": "eSMS-001",
                                    "key": "Mã khách hàng"
                                },
                                {
                                    "style": "yellow",
                                    "value": "Đang giao",
                                    "key": "Trạng thái"
                                },
                                {
                                    "value": "250,000đ",
                                    "key": "Giá tiền"
                                }
                            ]
                        },
                        {
                            "type": "text",
                            "align": "center",
                            "content": "📲 Lưu ý điện thoại. Xin cảm ơn!"
                        }
                    ],
                    "buttons": [
                        {
                            "title": "Kiểm tra lộ trình",
                            "image_icon": "https://img.icons8.com/?size=100&id=kJlyCVWJrclv&format=png&color=000000",
                            "type": "oa.open.url",
                            "payload": {
                                "url": "https://esms.vn/huong-dan/huong-dan-tich-hop/huong-dan-tich-hop-api-cua-esms-vao-website"
                            }
                        },
                        {
                            "title": "Xem lại giỏ hàng",
                            "image_icon": "https://img.icons8.com/?size=100&id=S2Z1vzGMFT1v&format=png&color=000000",
                            "type": "oa.open.url",
                            "payload": {
                                "url": "https://esms.vn/huong-dan/huong-dan-su-dung"
                            }
                        },
                        {
                            "title": "Liên hệ tổng đài",
                            "image_icon": "https://img.icons8.com/?size=100&id=KKBDB20a4V6t&format=png&color=000000",
                            "type": "oa.open.phone",
                            "payload": {
                                "phone_code": "0901888484"
                            }
                        }
                    ]
                }
            }
        }
    }
}'

• Body request

Parameters	Type	Required	Description
ApiKey	string		Your API Key.
SecretKey	string		Your Secret Key
OAID	string		Zalo OA Id is the Zalo Official Account Id of the organization. It can be obtained by accessing to the Zalo administrator page. Note: Pre-registration is required.
user_id	string		The identification value of user at Zalo.
CallbackUrl	string		The webhook URL that will receive the status of message after it processed to the operator. It is used for determine whether the SMS is succcessfully delivered to the receiver or failed. See the sample request at here. More details at here.
RequestId	string		Partner ID passed to block duplicates and check if needed. Maximum length 50 characters. Each RequestId passed is valid for blocking for 24 hours.
template_type	string		Type of template: - transaction_billing - transaction_order - transaction_reward - transaction_contract - transaction_booking - transaction_membership - transaction_event - transaction_transaction - transaction_account - transaction_internal - transaction_partnership - transaction_education - transaction_rating
language	string		Message languague values. Giá trị nhận vào: language = VI or language = EN The default content of template will be transfered corresponding to the selected languague.
image_url	string		The image URL.
align	string		Align the content: left (or blank): Align to left. center: Align to center. right: Align to right.
table	string		The structure of an element in table { "key": "key" // maxlength = 25 "value": "the value of key" // maxlength = 100 } It is mandantory to have one of the two element below: VI: { "key": "Mã..." // Start with "Mã", use for identify. "value": "The value of key" } EN: { "key": "...Code..." // It is mandantory to have the string "Code" inside. "value": "The value of key" } Or: VI: { "key": "Tên khách hàng" //It is fixed with the value "Tên khách hàng", "value": "The vlaue of key" } EN: { "key": "Customer Name" // It is fixed with value "Customer Name" , "value": "The value of key" } Key “Trạng thái” / “Status” is the only one key that can use the "Style" paramter: VN: { "key": "Trạng thái" //it is fixed with value "Trạng thái" "value": "the value of key" "style": "yellow" // Accepted values: green, blue, yellow, red, grey } EN: { "key": "Status" // It is fixed with value "Status" "value": "the value of key" "style": "yellow" // Accepted values: green, blue, yellow, red, grey } ****Note: Maximun 5 elements can be declared.
button	string		Maximun 4 buttons can be added.
Sandbox	string		Sandbox option value (default is 0): 1: For testing purpose to verify the validation of the request. Message is not charged and sent to the receiver. 0: Message will be processed to the receiver properly.

---

• Response

100

{
    "CodeResult": "100",
    "CountRegenerate": 0,
    "SMSID": "d8e0f1f0702544b2acb456ca9ccfd111250"
}

Valid request.

101

• Response body

Parameter	Type	Description
CodeResult	string	Response code.
SMSID	string	The message id of eSMS system.
ErrorMessage	string	The error message if the request is invalid.

• The detail of error code can refer at Table of error codes .

• Get the sample of code for programing languagues to use in Postman refer at Link of code samples.