chell-ai
v0.1.0
Published
Widget chat customer-facing untuk Chell AI — Voice of Customer Platform. Pasang chat bot di website Anda dengan satu komponen React.
Maintainers
Readme
chell-ai
Widget chat customer-facing untuk Chell AI — Voice of Customer Platform. Pasang chat bot di website Anda secepat install library biasa.
Instalasi
npm install chell-aiPemakaian
Tambahkan ke layout utama situs Anda (Next.js, atau React project apapun):
import { ChellWidget } from "chell-ai";
export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<ChellWidget businessId="chell_pk_xxxxxxxxxxxx" />
</body>
</html>
);
}Widget akan muncul sebagai bubble chat mengambang di pojok kanan bawah halaman.
Dapatkan businessId (widget key publik) dari dashboard Chell AI Anda — menu Widget Chat.
Catatan untuk pengguna Next.js App Router: komponen ini sudah otomatis di-tandai
"use client"saat di-build, jadi Anda TIDAK perlu menambahkan"use client"sendiri di file layout Anda, walaupun layout tersebut adalah Server Component.
Props
| Prop | Tipe | Wajib | Default | Keterangan |
|---|---|---|---|---|
| businessId | string | Ya | — | Widget key publik dari dashboard Chell AI (bukan business_id internal) |
| baseUrl | string | Tidak | https://chell-ai.app | Override domain backend, jarang perlu diubah |
| position | "bottom-right" \| "bottom-left" | Tidak | "bottom-right" | Posisi bubble di layar |
Konfigurasi via environment variable (opsional)
Kalau Anda lebih suka menyimpan businessId di .env daripada hardcode di JSX:
<ChellWidget businessId={process.env.NEXT_PUBLIC_CHELL_BUSINESS_ID!} />Cara Kerja
Widget ini SENGAJA sangat ringan — cuma tombol bubble yang menampilkan/menyembunyikan sebuah <iframe> yang me-load halaman chat dari domain Chell AI. Keuntungan pendekatan ini:
- Isolasi CSS total — style situs Anda (Tailwind, Bootstrap, CSS custom apapun) tidak akan bentrok dengan widget, dan sebaliknya.
- Tidak ada masalah CORS — semua request API terjadi dari dalam iframe (domain Chell AI), bukan dari domain situs Anda.
- Update otomatis — perbaikan/fitur baru di sisi chat di-deploy di backend Chell AI; instalasi widget Anda otomatis dapat update tanpa perlu
npm update.
Lisensi
MIT
