• 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.

• 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ợ.

• 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.

• 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ợ.

• 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.

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.

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.

• 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 }.

• 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.

• 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.

• Đầ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.