Zalo và chat

Conan1 nói chuyện qua Zalo bằng cách nào, và trợ lý Ran làm gì trên tài khoản cá nhân?

Mục này là nguồn sự thật về Zalo và chat: các cách kết nối với Zalo, cách thư viện zca-js hoạt động, và agent Ran, chạy local trên máy của chủ tài khoản, có thư mục riêng là ran/ trong monorepo.

Tin nhắn Zalo ──WebSocket──▶ zca-js ──▶ Ran (agent) ──▶ Model (Claude / OpenAI-compatible)
                                           │
                                           └──▶ Giao diện web http://127.0.0.1:3939

Trang	Nội dung
Kênh kết nối Zalo	Zalo Bot chính thức và Zalo cá nhân khác nhau thế nào
zca-js	Cơ chế, chất lượng code, làm được / không làm được gì
Ran — kiến trúc	Thành phần, luồng xử lý, cấu hình, dữ liệu
Ran — hướng dẫn sử dụng	Từng bước cài, đăng nhập, cấu hình, vận hành

Dữ liệu cho máy đọc

Mỗi trang trong mục này có front-matter YAML (kind, updated, các khoá theo chủ đề). File tổng hợp cho máy đọc, gồm schema cấu hình và REST API của Ran, nằm ở /zalo/index.json (nguồn: docs/public/zalo/index.json). Khi sửa một trang thì sửa file JSON cho khớp.