Tài liệu

Tài liệu Chat Tự Động

Mọi thứ cần để tích hợp Chat Tự Động vào sản phẩm của bạn — từ một dòng nhúng widget cho tới gọi thẳng model qua endpoint tương thích OpenAI.

Ba cách dùng, chọn đúng cái bạn cần

Đọc tài liệu mà không biết mình thuộc nhóm nào thì rất dễ lạc. Trước khi bấm vào mục nào, hãy xác định bạn đang muốn làm gì:

Muốn có bot trả lời khách, không viết code: Vào dashboard tạo trợ lý, nạp tài liệu, bấm kết nối kênh. Xem Quickstart — phần đầu không có dòng code nào.
Muốn gọi model từ backend của mình: Tạo API key rồi trỏ SDK OpenAI sẵn có vào https://api.chattudong.com/v1. Xem SDK & thư viện và API Reference.
Muốn nhúng chat vào website: Tạo kênh loại web_widget, khai danh sách domain được phép nhúng, rồi dán một thẻ <script>. Chi tiết ở cuối trang Quickstart.

Mục lục

Bắt đầu ở đây

Quickstart

Đi hết một vòng: đăng ký, tạo trợ lý, nạp kho kiến thức, kết nối kênh và nhắn thử. Làm theo là bot trả lời khách thật.

Đọc tiếp Tra cứu

API Reference

Danh sách model, gọi chat completions (có SSE), cách xác thực bằng API key, hình dạng lỗi và bảng mã lỗi đầy đủ.

Đọc tiếp Chi phí

BYOK — khoá provider riêng

Đã có tài khoản OpenAI/Anthropic/Google/xAI? Dán khoá vào và chúng tôi không tính phí model. Khoá được mã hoá envelope AES-256-GCM.

Đọc tiếp Tích hợp kênh

Webhooks

Mỗi nền tảng ký request một kiểu. Trang này ghi rõ ta xác thực thế nào cho Telegram, Meta, Zalo OA, Shopee và TikTok Shop.

Đọc tiếp Thư viện

SDK & thư viện

Chưa có SDK riêng và bạn cũng không cần: đổi baseURL của thư viện OpenAI chính thức là dùng được ngay, cả Node lẫn Python.

Đọc tiếp Lịch sử

Changelog

Những gì đã lên: gateway LLM, ví và thanh toán, agent + RAG, các kênh nhắn tin, dashboard.

Đọc tiếp

Gọi thử trong 30 giây

Nếu bạn chỉ muốn xem nó có thật không: tạo API key trong Cài đặt → Khoá API của dashboard rồi chạy lệnh dưới đây. Endpoint nhận đúng định dạng OpenAI nên mọi thư viện sẵn có đều hiểu.

Terminal

curl https://api.chattudong.com/v1/chat/completions \
  -H "Authorization: Bearer $CHATLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "local/gemma-3-12b",
    "messages": [{"role": "user", "content": "Chào bạn"}]
  }'

Danh sách model dùng được lấy từ GET /v1/models — đừng đoán tên model, mỗi tổ chức có thể bật những model khác nhau.

Vài nguyên tắc xuyên suốt

Mọi lỗi cùng một hình dạng. Bất kể endpoint nào, thân lỗi luôn là { error: { code, message, requestId } }. Mã lỗi ổn định, đổi tên mã là breaking change nên bạn switch-case được yên tâm.
Bí mật chỉ hiện một lần. API key và khoá BYOK đều không xem lại được. Mất thì tạo cái mới — vì nếu chúng tôi cho xem lại thì người chiếm được database cũng xem lại được.
Chữ ký webhook tính trên body thô. Đây là chỗ sai nhiều nhất khi tự dựng lại, nói kỹ ở trang webhooks.
Trả trước, hết thì dừng. Hết credits API trả 402 insufficient_credits chứ không âm thầm ghi nợ.

Cần người thật?

Tài liệu thiếu chỗ nào, hoặc bạn gặp lỗi không hiểu, gửi cho chúng tôi error.requestId trong phản hồi lỗi — có mã đó là tra được đúng dòng log của request đó.

Email hỗ trợ: chattudongcskh@gmail.com. Vấn đề bảo mật xin gửi riêng về chattudongcskh@gmail.com.