Aksita.ai Logo Dokumentasi

Kirim Pesan

Mengirim pesan user ke agent dalam sesi tertentu. Agent akan memproses pesan, mengambil konteks relevan dari knowledge base Anda, dan menghasilkan response.

HTTP Request
POST /api/chat

Parameter Request

ParameterTipeWajibDeskripsi
messagestringYaPesan teks yang akan dikirim ke agent.
conversation_idstringYaID sesi unik yang dikembalikan oleh endpoint Create Session.
additional_contextstringTidakKonteks opsional tentang user, akun, atau situasi (mis. metadata user, info paket, status akun). Ini membantu agent memberikan response yang lebih personal.

Konteks Tambahan (Opsional)

Parameter additional_context memungkinkan Anda mengirim informasi spesifik user (metadata, status akun, detail paket, dll.) yang dapat digunakan agent untuk memberikan response yang lebih personal dan relevan.

Contoh Penggunaan:

  • Metadata akun user (nama, email, ID, tipe paket)
  • Status subscription dan kredit saat ini
  • Informasi order/transaksi
  • Konteks teknis (device, status integrasi, error log)
Contoh dengan Konteks
{
  "conversation_id": "conv-abc-123",
  "message": "Paket saya yang sekarang apa?",
  "additional_context": "User: John Doe\\nEmail: john@example.com\\nPlan: Premium\\nCredits: 500\\nStatus: Active"
}

Catatan Keamanan:

Jangan sertakan informasi sensitif seperti password, API key, atau nomor kartu kredit di additional_context. Hanya sertakan metadata yang aman untuk diberikan ke AI.

Contoh Request

curl -X POST https://api.aksita.ai/api/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "message": "Hello!",
    "conversation_id": "your-session-id",
    "additional_context": "User: John Doe, Plan: Premium, Credits: 500"
  }'

Response Sukses

200 OK
{
  "status": true,
  "data": {
    "response": ["Saya tentu bisa membantu dengan itu. Berdasarkan kebijakan kami..."],
    "credits": 2,
    "remaining_credits": 1234,
    "message_id": "12345",
    "conversation_id": "abc-123-def-456"
  },
  "detail": "response berhasil dibuat"
}

Response Error

Pesan kosong atau hilang

400 Bad Request
{
  "status": false,
  "reason": "message wajib diisi"
}

Conversation ID hilang

400 Bad Request
{
  "status": false,
  "reason": "conversation_id wajib diisi"
}

Sesi tidak ada atau ID tidak valid

404 Not Found
{
  "status": false,
  "reason": "conversation tidak ditemukan"
}

Kredit tidak cukup

402 Payment Required
{
  "status": false,
  "reason": "Kredit tidak cukup"
}