Send Chat Message

Endpoint ini digunakan untuk mengirimkan pesan chat ke Raga Chatbot. Anda dapat memulai percakapan baru atau melanjutkan percakapan sebelumnya menggunakan X-SESSION-ID.

Endpoint

POST

https://api.raga.ziwardingai.xyz/v1/api/open-api/workspaces/:workspace_id/chat

Path Parameter

Parameter	Tipe	Keterangan
workspace_id	String	ID workspace Anda di sistem Raga. Wajib diisi di URL path.

Headers

Header	Tipe	Keterangan
Authorization	String	Wajib. Berisi Bearer {app_key} untuk autentikasi.
X-SESSION-ID	String	Opsional. ID session chat sebelumnya. Jika dikosongkan, maka akan membuat session baru.
Content-Type	String	Wajib. Harus diisi dengan application/x-www-form-urlencoded.

Body (x-www-form-urlencoded)

Parameter	Tipe	Keterangan
chat	String	Wajib. Teks atau pesan chat yang ingin dikirimkan ke chatbot.

Penjelasan

• Gunakan X-SESSION-ID untuk melanjutkan percakapan lama.
• Jika Anda ingin memulai percakapan baru, kosongkan header X-SESSION-ID.
• Parameter chat adalah isi dari pesan yang akan dikirim ke chatbot.

Contoh Request (cURL)

curl --location 'https://api.raga.ziwardingai.xyz/v1/api/open-api/workspaces/123e4567-e89b-12d3-a456-426614174000/chat' \
--header 'X-SESSION-ID: f1e47f853c06ba8b25c86ff0cc28dab1' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer YOUR_APP_KEY' \
--data-urlencode 'chat=Halo, Raga! Ini chat pertama.'

Contoh Response Sukses (HTTP 201)

{
  "code": 201,
  "data": {
    "session_id": "9cdad43a61aba0bddd69ff283fc3301f",
    "workspace_id": "993e80fb-4a78-491b-9b5b-1cc8bb336afb",
    "chat": "halo",
    "like": false,
    "dislike": false,
    "id": "fc051aef-7e2a-422f-8634-f97c92609878",
    "llm": "local_v2",
    "response": "halo! bagaimana saya bisa membantu Anda hari ini?",
    "knowledge_source_detail": [
      {
        "type": "basic",
        "topic_id": [
          "1685d466-ddbd-4150-9750-2b1a56aa5bdd"
        ]
      }
    ],
    "created_at": "2025-06-18T05:48:12.757Z",
    "updated_at": "2025-06-18T05:48:12.757Z"
  }
}

Keterangan Response

Field	Tipe	Keterangan
code	Integer	HTTP status code dari response (201 jika berhasil).
session_id	String	ID session chat saat ini.
workspace_id	String	ID workspace yang digunakan.
chat	String	Pesan chat yang dikirim oleh user.
like	Boolean	Status apakah user menyukai respons chatbot. Default: false
dislike	Boolean	Status apakah user tidak menyukai respons chatbot. Default: false
id	String	ID unik untuk percakapan chat ini.
llm	String	Model LLM yang digunakan oleh chatbot.
response	String	Balasan dari chatbot.
knowledge_source_detail	Array	Informasi sumber pengetahuan yang digunakan chatbot.
created_at	String	Timestamp saat data chat dibuat.
updated_at	String	Timestamp saat data chat diperbarui.

Response API

Status Code	Keterangan	Pesan
201	Created (Success)	Request berhasil, chat diproses.
403	Forbidden	Invalid app key or unauthorized access.