Dokumentasi API—sem.chat|REST API untuk Pembangun

Bermula

sem.chat API membolehkan anda mengurus perbualan secara atur cara, menghantar mesej dan mengakses analitik. Semua permintaan API memerlukan pengesahan menggunakan kunci API.

URL asas

https://api.sem.chat/v1

Pengesahan

Sertakan kunci API anda dalam pengepala Kebenaran semua permintaan:

Authorization: Bearer your_api_key_here

Perbualan

Senaraikan Perbualan

GET /conversations

Dapatkan senarai semua perbualan untuk akaun anda.

Parameter	Taip	Penerangan
had	integer	Bilangan keputusan untuk dikembalikan (maks 100)
mengimbangi	integer	Bilangan keputusan untuk dilangkau
status	rentetan	Tapis mengikut status: aktif, ditutup, belum selesai

Dapatkan Perbualan

GET /conversations/{id}

Dapatkan butiran perbualan tertentu termasuk semua mesej.

Cipta Perbualan

POST /conversations

Mulakan perbualan baharu secara pemprograman.

Mesej

Hantar Mesej

POST /conversations/{id}/messages

Hantar mesej ke perbualan sedia ada.

// Example request body
{
  "content": "Hello, how can I help you today?",
  "sender": "agent"
}

Webhooks

Sediakan webhooks untuk menerima pemberitahuan masa nyata tentang acara perbualan.

Acara Tersedia

Acara	Penerangan
perbualan.dimulakan	Perbualan baharu telah dimulakan
mesej.diterima	Mesej baharu diterima daripada pelawat
perbualan.tertutup	Perbualan telah ditutup
memimpin.ditawan	Maklumat hubungan telah dikumpul

Had Kadar

Permintaan API adalah terhad untuk memastikan penggunaan yang adil:

Rancang	Had Kadar
Percubaan	100 permintaan/jam
Pro	1,000 permintaan/jam
Perniagaan	10,000 permintaan/jam