Giới thiệu
Hạ Tầng là nền tảng cho lập trình viên dành cho doanh nghiệp Việt Nam, ghép từ các module: email giao dịch, chat hỗ trợ khách hàng, thanh toán chuyển khoản, danh mục sản phẩm và CRM. Mỗi doanh nghiệp chỉ bật những module mình cần. Tất cả dùng chung một tài khoản, một đội ngũ, một bộ API key và một luồng webhook, nên một lần tích hợp là dùng được mọi thứ.
Các module
| Module | Dùng để | Bắt đầu |
|---|---|---|
| API email tương thích Resend và SMTP relay, nhiều tên miền gửi, template, danh sách nhận, chiến dịch email, automation và nhận thư đến | Tổng quan Email | |
| Hỗ trợ (Hỗ trợ khách hàng) | Widget chat cho website, SDK gốc cho iOS, Android, Flutter và React Native, một hộp thư chung cho Zalo (OA và cá nhân), Messenger, Instagram, TikTok, TikTok Shop, WhatsApp, Telegram, LINE, X và email, cùng phiếu hỗ trợ và trợ lý AI | Tổng quan Hỗ trợ |
| Thanh toán | Nhận chuyển khoản VietQR thẳng vào tài khoản ngân hàng của bạn, tự đối soát và xuất hoá đơn điện tử | Tổng quan Thanh toán |
| Sản phẩm | Danh mục sản phẩm và đơn hàng, gửi thẻ sản phẩm và link thanh toán ngay trong cuộc chat | REST API Hỗ trợ |
| CRM | Một hồ sơ khách hàng gộp từ mọi kênh, trường tuỳ chỉnh, lọc theo giai đoạn, nhãn, kênh, và gửi Zalo ZNS | REST API Hỗ trợ |
Không có lớp "website" hay "kênh bán" đứng trên các module. Mỗi module tự quản lý tài nguyên của nó và có thể có nhiều cái: Email có nhiều tên miền gửi, Hỗ trợ có nhiều website và ứng dụng di động.
Owner hoặc admin bật, tắt module trong Cài đặt doanh nghiệp → Module. Xem Doanh nghiệp và module.
Một API key, một luồng webhook
Mọi module dùng chung một REST API tại https://api.hatang.dev, với cùng quy ước:
- Một loại API key. Key bắt đầu bằng
ht_và mang các scope nhưemail:sendhaychat:read. Gửi trong headerAuthorization: Bearer ht_123.... - Một định dạng lỗi. Mọi lỗi là một object JSON
{ statusCode, name, message }. Xem Lỗi. - Một luồng webhook. Một endpoint webhook đăng ký sự kiện của bất kỳ module nào (
email.delivered,chat.message.created,payment.succeeded, …) và mọi lượt gửi đều ký theo cùng một cách. Xem Webhook. - Quy tắc chung cho giới hạn tần suất, phân trang và idempotency.
Ngoài ra còn hai host phục vụ các client riêng:
| Host | Ai dùng |
|---|---|
https://api.hatang.dev | Server của bạn: REST API của mọi module |
https://chat.hatang.dev | Widget chat và SDK chat di động (gateway realtime) |
smtp.hatang.dev:5870 (STARTTLS) | Ứng dụng gửi email qua SMTP |
https://app.hatang.dev | Dashboard, cho bạn và đội ngũ |
Cách dùng trang tài liệu này
Trang tài liệu có hai phần:
- Hướng dẫn (phần này) chỉ cách làm một việc từ đầu đến cuối: gửi email đầu tiên, gắn widget chat lên website, nhận thanh toán, xác minh webhook. Hãy bắt đầu với Bắt đầu, rồi mở hướng dẫn của các module bạn dùng.
- Tham chiếu liệt kê mọi chi tiết: tham chiếu REST API, tham chiếu chat gateway, sự kiện webhook, mã lỗi, giới hạn và giao thức realtime.
Mã mẫu trong hướng dẫn có cURL, Node.js (với @hatang/sdk), Python và PHP. Chọn ngôn ngữ một lần, mọi trang sẽ hiện theo ngôn ngữ đó.
Các bước tích hợp
- Tạo tài khoản tại app.hatang.dev và chọn các module cần dùng.
- Tạo API key với scope của các module đó (Xác thực API).
- Gọi API tại
https://api.hatang.dev, hoặc dùng SDK Node.js@hatang/sdk. - Thêm một endpoint webhook để nhận sự kiện.
- Mời đội ngũ và cấp cho mỗi người đúng quyền họ cần (Nhân viên và phân quyền).