Panduan Cepat
Bikin AI Assistant pertamamu dan pasang di website dalam 5 menit.
1. Buat agen
Dari dasbor, klik Buat Agen. Pilih tier model (Base untuk FAQ, Plus untuk umum, Premium untuk reasoning kompleks), beri nama, dan tulis deskripsi peran agen.
2. Tambah pengetahuan
Latih agen dari sumber datamu — URL, sitemap, file (PDF/DOCX), atau teks manual. Wicara mengubahnya jadi embeddings agar agen menjawab akurat.
- URL / Sitemap — crawl otomatis halaman webmu
- File — unggah katalog, SOP, atau FAQ
- Teks manual — tempel info penting langsung
3. Pasang di website
Belum tersedia. Skrip widget belum dirilis. Untuk sekarang, hubungkan agen lewat API di bawah — itu yang dipakai integrasi WhatsApp. Bentuk skripnya nanti kira-kira begini:
<script src="https://cdn.wicara.ai/w.js" data-agent="aether-cs"></script>
Autentikasi
Semua request API butuh API key di header. Buat key dari konsol agen → tab API Keys.
Kirim Pesan
curl https://wicaraai.netbiz.id/v1/agents/{agent_id}/messages \
-H "Authorization: Bearer wcr_live_•••" \
-H "Content-Type: application/json" \
-d '{ "message": "Kaos hitam ukuran M ada?", "session_id": "u_8821" }'
| Parameter | Tipe | Keterangan |
|---|---|---|
| message | string | Pesan dari pengguna. Wajib. |
| session_id | string | ID sesi untuk menjaga konteks percakapan. |
| conversation_id | string | Lanjutkan percakapan tertentu. Opsional — biasanya cukup session_id. |
Webhook
Belum tersedia. Saat ini integrasi berjalan satu arah: kirim pesan, terima balasan pada response yang sama. Notifikasi event ke URL Anda sedang dalam rencana.
ReferenceEndpoints
| Method | Endpoint | Fungsi |
|---|---|---|
| GET | /v1/agents | Daftar agen |
| POST | /v1/agents/{id}/messages | Kirim pesan |
| POST | /v1/messages | Kirim pesan ke agen pemilik API key — tanpa menyebut ID agen |
Rate Limit
120 request/menit per API key. Widget publik dibatasi 30 pesan/menit per alamat IP. Response menyertakan header X-RateLimit-Remaining; kalau terlampaui, balasannya 429.
Kode Error
| Kode | Arti |
|---|---|
| 401 | API key tidak valid |
| 402 | Kredit habis — lakukan top-up |
| 429 | Melebihi rate limit |