Memulai

sem.chat API memungkinkan Anda mengelola percakapan, mengirim pesan, dan mengakses analitik secara terprogram. Semua permintaan API memerlukan otentikasi menggunakan kunci API.

Basis URL

https://api.sem.chat/v1

Otentikasi

Sertakan kunci API Anda di header Otorisasi semua permintaan:

Authorization: Bearer your_api_key_here

Percakapan

Daftar Percakapan

GET /percakapan

Ambil daftar semua percakapan untuk akun Anda.

Parameter Ketik Deskripsi
batas bilangan bulat Jumlah hasil yang akan dikembalikan (maks 100)
mengimbangi bilangan bulat Jumlah hasil yang harus dilewati
status tali Filter berdasarkan status: aktif, tertutup, tertunda

Dapatkan Percakapan

GET /percakapan/{id}

Ambil detail percakapan tertentu termasuk semua pesan.

Buat Percakapan

POST /percakapan

Mulai percakapan baru secara terprogram.

Pesan

Kirim Pesan

POST /conversations/{id}/messages

Kirim pesan ke percakapan yang ada.

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

Webhook

Siapkan webhook untuk menerima notifikasi real-time tentang peristiwa percakapan.

Acara yang Tersedia

Acara Deskripsi
percakapan.dimulai Percakapan baru telah dimulai
pesan.diterima Pesan baru diterima dari pengunjung
percakapan.tertutup Percakapan telah ditutup
memimpin.ditangkap Informasi kontak dikumpulkan

Batasan Tarif

Permintaan API dibatasi untuk memastikan penggunaan wajar:

Rencana Batas Nilai
Percobaan 100 permintaan/jam
Pro 1.000 permintaan/jam
Bisnis 10.000 permintaan/jam