Một dòng mã cho website, URL cho WebView trong ứng dụng di động, REST API cho hệ thống riêng của bạn.
Lấy mã nhúng trong trang quản trị → Trợ lý → Kênh. Khoá công khai pk_… chỉ hoạt động trên các tên miền bạn khai báo, nên đặt trong mã nguồn website là an toàn.
<!-- Supporter widget --> <script src="https://app.supporter.vn/widget.js" data-key="pk_live_xxxxxxxxxxxx" data-position="bottom-right" data-user-id="A-1203" <!-- tuỳ chọn --> async></script>
Xác thực bằng khoá bí mật sk_… từ máy chủ của bạn. Kết quả trả về dạng JSON, hoặc streaming (SSE) để hiện chữ dần như chat.
Mỗi hội thoại gắn với một người hỏi qua visitor.externalId (vd mã căn hộ, mã khách hàng) và meta tuỳ ý.
curl https://api.supporter.vn/v1/chat \ -H "Authorization: Bearer sk_live_…" \ -H "Content-Type: application/json" \ -d '{ "message": "Phí gửi xe máy bao nhiêu?", "visitor": { "externalId": "A-1203" }, "stream": false }'
const res = await fetch('https://api.supporter.vn/v1/chat', { method: 'POST', headers: { Authorization: `Bearer ${process.env.SUPPORTER_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ message, visitor: { externalId } }), }); const { answer, sources, conversationId } = await res.json();
{
"conversationId": "6f1c…",
"answer": "Phí gửi xe máy là 120.000đ/xe/tháng…",
"answerSource": "faq",
"sources": [
{ "title": "Biểu phí dịch vụ 2026", "page": 2 }
],
"handoff": false
}
Mở trang chat toàn màn hình bằng một URL; truyền mã người dùng để trợ lý nhớ hội thoại giữa các lần mở app. Phù hợp app React Native, Flutter, Swift, Kotlin.
https://app.supporter.vn/c/pk_live_…?user=A-1203
Dựng giao diện chat theo thiết kế của app, gọi /v1/chat qua máy chủ của bạn (không đặt khoá bí mật trong app). Hỗ trợ streaming để hiển thị chữ dần.
handoff để mở màn hình liên hệ nhân viênAPI đang mở thử nghiệm cho khách hàng sớm. Liên hệ để nhận khoá và tài liệu đầy đủ.
Dùng thử miễn phí, không cần thẻ thanh toán. Chúng tôi hỗ trợ đưa tài liệu và thiết lập trợ lý đầu tiên cùng bạn.