Pusat Bantuan & Referensi Teknis

Dokumentasi

Panduan lengkap arsitektur, integrasi widget website, pelatihan basis pengetahuan bisnis, dan spesifikasi API Obrool.

1. Quickstart (Memulai Cepat)2. Basis Pengetahuan & RAG 3. Embed Widget & Iframe 4. Integrasi Multi-Channel 5. Kunci API Sendiri 6. Kebijakan Keamanan & FUP

1. Quickstart (Memulai Cepat)

Membangun dan meluncurkan AI Agent di Obrool dapat diselesaikan dalam 3 tahapan terstruktur tanpa perlu setup infrastruktur cloud:

Langkah 1: Tentukan Konsep di Sandbox atau Template

Gunakan menu Sandbox untuk meracik prompt khusus dengan bantuan AI, atau pilih template yang sesuai di marketplace (Customer Service, Sales, HR, IT Support).

Langkah 2: Lengkapi Basis Pengetahuan (Knowledge Base)

Di halaman konfigurasi agent, unggah dokumen PDF katalog, tautkan link website resmi, atau masukkan daftar pertanyaan & jawaban resmi agar AI memahami konteks bisnis.

Langkah 3: Uji di Training Playground & Deploy

Gunakan Training Playground untuk menguji alur percakapan. Lakukan koreksi respon jika diperlukan, lalu klik Deploy Agent untuk mengaktifkannya.

2. Basis Pengetahuan (Knowledge Base & RAG)

Obrool menerapkan arsitektur Retrieval-Augmented Generation (RAG) dengan pembersihan teks mendalam (*chunking & sanitization*) untuk menyuplai konteks yang akurat ke model bahasa.

Format Sumber Data yang Didukung:

Dokumen PDF

Katalog harga, SOP, panduan teknis, atau dokumen hukum (maksimal 10MB per file).

Web Scraper URL

Ekstraksi otomatis artikel website, FAQ daring, atau laman landing produk.

Teks Bebas / SOP

Instruksi spesifik, promo mingguan, atau aturan penanganan komplain.

Pasangan Tanya-Jawab (Q&A)

Jawaban presisi untuk pertanyaan spesifik pelanggan guna mencegah halusinasi.

Fitur Active Learning (Koreksi Respon Langsung)

Di Training Playground, pemilik agent dapat menekan tombol Koreksi Respon pada bubble jawaban yang ingin diperbaiki. Jawaban koreksi akan langsung disimpan ke basis data Q&A secara instan.

3. Menyematkan Widget ke Website

Integrasikan AI Agent ke platform website apa pun (WordPress, Shopify, Webflow, React, Vue, Next.js, atau HTML statis) menggunakan skrip embed ringan.

A. Floating Chat Bubble

Tambahkan 1 baris skrip berikut sebelum tag penutup </body> pada file template HTML website Anda:

html

<script src="https://obrool.com/widget.js" data-agent-id="ID_AGENT_ANDA" defer></script>

B. Inline Iframe Chatbox

Gunakan elemen iframe berikut jika ingin menampilkan kotak chat langsung di dalam tata letak halaman:

html

<iframe src="https://obrool.com/play/ID_AGENT_ANDA?embed=1" width="100%" height="600" style="border:none; border-radius:16px;"></iframe>

Atribut Konfigurasi Tag Script:

data-agent-id: ID unik agent dari dashboard (Wajib)

data-color: Kustom kode warna hex (Opsional, contoh: #0a0a0b)

data-position: Penempatan floating button (Opsional: right atau left)

4. Integrasi Multi-Channel (Telegram, WhatsApp & Slack)

Hubungkan satu AI Agent yang sama ke kanal pesan resmi agar dapat merespons pelanggan secara otomatis 24/7 di berbagai saluran bisnis Anda.

Telegram Bot

Buka Telegram dan cari akun resmi @BotFather.
Ketik perintah /newbot, lalu ikuti panduan untuk menentukan nama dan username bot Anda.
Salin HTTP API Token yang diberikan oleh BotFather (contoh: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).
Di Obrool, buka halaman Kelola Agent → tab Konfigurasi & Knowledge → bagian Integrasi Kanal Pesan (Telegram).
Masukkan token tersebut, lalu klik Hubungkan ke Telegram. Sistem akan mendaftarkan webhook secara otomatis dan bot langsung siap digunakan.

WhatsApp Gateway (Wablas, Fonnte, dll)

Obrool mendukung integrasi WhatsApp bisnis melalui penyedia WhatsApp Gateway berbasis API (seperti Wablas, Fonnte, atau gateway pihak ketiga yang kompatibel). Alur integrasi terdiri dari 2 langkah mudah:

Langkah A: Masukkan Kredensial Gateway di Obrool

Buka dashboard penyedia WhatsApp gateway Anda (misal: Wablas / Fonnte) dan pastikan nomor WhatsApp bisnis Anda telah terhubung via Scan QR.
Salin API Send Message Endpoint dan API Token / Secret Key akun gateway Anda.
Di Obrool, buka halaman Kelola Agent → tab Konfigurasi & Knowledge → bagian Integrasi Kanal Pesan → pilih tab WhatsApp.
Isi formulir yang tersedia:
- WhatsApp Gateway Endpoint: URL endpoint kirim pesan (contoh: https://api.wablas.com/api/send-message).
- API Token Gateway: Token otentikasi dari provider WhatsApp Anda.
- Nomor Pengirim / Pengujian: Nomor WhatsApp terdaftar Anda (contoh: 081234567890).
Klik Hubungkan ke WhatsApp, lalu tekan tombol Uji Koneksi untuk memverifikasi bahwa pesan tes berhasil terkirim ke WhatsApp Anda.

Langkah B: Atur Webhook Masuk (Auto-Reply 24/7)

Agar AI Agent dapat merespons pesan masuk dari pelanggan secara instan, daftarkan Webhook Callback Obrool di menu pengaturan Webhook dashboard provider WhatsApp Anda:

Target URL Webhook Obrool:

https://obrool.com/api/channels/webhook

Setiap ada chat masuk dari pelanggan ke nomor WhatsApp Anda, gateway akan meneruskannya ke Obrool, diproses oleh AI sesuai basis pengetahuan, dan dijawab kembali ke pelanggan secara otomatis!

Slack Incoming Webhook

Buat Incoming Webhook di aplikasi Slack Workspace Anda.
Salin Webhook URL yang dihasilkan (contoh: https://hooks.slack.com/services/...).
Di Obrool, pilih tab Slack pada Integrasi Kanal Pesan, masukkan URL webhook, lalu klik Hubungkan ke Slack.

5. Integrasi Kunci API Sendiri & Keamanan Enkripsi

Pengguna yang ingin percakapan tanpa batas kuota dapat menghubungkan Kunci API OpenAI atau Anthropic milik sendiri.

Standar Enkripsi AES-256-GCM

Seluruh Kunci API yang disimpan dienkripsi secara simetris dengan algoritma AES-256-GCM sebelum masuk ke basis data. Kunci hanya didekripsi pada memori server saat mengeksekusi inferensi model AI.

6. Kebijakan Keamanan & Fair Usage (FUP)

Untuk menjaga stabilitas performa dan keamanan seluruh pengguna, Obrool menerapkan aturan Fair Usage Policy berikut:

Geser tabel ke samping untuk melihat →

Komponen	Batasan FUP	Tindakan Sistem
Penyimpanan Dokumen	Maksimal 15 dokumen / 10MB per file	Menolak penambahan file baru sebelum file lama dihapus.
Retensi Riwayat Chat	90 Hari	Pembersihan berkala otomatis di latar belakang.
Anti-Spam Pengunjung	30 pesan / 10 menit per IP	Jeda sementara untuk mencegah serangan bot.
Filter Konten Berbahaya	Anti-Judol, Phishing, & Pornografi	Blokir scraping URL seketika dengan status 422.

1. Quickstart (Memulai Cepat)

Membangun dan meluncurkan AI Agent di Obrool dapat diselesaikan dalam 3 tahapan terstruktur tanpa perlu setup infrastruktur cloud:

Langkah 1: Tentukan Konsep di Sandbox atau Template

Gunakan menu Sandbox untuk meracik prompt khusus dengan bantuan AI, atau pilih template yang sesuai di marketplace (Customer Service, Sales, HR, IT Support).

Langkah 2: Lengkapi Basis Pengetahuan (Knowledge Base)

Di halaman konfigurasi agent, unggah dokumen PDF katalog, tautkan link website resmi, atau masukkan daftar pertanyaan & jawaban resmi agar AI memahami konteks bisnis.

Langkah 3: Uji di Training Playground & Deploy

Gunakan Training Playground untuk menguji alur percakapan. Lakukan koreksi respon jika diperlukan, lalu klik Deploy Agent untuk mengaktifkannya.

2. Basis Pengetahuan (Knowledge Base & RAG)

Obrool menerapkan arsitektur Retrieval-Augmented Generation (RAG) dengan pembersihan teks mendalam (*chunking & sanitization*) untuk menyuplai konteks yang akurat ke model bahasa.

Format Sumber Data yang Didukung:

Dokumen PDF

Katalog harga, SOP, panduan teknis, atau dokumen hukum (maksimal 10MB per file).

Web Scraper URL

Ekstraksi otomatis artikel website, FAQ daring, atau laman landing produk.

Teks Bebas / SOP

Instruksi spesifik, promo mingguan, atau aturan penanganan komplain.

Pasangan Tanya-Jawab (Q&A)

Jawaban presisi untuk pertanyaan spesifik pelanggan guna mencegah halusinasi.

Fitur Active Learning (Koreksi Respon Langsung)

Di Training Playground, pemilik agent dapat menekan tombol Koreksi Respon pada bubble jawaban yang ingin diperbaiki. Jawaban koreksi akan langsung disimpan ke basis data Q&A secara instan.

3. Menyematkan Widget ke Website

Integrasikan AI Agent ke platform website apa pun (WordPress, Shopify, Webflow, React, Vue, Next.js, atau HTML statis) menggunakan skrip embed ringan.

A. Floating Chat Bubble

Tambahkan 1 baris skrip berikut sebelum tag penutup </body> pada file template HTML website Anda:

html

<script src="https://obrool.com/widget.js" data-agent-id="ID_AGENT_ANDA" defer></script>

B. Inline Iframe Chatbox

Gunakan elemen iframe berikut jika ingin menampilkan kotak chat langsung di dalam tata letak halaman:

html

<iframe src="https://obrool.com/play/ID_AGENT_ANDA?embed=1" width="100%" height="600" style="border:none; border-radius:16px;"></iframe>

Atribut Konfigurasi Tag Script:

data-agent-id: ID unik agent dari dashboard (Wajib)

data-color: Kustom kode warna hex (Opsional, contoh: #0a0a0b)

data-position: Penempatan floating button (Opsional: right atau left)

4. Integrasi Multi-Channel (Telegram, WhatsApp & Slack)

Hubungkan satu AI Agent yang sama ke kanal pesan resmi agar dapat merespons pelanggan secara otomatis 24/7 di berbagai saluran bisnis Anda.

Telegram Bot

Buka Telegram dan cari akun resmi @BotFather.
Ketik perintah /newbot, lalu ikuti panduan untuk menentukan nama dan username bot Anda.
Salin HTTP API Token yang diberikan oleh BotFather (contoh: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).
Di Obrool, buka halaman Kelola Agent → tab Konfigurasi & Knowledge → bagian Integrasi Kanal Pesan (Telegram).
Masukkan token tersebut, lalu klik Hubungkan ke Telegram. Sistem akan mendaftarkan webhook secara otomatis dan bot langsung siap digunakan.

WhatsApp Gateway (Wablas, Fonnte, dll)

Langkah A: Masukkan Kredensial Gateway di Obrool

Buka dashboard penyedia WhatsApp gateway Anda (misal: Wablas / Fonnte) dan pastikan nomor WhatsApp bisnis Anda telah terhubung via Scan QR.
Salin API Send Message Endpoint dan API Token / Secret Key akun gateway Anda.
Di Obrool, buka halaman Kelola Agent → tab Konfigurasi & Knowledge → bagian Integrasi Kanal Pesan → pilih tab WhatsApp.
Isi formulir yang tersedia:
- WhatsApp Gateway Endpoint: URL endpoint kirim pesan (contoh: https://api.wablas.com/api/send-message).
- API Token Gateway: Token otentikasi dari provider WhatsApp Anda.
- Nomor Pengirim / Pengujian: Nomor WhatsApp terdaftar Anda (contoh: 081234567890).
Klik Hubungkan ke WhatsApp, lalu tekan tombol Uji Koneksi untuk memverifikasi bahwa pesan tes berhasil terkirim ke WhatsApp Anda.

Langkah B: Atur Webhook Masuk (Auto-Reply 24/7)

Agar AI Agent dapat merespons pesan masuk dari pelanggan secara instan, daftarkan Webhook Callback Obrool di menu pengaturan Webhook dashboard provider WhatsApp Anda:

Target URL Webhook Obrool:

https://obrool.com/api/channels/webhook

Setiap ada chat masuk dari pelanggan ke nomor WhatsApp Anda, gateway akan meneruskannya ke Obrool, diproses oleh AI sesuai basis pengetahuan, dan dijawab kembali ke pelanggan secara otomatis!

Slack Incoming Webhook

Buat Incoming Webhook di aplikasi Slack Workspace Anda.
Salin Webhook URL yang dihasilkan (contoh: https://hooks.slack.com/services/...).
Di Obrool, pilih tab Slack pada Integrasi Kanal Pesan, masukkan URL webhook, lalu klik Hubungkan ke Slack.

5. Integrasi Kunci API Sendiri & Keamanan Enkripsi

Pengguna yang ingin percakapan tanpa batas kuota dapat menghubungkan Kunci API OpenAI atau Anthropic milik sendiri.

Standar Enkripsi AES-256-GCM

6. Kebijakan Keamanan & Fair Usage (FUP)

Untuk menjaga stabilitas performa dan keamanan seluruh pengguna, Obrool menerapkan aturan Fair Usage Policy berikut:

Geser tabel ke samping untuk melihat →

Komponen	Batasan FUP	Tindakan Sistem
Penyimpanan Dokumen	Maksimal 15 dokumen / 10MB per file	Menolak penambahan file baru sebelum file lama dihapus.
Retensi Riwayat Chat	90 Hari	Pembersihan berkala otomatis di latar belakang.
Anti-Spam Pengunjung	30 pesan / 10 menit per IP	Jeda sementara untuk mencegah serangan bot.
Filter Konten Berbahaya	Anti-Judol, Phishing, & Pornografi	Blokir scraping URL seketika dengan status 422.