Tải lên media (upload)

Tải ảnh, video hoặc tệp lên Omnichannel để lấy attachment_id, dùng khi gửi tin nhắn đính kèm.

Xem Markdown

Trước khi gửi tin nhắn có đính kèm (type: image hoặc file), bạn tải tệp lên để nhận attachment_id, sau đó truyền id này vào attachment_ids khi gọi gửi tin nhắn.

Endpoint

MethodEndpointMô tả
POST/v1/mediaTải lên một tệp media, trả về attachment_id (multipart/form-data)

Tham số thân yêu cầu (multipart/form-data)

Tham sốKiểuBắt buộcMô tả
filebinaryCóTệp cần tải lên (ảnh/video/tài liệu)
channel_idstringKhôngGắn media với một kênh cụ thể

Kiểm thử tại chỗ

POSThttps://omni.hitechcloud.vn/v1/media

Tải lên qua multipart/form-data. Token không được lưu lại.

Body
cURL tải ảnh lên
curl -X POST "https://omni.hitechcloud.vn/v1/media" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/duong-dan/anh-san-pham.jpg" \
  -F "channel_id=chn_01HZX8QWERTY"
Phản hồi (201 Created)
{
  "status": "success",
  "data": {
    "id": "att_01HZIMG01",
    "type": "image",
    "mime_type": "image/jpeg",
    "size": 184203,
    "url": "https://omni.hitechcloud.vn/media/att_01HZIMG01.jpg"
  }
}
Dùng id trả về (ví dụ att_01HZIMG01) cho attachment_ids khi gọi gửi tin nhắn. Mỗi attachment_id dùng được trong vòng 24 giờ.