Ikhtisar

Apa ini?

Platform AI Agen Dukungan Pelanggan menyediakan API untuk membangun agen yang didorong percakapan dan widget yang dapat disematkan yang dapat ditempatkan di situs web. Arsitektur tipikal memisahkan kode server yang membawa rahasia dari kode browser dengan mengeluarkan token widget yang memiliki masa hidup pendek.

The Companin Widget is more than just a chat interface—it's a complete conversational AI platform that seamlessly integrates into your website. Built with modern web technologies (Next.js, React, TypeScript), it provides enterprise-grade reliability while maintaining simplicity for developers.

Unlike traditional chat widgets that require complex backend setup, Companin handles all the infrastructure for you. Authentication, message storage, conversation management, and AI processing are all managed through our secure API, allowing you to focus on creating great user experiences.

Konsep Inti

Memahami konsep inti ini akan membantu Anda memanfaatkan Widget Companin sebaik-baiknya:

• Agen: agen percakapan yang dikonfigurasi.
• Sesi: konteks sementara untuk pengunjung yang berinteraksi dengan agen.
• Token widget: JWT yang memiliki masa hidup pendek untuk mengautentikasi widget di browser.
• Auth: JWT atau pasangan header kunci API (X-API-Key + X-API-Secret).

Cara kerjanya (tingkat tinggi)

1. Server menyimpan rahasia klien dan menukarnya dengan token widget yang memiliki masa hidup pendek melalui /api/v1/auth/widget-token.
2. Browser menerima token dan menginisialisasi widget; widget menggunakan token untuk memanggil endpoint API.
3. Endpoint sisi server menerima JWT atau pasangan header kunci API dan menerapkan batas laju tingkat organisasi.

Langkah selanjutnya

Ikuti Quickstart untuk menyematkan widget, lalu konsultasikan Referensi API untuk detailnya.