Tin Zalo mỗi khách hàng một nội dung | eSMS for Developers

eSMS for Developers

HTTP request

POST

Content Type: application/json
Response Type: application/json

curl --location 'https://rest.esms.vn/MainService.svc/json/Send_zns_bulk_v4_post_json/' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "{{ApiKey}}",
    "SecretKey": "{{SecretKey}}",
    "campaignid": "Chiến dịch 1",
    "OAID": "4097311281936189049",
    "TempID": "267247",
    "Sandbox": "0",
    "CallbackUrl": "https://esms.vn/webhook/",
    "Data": [
        {
            "Phone": "0901888484",
            "RequestId": "96accf59-0c41-4bc7-a5c1",
            "Params": [ "Chị A", "Gội đầu", "KH001", "19/03/2025" ]
        },
        {
            "Phone": "0918238965",
            "RequestId": "96accf59-0c41-4bc7-a5c2",
            "Params": [ "Chị B", "Uốn", "KH002", "19/03/2025" ]
        },
        {
            "Phone": "0765418062",
            "RequestId": "96accf59-0c41-4bc7-a5c3",
            "Params": [ "Chị C", "Nhuộm", "KH003", "19/03/2025" ]
        }
    ]
}'

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

Response:


{
    "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ệ.

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

Sai thông tin ApiKey/SecretKey.

{
    "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ề.

Lưu ý: API này không cho gửi trừ ví zns free dù tk có bật hay không, tin zns free cuối tháng sẽ đối soát lại.