Gửi tin nhắn video

Chúng tôi cung cấp một API gửi tin nhắn video, dưới định danh của người dùng hoặc bot.

HTTP request

POST https://{app_id}.api.piscale.com/open-api/v1.0/chat/messages

Request body

Ví dụ

{
    "sender": {
        // "bot_id": "6872016393689131",
        "user_id": "30043"
    },
    "target": {
        // "user_ids": ["30043"]
        "thread_id": "62046069159700"
    },
    "body": {
        "text": "Mọi người xem video nhé!",
        "metadata": [
            {
                "name": "video.mp4",
                "width": 750,
                "height": 1624,
                "src_thumb_url": "https://video-1.piscale.com/100001/dcdc9a6b-a91a-43ab-aacb-aaca87baf639/thumb.jpg",
                "src_url": "https://video-1.piscale.com/100001/dcdc9a6b-a91a-43ab-aacb-aaca87baf639/RPReplay_Final1697041206.mp4",
                "size": 4170635,
                "type": "video"
            }
        ]
    }
}

Tên	Kiểu dữ liệu	Mô tả	Bắt buộc
sender.bot_id	string	Gửi dưới định dạng bot	✗
sender.user_id	string	Gửi dưới định danh user	✗
target.user_ids	array	Danh sách các user_id nhận	✗
target.thread_id	string	Mã cuộc hội thoại	✗
body.text	string	Nội dung văn bản	✓
body.metadata	array	Danh sách hình video	✓

note

• sender sẽ bắt buộc phải có bot_id hoặc user_id. Người gửi tin phải xác định rõ là một chương trình tự động (bot) hoặc là một người dùng.
• target sẽ bắt buộc phải có thread_id hoặc user_ids. user_ids tối đa 100 phần tử.

Giải thích các thuộc tính của metadata

Tên	Kiểu dữ liệu	Mô tả	Bắt buộc
type	string	Phải là "video"	✓
name	string	Tên video	✓
width	int	Chiều rộng video	✓
height	int	Chiều cao video	✓
size	int	Kích cỡ của video	✓
source_url	string	Url dùng để tải video	✓
source_thumb_url	string	Url ảnh của video có dung lượng thấp và được hiển thị ở danh sách tin nhắn	✓

Response

Nếu thành công, bạn sẽ nhận được phản hồi.

Ví dụ

{
    "message_code": "M200",
    "message": "Success"
}

Tên	Kiểu dữ liệu	Mô tả
message_code	string	Mã thông điệp. Xem chi tiết
message	string	Nội dung mã thông điệp