Gửi tin Zalo ZNS

• API này dùng để gửi tin nhắn Zalo ZNS.

• Chú ý:

  • Các hành động cài đặt gửi ZNS trên nhanh.vn sẽ do Nhanh.vn tự động gửi, bạn chỉ nên dùng API này cho các hành động phát sinh riêng từ hệ thống của bên bạn.

  • Khi cài hành động gửi tin theo các sự kiện trên Nhanh (Thêm hóa đơn bán lẻ, Thêm đơn hàng...) thì bạn mới cần dùng các từ khóa có sẵn của Nhanh.vn, còn nếu chỉ muốn gửi qua API, thì khi tạo mẫu tin, bạn có thể tạo từ khóa bất kì, đợi Zalo duyệt xong, thì bạn có thể lấy được znsTemplateId để gửi API.

  • Khi Zalo duyệt mẫu tin, các từ khóa thường có dạng <_TEN_KHACH_HANG_> nhưng gửi qua API cần bỏ qua 2 dấu < > chỉ gửi sang _TEN_KHACH_HANG_, Zalo sẽ tự xử lý nối thêm < >

Request

• Xem common request params.

• Xem Postman sample.

curl --location --globoff 'https://pos.open.nhanh.vn/v3.0/zalo/sendzns?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "zaloOaId": 365897,
    "znsTemplateId": 365,
    "mobile": "0966669999",
    "keywords": {
        "TU_KHOA_1": "Giá trị 1",
        "TU_KHOA_2": "Giá trị 2"
    }'

Data

Key	Type	Description
znsTemplateId	int $^{{\color{red}*}}$	Các mẫu tin đã được Zalo duyệt sẽ có ZNS template ID xem và tạo mới mẫu tin tại danh sách template
mobile	string $^{{\color{red}*}}$	Số điện thoại cần gửi
zaloOaId	int $^{{\color{red}*}}$	ID Zalo OA
keywords	string $^{{\color{red}*}}$	Mẩng Từ khóa, giá trị {"KEYWORD_1": "VALUE_1", "KEYWORD_2": "VALUE_2"}

Response

• Xem cấu trúc chung tại đây.

Failed response

• Xem các mã lỗi chung tại đây.

• Danh sách mã lỗi errorCode của riêng API này:

errorCode	Description
ERR_ZNS_OA_404	Doanh nghiệp chưa kết nối OA
ERR_ZNS_INVALID_OA	Zalo OA Id không hợp lệ
ERR_ZNS_EXCEEDED_LIMIT_IN_DAY	Vượt quá hạn mức gửi tin trong ngày
ERR_ZNS_OA_NOT_ENOUGH_BALANCE	Số dư tài khoản không đủ
ERR_ZNS_INVALID_PHONE_NUMBER	Số điện thoại gửi đi không hợp lệ
ERR_ZNS_ZALO_ACCOUNT_NOT_EXISTED	Số điện thoại không có tài khoản Zalo
ERR_ZNS_INVALID_TEMPLATE	ZNS template Id không hợp lệ
ERR_ZNS_PROHIBITED_TIMEFRAME	Tin nhắn chỉ được gửi trong khoảng thời gian từ 06-22h
ERR_ZNS_REQUIRED_KEYWORDS	Từ khóa và giá trị không đúng định dạng hoặc null
ERR_ZNS_KEYWORDS_NOT_MATCH	Từ khóa sai hoặc thừa với so từ khóa trong mẫu ví dụ: { "invalidKeyword": ["KEYWORD_1 is required", "KEYWORD_2 not existed in template"] }
ERR_ZNS_INVALID_KEYWORD_VALUES	Giá trị từ khóa không hợp lệ
ERR_ZNS_CODE_1121	Dữ liệu keyword vượt quá độ dài tối đa
ERR_ZNS_CODE_1123	Không thể tạo mã QR
ERR_ZNS_CODE_1124	Dữ liệu keyword có định dạng không hợp lệ

Successful response

{
    "code": 1,
    "data": {
        "oaBalance": "(int) Số dư sau khi gửi",
        "quota": {
          "remainingQuota": "(int) Số tin nhắn còn được gửi trong ngày",
          "dailyQuota": "(int) Hạn mức tin nhắn được gửi trong ngày"
        }
    }
}