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_version2026-11-01: ký HMAC-SHA256, hỗ trợ haiv1=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 trong202luôn có hàng thật); gửi lại tinpendingkhông gửi trùng;202không lưu theoIdempotency-Key;Idempotency-Keygắn với đường dẫn thật. direction=afterluô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ênschema_versiongiữ2026-11-01. 502 UPSTREAM_ERRORcó thể kèmdetails.upstream_code.
/v2 và schema_version webhook mới, có thông báo trước.