Zalo Tương Tác icon

Zalo Tương Tác

Tương tác Zalo: tin nhắn, bạn bè, nhóm, tài khoản và custom API qua zca-js

Message → Gửi video (xem inline)

AI-generated

Summary

Gửi một video inline hoặc album video tới một user hoặc các nhóm Zalo. Nhập URL video; có thể thêm thumbnail, thời lượng, kích thước và caption, rồi chọn cách nhắm nhóm nếu gửi hàng loạt.

Inputs

  • Thread Type (required) — Chọn User hoặc Group; mặc định là Group.
  • Group Target (required) — Khi chọn Group, chọn gửi một nhóm, danh sách nhóm chỉ định, mọi nhóm ngoại trừ danh sách loại trừ, hoặc chỉ các nhóm bạn quản trị. Mặc định là Single Group.
  • Thread ID (required) — ID dạng chuỗi của user hoặc nhóm đích đơn lẻ; dùng khi Group Target là Single Group. Mặc định lấy từ {{$json.threadId}}.
  • Group IDs (required) — Danh sách ID nhóm, phân tách bằng dòng mới hoặc dấu phẩy; dùng với Selected Groups.
  • Only Admin / Deputy In List — Với Selected Groups, mặc định chỉ gửi tới nhóm mà bạn là trưởng nhóm, admin hoặc phó nhóm.
  • Only Admin / Deputy Groups — Với All Groups Except, bật để chỉ gửi tới các nhóm bạn quản trị. Mặc định tắt.
  • Exclude Group IDs — Các ID nhóm cần loại trừ khi dùng All Groups Except hoặc Managed Groups.
  • On Group Send Error — Khi gửi hàng loạt, tiếp tục qua nhóm lỗi hoặc dừng workflow; mặc định tiếp tục.
  • Delay Between Groups (ms) — Thời gian chờ giữa các nhóm khi gửi hàng loạt; mặc định 400 ms.
  • Video URL (required) — URL video cần gửi. Một URL gửi một video; từ hai URL trở lên, phân tách bằng dấu phẩy hoặc khoảng trắng, gửi thành album. Mặc định lấy từ {{$json.mediaUrls}}; operation không tự lấy video từ trigger nếu trường này trống.
  • Thumbnail URL — Ảnh xem trước cho một video. Với album, thumbnail có thể lấy từ metadata video của trigger. Mặc định lấy từ {{$json.thumbnailUrl}}.
  • Duration (ms) — Thời lượng video tính bằng mili giây; mặc định là 0. Có thể ánh xạ từ {{$json.durationMs}}.
  • Width — Chiều rộng video; mặc định 0 để đọc từ tệp. Có thể ánh xạ từ {{$json.width}}.
  • Height — Chiều cao video; mặc định 0 để đọc từ tệp. Có thể ánh xạ từ {{$json.height}}.
  • Caption — Nội dung chữ gửi kèm video hoặc album; mặc định để trống.

Output shape

Một hoặc nhiều item kết quả gửi

Gửi video inline qua API Zalo. URL thuộc miền video-sta*.d1md.me được renew link trước khi forward; kết quả thành công có thể bao gồm forwardStrategy: renewLinkBeforeForward. Khi gửi nhiều nhóm, kết quả và lỗi phụ thuộc vào lựa chọn xử lý lỗi nhóm.

Examples

Example 1: Chỉ gửi một video tới một nhóm

Chọn Group và Single Group, nhập Thread ID dạng chuỗi cùng một Video URL.

Example 2: Gửi album tới các nhóm được chọn

Chọn Group và Selected Groups, nhập Group IDs và ít nhất hai URL trong Video URL; đặt chính sách lỗi và độ trễ nếu cần.

Links

Discussion