{"repo":"diendh/zca-bridge","free":true,"listed":false,"github":"https://github.com/diendh/zca-bridge","clone":"git clone https://github.com/diendh/zca-bridge.git","description":"Self-hosted Zalo ↔ Chatwoot bridge for Vietnamese customer support teams","language":"TypeScript","stars":117,"topics":["chatwoot","customer-support","docker","fastify","open-source","postgresql","typescript","zalo"],"license":"Apache-2.0","category":"databases-storage","readme_excerpt":"🇬🇧 English: README.en.md Zalo-Chatwoot Bridge zca-bridge là sidecar tự host để đồng bộ hội thoại Zalo hai chiều với Chatwoot. Bridge biến Zalo thành một inbox trong Chatwoot để nhân viên có thể nhận, gửi, ghi chú và theo dõi lịch sử hội thoại ngay trong helpdesk. Mặc định tài liệu chính dùng tiếng Việt. Bản tiếng Anh nằm ở README.en.md. Tóm tắt - Kênh Zalo OA: dùng API chính thức của Zalo, hỗ trợ OAuth, webhook, gửi/nhận tin, backfill và một số luồng xin thông tin khách hàng. - Kênh Zalo cá nhân: dùng zca-js và đăng nhập QR. Đây là API không chính thức, có rủi ro khóa hoặc cấm tài khoản. - Chatwoot: bridge nhận webhook outbound từ Chatwoot và đẩy inbound message vào Chatwoot qua API. - Hàng đợi bền: lưu job trong PostgreSQL, retry lỗi tạm thời và đưa lỗi vĩnh viễn vào dead-letter. - Media: archive file đính kèm cục bộ; file lớn có thể gửi qua link /media có token. Node 24+ · TypeScript ESM · Fastify · PostgreSQL · Vitest · Docker Dự án này độc lập, không thuộc sở hữu, không được tài trợ và không được xác nhận chính thức bởi Zalo, VNG, Chatwoot hoặc nhóm phát triển zca-js . Cảnh báo quan trọng Tài khoản Zalo cá nhân được kết nối qua zca-js , một thư viện không chính thức . Dùng API không chính thức có thể khiến tài khoản Zalo bị hạn chế, khóa hoặc cấm vĩnh viễn. Nên dùng tài khoản phụ, không dùng tài khoản kinh doanh chính hoặc tài khoản có dữ liệu nhạy cảm. Kênh Zalo Official Account (OA) dùng API chính thức của Zalo nên không thuộc nhóm rủi ro từ zca-js . Xem thêm SECURITY","default_branch":null,"files":null,"tree":[],"storefront":"/r/diendh","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/diendh/zca-bridge/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}