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

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:

<!-- Wicara.ai widget -->
<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://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" }'
ParameterTipeKeterangan
messagestringPesan dari pengguna. Wajib.
session_idstringID sesi untuk menjaga konteks percakapan.
conversation_idstringLanjutkan 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.

Reference

Endpoints

MethodEndpointFungsi
GET/v1/agentsDaftar agen
POST/v1/agents/{id}/messagesKirim pesan
POST/v1/messagesKirim 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

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