Ha Tang developer changelog

Hạ Tầng cho AI coding agent

2026-11-03T00:00:00.000Z

Claude Code, Cursor, Copilot và các coding agent khác giờ đọc được tài liệu này dạng Markdown và làm việc trực tiếp với Hạ Tầng: một MCP server, bộ quy tắc dựng sẵn cho dự án, và năm công thức theo tác vụ.

MCP server @hatang/mcp 0.1.0. npx -y @hatang/mcp cho agent search_docs và read_doc (không cần key), và khi có API key thì thêm các tool gửi email, kiểm tra tên miền, tạo và giả lập thanh toán VietQR, đọc hoá đơn điện tử, xử lý hộp thư và thêm kiến thức cho trợ lý AI. --read-only giới hạn ở việc tra cứu. Xem MCP server.
Tài liệu cho máy đọc. /vi/docs/llms.txt liệt kê mọi trang, /vi/docs/llms-full.txt chứa toàn bộ tài liệu, mỗi trang có bản Markdown ở chính địa chỉ của trang thêm .md, và đặc tả OpenAPI ở /docs/openapi.json. Bản tiếng Anh ở /docs.
Quy tắc cho dự án. Một mục AGENTS.md, một Cursor rule và một Claude Code skill cho agent biết dùng SDK nào, key để ở đâu, cách xác minh thanh toán và webhook. Xem Dùng Hạ Tầng với AI coding agent.
Công thức. Email từ Node.js, Thanh toán VietQR, Zalo ZNS từ code, Chat trên website và Hoá đơn điện tử qua API.

Trang SDK trên npm, pub.dev, PyPI, Maven Central và wordpress.org

2026-11-03T00:00:00.000Z

Mọi SDK của Hạ Tầng có một bản vá mới, với trang trên registry giới thiệu SDK làm gì và dẫn về hướng dẫn tương ứng ở đây. Không đổi code.

SDK	Phiên bản	Registry
Node.js	`@hatang/sdk` 0.6.1	npm
React và Next.js	`@hatang/chat-react` 0.1.1	npm
React Native	`@hatang/chat-react-native` 0.4.1	npm
Flutter	`hatang_chat` 0.6.1	pub.dev
iOS	`HatangChat` 0.4.1	GitHub, đã gửi lên Swift Package Index
Android	`dev.hatang:chat` 0.4.1	Maven Central
Python	`hatang` 0.1.1	PyPI
WordPress	`hatang-chat` 0.2.3	wordpress.org

README của mỗi SDK có phần About Ha Tang cùng link tới hướng dẫn, tài liệu API, changelog này và trang hỗ trợ.
SDK iOS và Android có file LICENSE (MIT).
Gói Python không còn link tới trang mã nguồn và changelog không công khai.

Không bắt buộc nâng cấp. Xem tất cả SDK và các phiên bản được hỗ trợ.

Nhóm email

2026-11-02T00:00:00.000Z

Nhóm email biến một địa chỉ trên tên miền đang nhận thư, ví dụ team@congty.vn, thành địa chỉ chung: mọi thư gửi tới được chuyển cho từng thành viên, giống nhóm của Google Workspace. Tạo nhóm tại Email → Nhóm email.

Mỗi thành viên nhận một bản riêng từ địa chỉ nhóm, người gửi hiện là "Tên người gửi via Tên nhóm", bấm Trả lời là trả lời thẳng cho người gửi gốc.
Không chuyển: thư rác, thư tự động, thư đã đi qua một nhóm, và quá 30 thư mỗi giờ từ cùng một người gửi. Thư gốc luôn nằm ở Nhận về.
Mỗi bản chuyển tính vào hạn mức gửi trong ngày và hiện trong mục Email với nguồn forward.

Với người dùng API:

Endpoint mới POST/GET /email-groups và GET/PATCH/DELETE /email-groups/{id} (email:write để sửa, email:read để xem). @hatang/sdk có thêm hatang.emailGroups.
Trường source của email có thêm giá trị forward. Nếu code của bạn rẽ nhánh theo trường này, hãy thêm nhánh mặc định.

Xem hướng dẫn Nhóm email.

Email hỗ trợ không cần chuyển tiếp

2026-11-02T00:00:00.000Z

Kênh email hỗ trợ có địa chỉ nằm trên tên miền đã nhận email tại Hạ Tầng (Email → Tên miền → Nhận email) giờ không cần cài thêm gì: email tới địa chỉ đó vào thẳng Hộp thư, không cần chuyển tiếp hay tên miền phụ MX riêng.

Trang hộp thư báo điều này và kênh chuyển sang Hoạt động ngay. Địa chỉ dạng cskh+billing@ cũng nhận được; phần sau + thành thẻ.
Chỉ đúng địa chỉ hỗ trợ chuyển sang Hộp thư. Các địa chỉ khác trên tên miền, kể cả nhóm email, vẫn nằm ở Email → Đã nhận và vẫn kích hoạt email.received.
Kết nối lại một địa chỉ hỗ trợ đã ngắt kết nối giờ sẽ dùng lại kênh cũ, giữ nguyên hội thoại, thay vì báo địa chỉ đã được kết nối.

Xem Kết nối địa chỉ email hỗ trợ.

API Email kiểm tra scope của API key

2026-10-24T00:00:00.000Z

API Email nay kiểm tra scope của key, đúng như dashboard vẫn mô tả:

Gửi email (POST /emails, POST /emails/batch, SMTP relay) và đổi lịch gửi (PATCH /emails/{id}, POST /emails/{id}/cancel) cần email:send.
Đọc email (GET /emails, GET /emails/{id}, GET /emails/{id}/events) cần email:read; email:send và email:write đã bao gồm quyền này.

Trước đây mọi key hợp lệ đều gọi được các endpoint này. Key thiếu scope giờ nhận 401 restricted_api_key (qua SMTP là 550 5.7.1). Key toàn quyền (*), email:* hoặc email:send không bị ảnh hưởng. Nếu key đang dùng để gửi email chỉ có các scope khác, như email:write hay chat:*, hãy thêm email:send cho key ở mục API Keys trong dashboard.

Trung tâm trợ giúp tại hatang.dev/vi/help

2026-10-24T00:00:00.000Z

Hướng dẫn từng bước cho những người dùng dashboard hằng ngày giờ nằm ở trung tâm trợ giúp mới, bằng tiếng Việt và tiếng Anh, kèm ảnh chụp từng màn hình: hộp thư, từng kênh, widget chat, trợ lý AI, tự động hoá, khách hàng, báo cáo, email và thanh toán.

Tài liệu cho lập trình viên giữ những gì bạn cần để tích hợp Hạ Tầng: hướng dẫn API và SDK, tài liệu tham chiếu, webhook và giao thức realtime. Các bài chỉ gồm thao tác trên dashboard đã chuyển sang trung tâm trợ giúp, và địa chỉ cũ tự chuyển hướng sang đó:

toàn bộ hướng dẫn kênh (Zalo OA, Zalo cá nhân, TikTok, TikTok Shop, Messenger và Instagram, WhatsApp, Telegram, LINE, X, email), nay ở mục Kênh;
Nhân viên và phân quyền, nay là Nhân viên và vai trò;
Doanh nghiệp và module, nay là Bật và tắt module.

Trang Tổng quan Hỗ trợ khách hàng vẫn liệt kê mọi kênh kèm giá trị channel dùng trong API.

@hatang/sdk 0.4.0: mặc định gọi production, template, liên hệ dùng chung, automation

2026-10-24T00:00:00.000Z

@hatang/sdk 0.4.0 mặc định gọi https://api.hatang.dev. Trước đây, client tạo mà không có baseUrl hay HATANG_BASE_URL sẽ gọi http://localhost:3001; khi phát triển local giờ hãy truyền baseUrl (hoặc đặt HATANG_BASE_URL).

Lệnh mới:

Template: templates.create/get/list/update/remove/publish/duplicate, và emails.send({ to, template: { id, variables } }).
Liên hệ dùng chung: contacts.* không cần audience_id, gọi theo id hoặc email, kèm properties, segments và topics; thêm namespace segments, topics và contactProperties. Truyền audience_id vẫn dùng các route audience cũ.
Automation: events.*, automations.* và automations.runs.*.
Số liệu: emails.metrics(), logs.list/get và usage.get.

Namespace blog đã bị bỏ. Xem hướng dẫn Node.js.

Kênh WhatsApp, Telegram, X và LINE

2026-10-24T00:00:00.000Z

Hộp thư có thêm bốn kênh mới, bên cạnh widget website, Zalo, Messenger, Instagram, TikTok và email. Trợ lý AI, flow, quy tắc phân chia và báo cáo hoạt động trên các kênh này giống mọi kênh khác. Kết nối tại Hỗ trợ khách hàng → Kênh → Thêm kênh.

WhatsApp: kết nối số WhatsApp Business qua Embedded Signup. Số vẫn dùng được trong ứng dụng WhatsApp Business (coexistence), và tin nhắn gửi từ điện thoại cũng hiện trong hội thoại. Sau cửa sổ 24 giờ, nhân viên trả lời bằng mẫu tin đã được duyệt.
Telegram: kết nối bot Telegram của bạn. Nếu có Telegram Premium, bạn có thể liên kết bot qua Telegram Business để tin nhắn gửi tới tài khoản riêng của bạn cũng về Hộp thư. Kênh này chỉ dùng Bot API.
X: nhận tin nhắn trực tiếp (DM) và tự động trả lời khi có người @nhắc tới tài khoản hoặc trả lời bài đăng. Mỗi doanh nghiệp kết nối qua ứng dụng X developer của riêng mình, vì X tính phí API theo từng lượt gọi.
LINE: kết nối LINE Official Account qua Messaging API, chỉ nhận hội thoại một-một.

Với người dùng API và webhook:

Trường channel của hội thoại, khách hàng và payload webhook có thêm bốn giá trị: whatsapp, telegram, x và line. Bộ lọc channel của GET /chat/customers nhận cùng các giá trị này. Nếu code của bạn rẽ nhánh theo channel, hãy thêm nhánh mặc định vì sẽ còn kênh mới.
Từ @hatang/sdk 0.4.0 trở đi, kiểu ChatChannel đã có các giá trị mới.
Tin trả lời bằng mẫu WhatsApp là một tin của nhân viên, có metadata.whatsapp_template dạng { name, language, params }.

Tài liệu cho lập trình viên chuyển về hatang.dev/docs

2026-10-23T00:00:00.000Z

Tài liệu nay ở hatang.dev/docs (tiếng Anh) và hatang.dev/vi/docs (tiếng Việt), chia hai phần: Hướng dẫn tích hợp từng bước và Tham chiếu sinh từ mã nguồn. Liên kết cũ docs.hatang.dev tự chuyển tới trang tương ứng.

Hướng dẫn mới: xác thực, giới hạn tốc độ, xử lý lỗi, phân trang, idempotency, gửi email, tên miền, SMTP relay, broadcast, khả năng vào hộp thư, từng kênh hỗ trợ và nhiều trang khác.
Tài liệu REST API nằm ngay trong trang, mỗi endpoint một trang, code mẫu bảy ngôn ngữ và bảng "Try it" để gọi thử.
Mỗi sự kiện webhook có trang riêng kèm schema payload.

API: payload webhook trong bản đặc tả OpenAPI

2026-10-23T00:00:00.000Z

https://api.hatang.dev/openapi.json nay mô tả mọi sự kiện webhook công khai trong phần webhooks của OpenAPI 3.1, kèm payload của từng sự kiện, thay cho danh sách tên như trước. Bản đặc tả của chat gateway có ở https://chat.hatang.dev/openapi.json, với operationId cố định.

Các endpoint được xếp theo từng tài nguyên (Conversations, Customers, Orders, Tickets…), và mỗi tag thuộc một nhóm.
Phản hồi 429 ghi đúng giới hạn của từng API: 10 yêu cầu/giây cho Email, 50 cho Hỗ trợ và 20 cho Thanh toán.
API trả lời preflight CORS từ https://hatang.dev, để bảng "Try it" trong tài liệu gọi được API bằng key của bạn.

Plugin WordPress 0.2.1

2026-10-23T00:00:00.000Z

Hạ Tầng Chat 0.2.1 cập nhật trang cài đặt và readme: Site ID nằm ở Hỗ trợ khách hàng → Kênh → website của bạn trong dashboard, và readme liệt kê đủ các kênh dùng chung hộp thư. Không thay đổi cách hoạt động.

SDK di động theo cài đặt widget

2026-10-14T00:00:00.000Z

iOS 0.3.0, Android 0.3.0, Flutter 0.5.0 và React Native 0.3.0 hiển thị thêm các cài đặt widget của website mà không cần sửa code:

Đầu khung chat: dòng phụ dưới tên site, và logo doanh nghiệp (hoặc chữ cái đầu tên site) thay cho ảnh nhân viên khi hồ sơ đặt là doanh nghiệp.
Lời chào: ẩn khi tắt hoặc tắt trên điện thoại; ký tên nhân viên đầu tiên đang trực tuyến khi người gửi là "nhân viên trực tuyến".
Nút liên hệ: Zalo, Messenger, gọi điện và email dưới đầu khung chat.

Chuỗi mới cho nút liên hệ (callUs/call và emailUs) cần truyền vào nếu bạn tự tạo đối tượng chuỗi. Gateway cũ không gửi các cài đặt này nên màn hình giữ như trước. React Native 0.3.1 sửa metadata repository của gói.

@hatang/sdk 0.3.0: nhận email

2026-10-14T00:00:00.000Z

@hatang/sdk 0.3.0 đọc được email nhận về: emails.receiving.list(), .get(id) và tệp đính kèm với link tải có chữ ký (hiệu lực một giờ). Tên miền có thêm capabilities, nên domains.update({ id, capabilities: { receiving: "enabled" } }) bật nhận email. Câu trả lời mẫu có thêm subject và is_private, link thanh toán có thêm qr_payload cho ứng dụng tự vẽ mã VietQR.