Dokumentasi — Wicara.ai

Mulai

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.

Tier menentukan biaya kredit per pesan: Base 1×, Plus 4×, Premium 10×.

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

Salin satu baris skrip dari tab Embed agen, tempel sebelum tag penutup body:

<script src="https://cdn.wicara.ai/w.js" data-agent="aether-cs"></script>

Dokumentasi API

Autentikasi

Semua request API butuh API key di header. Buat key dari konsol agen → tab API Keys.

Authorization: Bearer wcr_live_xxxxxxxxxxxx

Kirim Pesan

POST/v1/agents/{agent_id}/messages

# Contoh cURL
curl https://api.wicara.ai/v1/agents/aether-cs/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.
stream	boolean	Aktifkan streaming token. Default false.

Webhook

Daftarkan URL webhook untuk menerima event message.created, handoff.requested, dan credit.low secara real-time.

Reference

Endpoints

Method	Endpoint	Fungsi
GET	/v1/agents	Daftar agen
POST	/v1/agents/{id}/messages	Kirim pesan
GET	/v1/conversations	Riwayat percakapan
POST	/v1/agents/{id}/resources	Tambah pengetahuan

Rate Limit

Default 60 request/menit per key (bisa diatur). Response menyertakan header X-RateLimit-Remaining.

Kode Error

Kode	Arti
401	API key tidak valid
402	Kredit habis — lakukan top-up
429	Melebihi rate limit