Başlarken

sem.chat API, konuşmaları programlı bir şekilde yönetmenize, mesaj göndermenize ve analizlere erişmenize olanak tanır. Tüm API istekleri, bir API anahtarı kullanılarak kimlik doğrulaması gerektirir.

Temel URL

https://api.sem.chat/v1

Kimlik Doğrulaması

API anahtarınızı tüm isteklerin Yetkilendirme başlığına ekleyin:

Authorization: Bearer your_api_key_here

Konuşmalar

Konuşmaları Listele

GET /conversations

Hesabınıza ilişkin tüm konuşmaların bir listesini alın.

Parametre Türü Açıklama
sınırı tamsayı Döndürülecek sonuç sayısı (maks. 100)
ofset tamsayı Atlanacak sonuç sayısı
durumu dize Duruma göre filtrele: etkin, kapalı, beklemede

Konuşmayı Alın

GET /conversations/{id}

Tüm mesajları içeren belirli bir görüşmenin ayrıntılarını alın.

Konuşma Oluştur

POST /conversations

Programlı olarak yeni bir görüşme başlatın.

Mesajlar

Mesaj Gönder

POST /conversations/{id}/messages

Mevcut bir görüşmeye mesaj gönderin.

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

Web Kancaları

Konuşma etkinlikleri hakkında gerçek zamanlı bildirimler almak için web kancalarını ayarlayın.

Mevcut Etkinlikler

Etkinlik Açıklama
görüşme başladı. Yeni bir görüşme başlatıldı
mesaj alındı Bir ziyaretçiden yeni bir mesaj alındı
görüşme.kapalı Bir görüşme kapatıldı
kurşun.yakalandı İletişim bilgileri toplandı

Hız Limitleri

API istekleri, adil kullanımın sağlanması amacıyla sınırlıdır:

Planı Hız Limiti
Deneme 100 istek/saat
Profesyonel 1.000 istek/saat
İş 10.000 istek/saat