Bỏ qua tới nội dung

Gửi tin nhắn & file

POST /api/v1/accounts/{accountId}/conversations/{threadId}/messages

Trường Kiểu Ghi chú
text string Văn bản (≤ 10000 ký tự)
attachments array Tối đa 10 file, mỗi file một trong: upload_id, library_uuid, url
sticker_id string/number Zalo, Telegram
link {url, text} Zalo gửi thẻ link; kênh khác gửi văn bản
quote_msg_id string Trả lời tin
mentions [{user_id, offset, length}] Tag thành viên (Zalo, Telegram)
thread_type user/group Bỏ trống = tự tra

Thứ tự gửi: file → sticker → link → văn bản. Response liệt kê từng tin đã gửi kèm msg_id nếu kênh trả về.

Upload file trước

bash
# Raw body (khuyên dùng cho file lớn, ghi thẳng xuống đĩa)
curl -X POST -H "Authorization: Bearer dpk_xxx" -H "X-Filename: bao-gia.pdf" \
  --data-binary @bao-gia.pdf http://127.0.0.1:9900/api/v1/media/uploads

# multipart/form-data
curl -X POST -H "Authorization: Bearer dpk_xxx" -F "file=@anh.jpg" http://127.0.0.1:9900/api/v1/media/uploads

Kết quả có upload_id (hết hạn sau 24 giờ, chỉ key đã upload dùng được).

Gửi kèm file

json
{ "text": "Báo giá gửi anh", "attachments": [{ "upload_id": "upl_..." }] }
  • url: Deplao tự tải file từ link công khai (chặn link vào mạng nội bộ).
  • library_uuid: file trong Thư viện media của tài khoản.
  • Video Zalo được gửi như video xem được ngay (không phải file).

Lưu ý theo kênh

Thao tác Zalo Facebook Telegram
Văn bản, ảnh, file ✓ ✓ ✓
Video ✓ (video thật) ✓ ✓
Sticker ✓ - ✓
Sửa tin - ✓ ✓
Thu hồi ✓ ✓ ✓ (xoá)
Reaction ✓ (emoji hoặc mã HEART, LIKE…) ✓ ✓
Chuyển tiếp văn bản, ảnh, video, file + forward gốc + forward gốc
Trang trướcQuy ước chungTrang sauSự kiện realtime

Chưa tìm thấy câu trả lời?

Nhắn hỗ trợ qua Telegram