Tin Zalo mỗi khách hàng một nội dung

API eSMS gửi tin nhắn Zalo hàng loạt với nội dung tùy chỉnh cho từng khách hàng. Hỗ trợ mẫu tin, tham số động, hẹn giờ gửi và callback. Tích hợp dễ dàng qua HTTP POST JSON.

HTTP request

POST https://rest.esms.vn/MainService.svc/json/Send_zns_bulk_v4_post_json/

• Content Type: application/json

• Response Type: application/json

curl --location 'https://rest.esms.vn/MainService.svc/json/Send_zns_bulk_v4_post_json/' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "{{ApiKey}}",
    "SecretKey": "{{SecretKey}}",
    "campaignid": "{{campaignid}}",
    "OAID": "{{OAID}}",
    "TempID": "{{TempID}}",
    "Sandbox": "{{Sandbox}}",
    "SendDate": "{{SendDate}}",
    "CallbackUrl": "{{CallbackUrl}}",
    "Data": [
        {
            "Phone": "{{Phone}}",
            "RequestId": "{{RequestId}}",
            "Params": [ "{{value1}}", "{{value2}}", "{{value3}}" ]
        },
        {
            "Phone": "{{Phone}}",
            "RequestId": "{{RequestId}}",
            "Params": [ "{{value1}}", "{{value2}}", "{{value3}}" ]
        },
        {
            "Phone": "{{Phone}}",
            "RequestId": "{{RequestId}}",
            "Params": [ "{{value1}}", "{{value2}}", "{{value3}}" ]
        }
    ]
}'

• Cấu trúc body của request:

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
ApiKey	string		Chuỗi ký tự đại diện cho khóa API của tài khoản eSMS.
SecretKey	string		Chuỗi ký tự bí mật của tài khoản eSMS.
campaignid	string		Tên chiến dịch gửi tin, tối đa 254 ký tự. Đây là mã chiến dịch mà bạn sẽ phân biệt được các chiến dịch gửi tin.
OAID	string		ID của Zalo Official Account (OA) của doanh nghiệp. Doanh nghiệp cần đăng nhập vào trang quản trị của Zalo OA để lấy OAID này. Chú ý: sẽ phải đăng ký trước khi sử dụng.
TempID	string		ID của mẫu tin nhắn Zalo OA mà doanh nghiệp đã đăng ký với eSMS.
Sandbox	string		Chế độ Sandbox để kiểm tra API mà không gửi tin nhắn thực tế. Mặc định: Sandbox = 0
SendDate	string		Thời gian hẹn gửi tin nhắn. Nếu không truyền tham số này, tin nhắn sẽ được gửi ngay lập tức. Định dạng: yyyy-mm-dd hh:MM:ss
CallbackUrl	string		URL mà hệ thống sẽ gọi lại để trả kết quả gửi tin nhắn. Xem body mẫu ở đây. Xem chi tiết ở đây.
Data	Array		Mảng đối tượng chứa thông tin về từng tin nhắn bạn muốn gửi. Chú ý: Mảng có kích thước tối đa 500 phần tử.
Data: Phone	string		Số điện thoại người nhận.
Data: RequestId	string		ID Tin nhắn của đối tác, dùng để kiểm tra ID này đã được hệ thống esms tiếp nhận trước đó hay chưa. Ví dụ: RequestId=123456.
Date: Params	string		Danh sách các giá trị cần truyền cho các biến trong mẫu tin nhắn. *Lưu ý: Các tham số truyền vào phải đúng thứ tự như template bạn đăng ký. Nếu tham số trùng nhau chỉ cần truyền vào một tham số.

---

• Response:

100

{
    "CodeResult": "100",
    "Message": "Sucess",
    "TotalFail": 1,
    "TotalSuccess": 2,
    "detail": [
        {
            "CodeResult": "100",
            "Phone": "{Phone}",
            "SMSID": "a037b928-cb7e-4bfc-bdf9-0286318163aa264"
        },
        {
            "CodeResult": "100",
            "Phone": "{Phone}",
            "SMSID": "b83ff06e-8989-4b0d-818e-795b96699e86261"
        },
        {
            "CodeResult": "108",
            "Phone": "{Phone}",
            "ErrorMessage": "The phone number 097469188 is not valid."
        }
    ]
}

Request hợp lệ.

101

{
    "CodeResult": "101",
    "CountRegenerate": 0,
    "ErrorMessage": "Authorize Failed"
}

Sai thông tin ApiKey/SecretKey.

789

{
    "CodeResult": "789",
    "CountRegenerate": 0,
    "ErrorMessage": "TemplateId is not config"
}

Template chưa được cấu hình cho OA ID bạn đang sử dụng.

• Cấu trúc body của response:

Thuốc tính	Kiểu dữ liệu	Mô tả
CodeResult	string	Mã trả về.
Message	string	Mô tả chi tiết về phản hồi.
TotalFail	string	Tổng số điện thoại request gửi tin thất bại.
TotalSuccess	string	Tổng số điện thoại request gửi tin thành công.
detail : CodeResult	string	Mã trả về.
detail : Phone	string	Số điện thoại tương ứng với ID tin nhắn do esms trả về.
detail : SMSID	string	ID tin nhắn do esms trả về.

• Thông tin chi tiết mã lỗi xem ở bảng: Mã lỗi .

• Lấy code mẫu các ngôn ngữ trên Postman: Link code mẫu.