Tài liệu Avatin

Nền tảng Avatin gồm ba lớp: Studio (tạo, cấu hình, xuất bản agent), Core API (REST + webhook) và Agent runtime (hội thoại real-time: STT → LLM → TTS → avatar). Tài liệu này dành cho người tích hợp — người tạo agent không cần đọc, Studio tự hướng dẫn.

Chọn điểm bắt đầu

Widget — 1 dòng script Nhúng avatar vào website không cần backend giữ token riêng ngoài một route nhỏ.

SDK Web — kiểm soát giao diện Dùng `@avatin/sdk-web` để xây trải nghiệm hội thoại riêng trong app của bạn.

REST API — server-to-server Cấp session token bằng API key, nhận sự kiện qua webhook ký HMAC.

Ba mức tích hợp

Mức	Dùng khi	Giao diện do ai vẽ
Không code	Chia sẻ link hosted + QR cho khách	Avatin (hosted page)
Ít code	Nhúng widget vào website	Avatin (widget, token ghi đè được)
Tích hợp sâu	App native/web riêng, hành động nghiệp vụ	Bạn (SDK/API)

Ba nguyên tắc bảo mật mặc định

1. API key không bao giờ nằm ở trình duyệt. Backend của bạn giữ key avk_… và cấp session token ES256 dùng một lần (TTL 10 phút).
2. Token được kiểm tra origin khi đổi. Core API kiểm tra trang nhúng theo allowlist của agent trước khi tiêu token.
3. Sự kiện hợp nhất. Cùng tên sự kiện cho SDK, widget và webhook (session.ended, lead.created, handoff.requested) — không phải dịch bản giữa các kênh.

Bắt đầu nhanh nhất: Quickstart widget.