Hướng dẫn sử dụng

Hani AI — ChatAPI v2 Platform

Dashboard

Đăng ký tài khoản

Tạo tài khoản dùng thử miễn phí trong vòng 2 phút

1

Truy cập trang đăng ký

Nhấn Đăng ký miễn phí trên trang chủ hoặc vào /register

2

Điền thông tin và chọn gói

Nhập tên công ty, email, số điện thoại và chọn gói dịch vụ phù hợp (có thể bắt đầu bằng gói Trial dùng thử).

3

Kích hoạt tài khoản

Với gói Trial, tài khoản được kích hoạt ngay. Với gói trả phí, hoàn tất thanh toán (chuyển khoản/MoMo/VNPay/USDT) rồi hệ thống tự kích hoạt.

Gói Trial dùng thử miễn phí — không cần thẻ tín dụng. Xem chi tiết số tin nhắn và thời hạn của từng gói trực tiếp tại trang đăng ký (số liệu có thể được cập nhật theo thời gian).

Tổng quan Dashboard

Các khu vực chính trong hệ thống

Dashboard

Thống kê tin nhắn, leads, hoạt động theo ngày. Xem nhanh tình trạng tất cả kênh.

Kênh MXH

Quản lý tất cả kênh đã kết nối: Facebook, Zalo, Instagram, Website, Shopee, Lazada, TikTok.

Hội thoại

Xem lại lịch sử chat của tất cả khách hàng. Lọc theo kênh, trạng thái, thời gian.

Leads

AI tự động thu thập tên, email, SĐT từ hội thoại. Export CSV để chạy remarketing.

Huấn luyện AI

Thêm ví dụ hội thoại, từ vựng riêng của ngành, hướng dẫn cho AI để trả lời chính xác hơn.

Cài đặt

Tùy chỉnh tên bot, màu sắc widget, system prompt, chế độ tập trung AI.

Tạo & cấu hình chatbot

Thiết lập nhân cách và hành vi cho AI của bạn

Cấu hình cơ bản

Tên Bot

Tên hiển thị trong widget chat. VD: "Trợ lý HANI", "Bot tư vấn"

Màu sắc Widget

Màu chủ đạo của widget chat, nút bấm và header (gói có "Custom thương hiệu" mới tự đổi được)

Tin nhắn chào

Tin nhắn đầu tiên bot gửi khi khách mở chat. VD: "Xin chào! Bạn cần tư vấn gì?"

System Prompt — Hướng dẫn cho AI

System Prompt là "bản hướng dẫn bí mật" giúp AI hiểu vai trò của mình. Viết càng chi tiết, AI trả lời càng chính xác.

Ví dụ System Prompt
Bạn là trợ lý tư vấn của HANI - công ty cung cấp dịch vụ hosting, tên miền và thiết kế website.

Nhiệm vụ của bạn:
- Tư vấn khách hàng về các gói hosting, tên miền, SSL
- Giải đáp thắc mắc về dịch vụ
- Thu thập thông tin liên hệ khi khách có nhu cầu

Nguyên tắc:
- Luôn lịch sự, thân thiện
- Trả lời ngắn gọn, súc tích (dưới 150 từ)
- Nếu không biết, hãy hỏi thêm hoặc đề nghị kết nối nhân viên

Chế độ tập trung AI

🌊

Linh hoạt

Trả lời đa dạng chủ đề, không giới hạn

⚖️

Vừa phải Mặc định

Ưu tiên chủ đề kinh doanh

🎯

Nghiêm ngặt

CHỈ trả lời về sản phẩm/dịch vụ

Huấn luyện chatbot

Vào Huấn luyện AI trong menu (/client/training) — có 4 mục, mỗi mục giúp AI hiểu doanh nghiệp bạn theo một cách khác nhau

Ví dụ Training — Hỏi/Đáp mẫu

Hiệu quả nhất

Thêm các cặp Câu hỏi mẫu → Câu trả lời chuẩn. AI ưu tiên dùng dữ liệu này trước khi tự suy nghĩ, tương tự 1 kho FAQ riêng cho doanh nghiệp bạn.

Hỏi: Giá hosting bao nhiêu?
Đáp: Gói cơ bản từ 50.000đ/tháng...
Hỏi: Thời gian setup bao lâu?
Đáp: Trong vòng 24 giờ làm việc...

Từ vựng — Thuật ngữ riêng của ngành

Thêm thuật ngữ, tên viết tắt hoặc cách gọi riêng trong ngành của bạn (kèm định nghĩa, các tên gọi khác/alias, ví dụ dùng thực tế) để AI hiểu đúng ngữ cảnh thay vì hiểu theo nghĩa thông thường.

Ánh xạ Schema

Nâng cao

Dành cho khách hàng đã kết nối cơ sở dữ liệu riêng (external DB) — khai báo cột nào trong bảng của bạn tương ứng với sản phẩm/giá/tồn kho... để AI đọc đúng dữ liệu thật.

Hướng dẫn

Thêm các chỉ dẫn hành vi cụ thể cho AI (VD: "luôn hỏi số điện thoại trước khi báo giá", "không tự ý cam kết thời gian giao hàng") — bổ sung thêm cho System Prompt.

Mẹo huấn luyện hiệu quả

  • • Thêm ít nhất 20 Ví dụ Training cho câu hỏi phổ biến nhất
  • • Viết câu hỏi theo cách khách thực sự hỏi (không cần hoàn hảo)
  • • Cập nhật thường xuyên khi có sản phẩm/giá mới
  • • Mục "Huấn luyện chatbot" cần gói có tính năng Quản lý huấn luyện AI — nếu chưa thấy menu này, kiểm tra lại gói dịch vụ đang dùng

Kịch bản chốt sales

Hướng dẫn AI dẫn dắt khách hàng từ hỏi thăm đến chốt đơn

Kịch bản cơ bản: Thu thập Lead

1

Khách hỏi → AI chào hỏi và giới thiệu ngắn

2

AI trả lời câu hỏi + đề xuất sản phẩm phù hợp

3

AI hỏi thêm nhu cầu: "Bạn cần cho dự án như thế nào?"

4

AI xin thông tin liên hệ: "Để tư vấn chi tiết, cho mình xin số điện thoại nhé?"

Thêm vào System Prompt để kích hoạt kịch bản

System Prompt — Phần kịch bản chốt sales
Quy trình tư vấn:
1. Chào hỏi thân thiện
2. Hỏi nhu cầu cụ thể của khách
3. Giới thiệu gói phù hợp nhất (chỉ 1-2 gói, đừng liệt kê tất cả)
4. Nhấn mạnh lợi ích chính
5. Nếu khách quan tâm, xin SĐT/email để tư vấn chi tiết

Khi xin thông tin liên hệ, dùng câu: "Để mình có thể tư vấn
và gửi báo giá chính xác nhất, bạn để lại số điện thoại nhé?"

Quick Replies — Nút gợi ý nhanh

Thêm các nút bấm nhanh giúp khách dễ tương tác. Khi khách nhấn, AI sẽ trả lời theo keyword đã cấu hình.

💰 Báo giá 📦 Sản phẩm 📞 Liên hệ 🎁 Khuyến mãi

Cấu hình Quick Replies trong phần chỉnh sửa từng kênh Social

Câu hỏi thường gặp

Những thắc mắc phổ biến nhất khi dùng Hani AI

Chatbot trả lời sai hoặc chưa biết thì phải làm sao?

Thêm câu hỏi/câu trả lời đúng vào mục Huấn luyện chatbot — AI sẽ ưu tiên dùng dữ liệu này ở lần hỏi sau.

Có thể tạm dừng AI để tự trả lời không?

Có — xem mục Human Takeover. Bạn chủ động tắt/bật AI cho từng hội thoại bất cứ lúc nào.

Dùng hết tin nhắn trong tháng thì sao?

AI tạm dừng tự động trả lời cho tới kỳ reset hạn mức tiếp theo, hoặc bạn có thể nâng cấp gói để tăng hạn mức ngay.

Đổi mật khẩu / thông tin tài khoản ở đâu?

Vào Cài đặt trong menu.

Kết nối kênh bị lỗi/gián đoạn thì sao?

Với Facebook/Zalo, token có thể hết hạn — vào Kênh MXH → chọn kênh → nhấn làm mới kết nối. Nếu vẫn lỗi, liên hệ bộ phận hỗ trợ ở chân trang.

Tích hợp vào Website

Thêm chat widget vào website chỉ với 2 dòng code

Bước 1: Lấy API Key

Vào Cài đặt → copy API Key của bạn.

Bước 2: Thêm code vào website

Dán trước thẻ </body>
<script>
  window.ChatAPIConfig = {
    apiUrl: 'https://hani.io.vn',
    apiKey: 'YOUR_API_KEY'
  };
</script>
<script src="https://hani.io.vn/js/chatbot-widget.js"></script>

Bước 3: Hoàn tất

Widget tự động xuất hiện ở góc màn hình. Màu sắc, tên bot, vị trí được lấy từ cài đặt của bạn.

Tích hợp cho WordPress / Shopify

Thêm code vào phần Custom HTML trong theme editor hoặc dùng plugin "Custom Scripts". Không cần lập trình.

Kết nối Facebook Fanpage

AI tự động trả lời Messenger và comment trên Fanpage 24/7

1

Vào Kênh MXH → Kết nối kênh mới

Từ menu Kênh MXH, nhấn nút "Kết nối kênh mới"

2

Chọn thẻ Facebook (1-click connect)

Hệ thống chuyển bạn sang trang đăng nhập Facebook

3

Đăng nhập và cấp quyền

Chọn Page bạn muốn kết nối → nhấn "Tiếp tục" → "OK"

4

Chọn Page (nếu có nhiều Page)

Chọn Page muốn kết nối AI → hệ thống tự lưu và bật AI

Xong! Webhook được đăng ký tự động

AI bắt đầu trả lời Messenger và comment ngay lập tức

AI có thể làm gì trên Facebook?

  • Trả lời tin nhắn Messenger tự động
  • Reply comment trên bài đăng
  • Gửi nút Quick Reply cho khách dễ tương tác
  • Thu thập thông tin khách hàng vào Lead

Z Kết nối Zalo Official Account

AI tự động trả lời tin nhắn Zalo OA 24/7

1

Vào Kênh MXH → Kết nối kênh mới → Chọn Zalo

2

Chọn thẻ Zalo (1-click connect)

Chuyển sang trang cấp quyền của Zalo

3

Đăng nhập tài khoản Zalo đang quản lý OA → Đồng ý cấp quyền

Xong! AI bắt đầu trả lời tin nhắn Zalo

Lưu ý về Zalo token

Access token Zalo có thời hạn theo quy định của Zalo. Khi hết hạn, hệ thống sẽ báo lỗi gửi tin — vào Kênh MXH → chọn kênh Zalo → nhấn "Làm mới kết nối" để cấp lại quyền.

Kết nối Instagram

AI trả lời DM Instagram Business tự động

Yêu cầu trước khi kết nối

  • • Tài khoản Instagram phải là Business hoặc Creator (không dùng tài khoản cá nhân)
  • • Tài khoản Instagram phải được liên kết với Facebook Page
1

Vào Kênh MXH → Kết nối kênh mới → Chọn Instagram

2

Đăng nhập Facebook → Chọn Instagram Account

Instagram dùng xác thực qua Facebook. Chọn tài khoản IG Business muốn kết nối.

AI bắt đầu trả lời DM Instagram

Tích hợp Lazada / Shopee / TikTok Shop

AI trả lời chat từ người mua trên sàn thương mại điện tử

Các sàn này yêu cầu nhập token thủ công (không có 1-click connect như Facebook/Zalo), và bạn cần tự đăng ký tài khoản Đối tác/App riêng với sàn trước khi có token. Thực hiện như sau:

1

Đăng ký làm Đối tác/ISV tại Open Platform của sàn (Shopee Open Platform, Lazada Open Platform, TikTok Shop Partner Center) → chờ duyệt hồ sơ

2

Sau khi được duyệt, tạo App và lấy Access Token cho shop của bạn

3

Vào Kênh MXH → Kết nối kênh mới → chọn nền tảng tương ứng → Nhập thủ công token

Cần hỗ trợ thiết lập Shopee/Lazada/TikTok Shop? Liên hệ bộ phận hỗ trợ để được tư vấn.

Gỡ kết nối chatbot

Tắt AI hoặc xóa kênh khi không cần dùng nữa

Tạm dừng AI

Vào Kênh MXH → chọn kênh → toggle "AI OFF". Bạn vẫn có thể bật lại bất kỳ lúc nào.

Xóa kênh

Vào Kênh MXH → chọn kênh → Chỉnh sửa → cuối trang nhấn "Xóa kênh". Thao tác không thể hoàn tác.

Sau khi xóa kênh Facebook, AI sẽ ngừng nhận tin nhắn ngay lập tức. Webhook vẫn được giữ nguyên trên hệ thống nhưng không xử lý.

Hộp thư & Inbox

Xem và quản lý tất cả hội thoại từ một nơi

Inbox gộp — Hộp thư đến

Tất cả tin nhắn từ Facebook, Zalo, Instagram... đổ về một hộp thư duy nhất tại /client/social/inbox. Lọc theo kênh, trạng thái (mới, đang xử lý, đã chốt, leo thang, đóng).

Tag & Ghi chú

Gắn tag cho từng khách: mới đang xử đã chốt leo thang đóng. Thêm ghi chú nội bộ không hiển thị cho khách.

Thông tin khách hàng

AI tự động trích xuất SĐT và email từ hội thoại, lưu vào hồ sơ khách. Xem lịch sử đầy đủ mọi cuộc trò chuyện.

Human Takeover — Tiếp quản thủ công

Tắt AI và tự trả lời khi cần xử lý tình huống phức tạp

Cách bật Takeover

Vào Inbox → mở hội thoại → nhấn nút "AI ⇄ Nhân viên" ở góc phải. AI tự động dừng, bạn trả lời trực tiếp trong 1-8 tiếng tuỳ chọn.

Trả lại cho AI

Bấm lại đúng nút đó để tắt tiếp quản bất cứ lúc nào — không cần đợi hết giờ. Bot tiếp tục hoạt động tự động ngay.

Auto-escalation

Nếu AI thất bại trả lời 3 lần liên tiếp, hệ thống tự động chuyển sang trạng thái Takeover (1 tiếng) và gắn tag "leo thang". Tránh để khách chờ đợi.

Tin nhắn Marketing / Broadcast

Gửi tin nhắn hàng loạt đến tất cả khách hàng đã từng nhắn tin

1

Vào Kênh MXH → chọn kênh → Broadcast

2

Tạo chiến dịch mới

Đặt tên chiến dịch, chọn đối tượng (tất cả hoặc theo tag), đặt lịch gửi hoặc gửi ngay.

3

Soạn nội dung tin nhắn

Tin nhắn text, kèm link hoặc hình ảnh. Xem trước trước khi gửi.

4

Theo dõi kết quả

Xem số tin đã gửi, thành công, thất bại. Xem phản hồi của từng người nhận.

Lưu ý chính sách

Facebook chỉ cho phép gửi tin nhắn marketing trong 24 giờ sau lần tương tác cuối của người dùng (quy định của nền tảng Messenger, không phải giới hạn riêng của hệ thống). Ngoài khung này cần dùng Message Tag được Facebook phê duyệt.

Hạn mức sử dụng

Mỗi gói có giới hạn số tin nhắn/tháng và các tính năng đi kèm khác nhau

Gói Tin nhắn/tháng
Trial (dùng thử)100
Basic5.000
Professional50.000
EnterpriseKhông giới hạn

Số liệu ở trên có thể thay đổi theo thời gian — xem bảng so sánh đầy đủ và luôn cập nhật (Widget Chat, Kênh MXH, Webhook/API, Custom thương hiệu, Huấn luyện AI...) trực tiếp tại trang đăng ký. Theo dõi hạn mức thực tế đang dùng trong Dashboard → phần Sử dụng tháng này.

Nâng cấp gói

Mở khóa thêm tính năng và tăng hạn mức

1

Vào trang đăng ký để xem chi tiết các gói

2

Chọn gói phù hợp và phương thức thanh toán

3

Thanh toán qua chuyển khoản / MoMo / VNPay / USDT (tuỳ phương thức đang bật)

Tính năng mới được kích hoạt sau khi thanh toán được xác nhận

Lịch sử giao dịch

Xem tất cả hóa đơn và lịch sử thanh toán

Vào Cài đặt trong menu để xem thông tin tài khoản và gói dịch vụ hiện tại. Mỗi giao dịch đăng ký/gia hạn được ghi nhận với ngày, số tiền, gói dịch vụ, trạng thái thanh toán.

Quyền quản trị tài khoản

Phân quyền cho nhân viên trong team

Owner

Toàn quyền: cấu hình, thanh toán, thêm/xóa thành viên

Admin

Quản lý chatbot, kênh, huấn luyện AI. Không thể thanh toán hoặc xóa tài khoản

Agent

Chỉ xem và trả lời tin nhắn trong Inbox. Không thể thay đổi cấu hình

API Reference

Dành cho developer tích hợp trực tiếp không qua widget

POST /chat

Gửi tin nhắn và nhận phản hồi từ AI

Request
const response = await fetch('https://hani.io.vn/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    message: 'Giá hosting bao nhiêu?',
    session_id: 'user-123'      // ID phiên chat (tuỳ chọn)
  })
});
const data = await response.json();
Response
{
  "success": true,
  "response": "Gói hosting cơ bản giá 50.000đ/tháng...",
  "session_id": "user-123"
}
GET /widget-config

Lấy cấu hình widget (màu sắc, tên bot, tin nhắn chào...)

Request
const config = await fetch('https://hani.io.vn/widget-config', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}).then(r => r.json());

Widget JavaScript

Tùy chỉnh nâng cao cho widget chat trên website

Cấu hình đầy đủ

Các giá trị này chỉ là mặc định ban đầu khi chưa cấu hình gì trong Cài đặt Widget — nếu bạn đã lưu cài đặt trong Dashboard, hệ thống tự lấy config đó về, không cần khai báo lại ở đây.

chatbot-widget.js config
<script>
window.ChatAPIConfig = {
  apiUrl:         'https://hani.io.vn',
  apiKey:         'YOUR_API_KEY',
  position:       'bottom-right',   // bottom-right | bottom-left
  primaryColor:   '#00601e',        // Màu chủ đạo (cần gói có Custom thương hiệu để đổi)
  botName:        'Trợ lý AI',      // Tên bot hiển thị
  welcomeMessage: 'Xin chào! Mình có thể giúp gì cho bạn?',
  zIndex:         9999,
};
</script>
<script src="https://hani.io.vn/js/chatbot-widget.js"></script>

Widget hiện chưa có API JavaScript để điều khiển từ bên ngoài (mở/đóng/gửi tin nhắn bằng code) — widget tự quản lý hoàn toàn qua nút bấm trên giao diện.