Gửi tin với hệ mã hóa RSA

Trong mọi trường hợp GobyZNS đảm bảo không lưu lại dữ liệu cá nhân của khách hàng của bạn. Chúng tôi chỉ lưu trữ lại MessageID để đảm bảo việc tracking tình trạng gửi tin với Zalo.

Nếu dữ liệu của bạn ở mức bảo mật rất cao như thông tin tài khoản ngân hàng, thông tin giao dịch thanh toán, chúng tôi khuyến khích bạn nên mã hóa nội dung tin nhắn trên hệ thống của bạn trước khi gửi sang GobyZNS. Tin nhắn này sẽ được Zalo giải mã trước khi gửi tới Zalo của khách hàng cuối. Kể cả GobyZNS cũng không thể giải mã tin nhắn này.

Tổng quan luồng mã hóa nội dung

Zalo sử dụng hệ mã hóa RSA với 1 cặp key gồm public key và private key, trong đó Zalo sẽ giữ private key để giải mã nội dung nhận được từ phía đối tác trước khi gửi đến người dùng.

Sau khi thực hiện việc Xác thực và ủy quyền OA, bạn có thể lấy public key trên giao diện portal của GobyZNS.

Cách mã hóa nội dung với public key

Liên hệ với hỗ trợ kỹ thuật của GobyZNS để được hướng dẫn cụ thể hơn tùy thuộc vào ngôn ngữ lập trình bạn đang sử dụng.

Gửi tin nhắn đã mã hóa RSA

HTTP request

URL: https://zns.api.gobysend.com/api/message/rsa Method: POST Content Type: application/json Response Type: text/json

Example Request

curl
-X POST
-H "Content-Type: application/json" -d '{
    "encrypted_message": "Nội dung tin nhắn được mã hóa RSA",
    "has_fallback_sms": true,
    "fallback_sms": {
        "brandname": "Freetalk",
        "content": "Nội dung tin nhắn SMS thay thế, không được mã hóa RSA",
        "delay_seconds": 60
    }
}'
-d "https://zns.api.gobysend.com/api/message/rsa"

Tham số header

Tên Header	Kiểu dữ liệu	Mô tả
access_token	string	Là một đoạn mã cần truyền vào để xác minh quyền sử dụng API. Xem thêm tài liệu tham khảo

Request body

Tên tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
encrypted_message	string	yes	Nội dung tin nhắn cần gửi bao gồm cả thông tin người nhận, templateid, template_data, đã được mã hóa RSA
has_fallback_sms	boolean	no	Thông số cho biết tin nhắn này có được gửi fallback sang SMS hay không
fallback_sms	string	no	Nội dung tin nhắn muốn gửi thay thế khi người nhận không nhận được tin ZNS. Lưu ý: Trong trường hợp này nội dung tin nhắn thay thế không được mã hóa đầu cuối bằng RSA. Thận trọng khi sử dụng.

Cấu trúc fallback_sms

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
brandname	string	yes	Tên SMS brandname sử dụng để gửi tin
content	string	yes	Nội dung tin nhắn SMS muốn gửi thay thế.
delay_seconds	integer	yes	Thời gian chờ tin ZNS gửi trước khi kiểm tra trạng thái và gửi tin SMS thay thế. Sau thời gian chờ này, hệ thống sẽ kiểm tra tình trạng gửi của tin ZNS, nếu không thành công thì tin SMS sẽ được gửi thay thế.

Example response

{
  "data": {
    "msg_id": "b15f0398cb7a1e264769"
  },
  "error": 0,
  "message": "Success"
}

Thuộc tính	Kiểu dữ liệu	Mô tả
msg_id	string	ID của thông báo ZNS được sinh ra bởi hệ thống GobyZNS.