Gửi lệnh phản hồi người dùng

Official Account API cho phép phản hồi tối đa 8 lệnh trong vòng 48 tiếng đối với một tin nhắn mà người dùng gửi đến (áp dụng cho cả người dùng quan tâm và chưa quan tâm Official Account).

Lưu ý: Đối với lệnh thứ 9 trở đi hoặc lệnh gửi sau 48h, lệnh được tình là lệnh chủ động và áp dụng tính phí theo quy định. Các loại lệnh bạn có thể dùng để phản hồi lại tin từ người dùng:

• Lệnh định dạng văn bản
• Lệnh đính kèm ảnh
• Lệnh đính kèm danh sách
• Lệnh đính kèm file

Để gửi lệnh phản hồi người dùng bằng API gửi tin nhắn, bạn cần có message ID của tin nhắn cần phản hồi. Để lấy được message ID, vui lòng xem tài liệu webhook sự kiện người dùng gửi tin nhắn.

Quyền cần có: Quyền gửi tin và thông báo qua OA

HTTP request

• URL: https://openapi.zalo.me/v2.0/oa/message
• Method: POST
• Content Type: application/json
• Response Type: text/json

Example request

curl
-X POST
-H 'Content-Type: application/json'
-H 'access_token: <your_access_token>'
-d '{
  "recipient":{
    "message_id":"468458835"
  },
  "message":{
    "text":"Bạn cần hỗ trợ gì ạ?"
  }
}' "https://openapi.zalo.me/v2.0/oa/message"

Tham số header

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
access_token	string	yes	Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token tại đây.

Cấu trúc body của request

Tham số	Loại	Tính bắt buộc	Mô tả
recipient	object	yes	Thông tin người nhận
message	object	yes	Nội dung cần gửi

Cấu trúc thuộc tính recipient

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
message_id	string	yes	Reply token cho phép phản hồi tin nhắn đến từ người dùng (nhận được thông qua webhook sự kiện người dùng gửi tin nhắn)

Example respond

{
    "error": 0,
    "message": "Success",
    "data":{
        "quota": {
            "total": 8,
            "remain": 7,
            "type": "reply"
        },
        "message_id": "24684588352",
        "user_id": "2512523625412515"
    }
}

Cấu trúc thuộc tính data

Thuộc tính	Kiểu dữ liệu	Mô tả
quota	object	Thông tin quota của lệnh phản hồi. Các giá trị trả về: total: Tổng số lượng lệnh phản hồi có thể gửi tới người dùng khi nhận tin từ người dùng trong vòng 48 giờ. Xem thêm Chính sách gửi tin. remain: Số lượng lệnh có thể dùng để phản hồi người dùng trong vòng 48 giờ. type: Giá trị trả về là reply cho biết đây là quota của lệnh phản hồi.
message_id	int	ID định danh của lệnh phản hồi
user_id	int	ID của người quan tâm cần phản hồi.