Skip to main content

2026-11-14

  • REST /api/v1: channels, accounts, conversations, messages (gửi, reaction, thu hồi), media, contacts, tìm người, kết bạn. Lỗi thống nhất, phân trang cursor, Idempotency-Key.
  • Webhook schema_version 2026-11-01: ký HMAC-SHA256, hỗ trợ hai v1= khi xoay secret, retry 7 lần.
  • MCP server (Streamable HTTP, không session) với 10 công cụ lọc theo scope và capability.
  • Kênh Zalo cá nhân.
  • Gửi tin: hàng pending được tạo trước khi xếp lệnh (id trong 202 luôn có hàng thật); gửi lại tin pending không gửi trùng; 202 không lưu theo Idempotency-Key; Idempotency-Key gắn với đường dẫn thật.
  • direction=after luôn trả next_cursor; giới hạn tin đến muộn được ghi trong Khái niệm.
  • Upload media lưu vào DB (media_uploads), stream thẳng lên R2, hết hạn sau 30 ngày kể từ lúc tạo object (410).
  • Webhook: id có tiền tố (msg_, med_, cnv_, acc_); đổi shape trước khi khoá API v1 nên schema_version giữ 2026-11-01.
  • 502 UPSTREAM_ERROR có thể kèm details.upstream_code.
Chính sách phiên bản: thêm field là tương thích ngược. Thay đổi phá vỡ sẽ ra /v2 và schema_version webhook mới, có thông báo trước.