Dokumentacja API — sem.chat | REST API dla programistów

Pierwsze kroki

Interfejs API sem.chat umożliwia programowe zarządzanie rozmowami, wysyłanie wiadomości i dostęp analityka. Wszystkie żądania API wymagają uwierzytelnienia przy użyciu klucza API.

Podstawowy adres URL

https://api.sem.chat/v1

Uwierzytelnienie

Dołącz swój klucz API w nagłówku autoryzacji wszystkich żądań:

Authorization: Bearer your_api_key_here

Rozmowy

Wyświetl listę rozmów

GET /rozmowy

Pobierz listę wszystkich rozmów na swoim koncie.

Parametr	Wpisz	Opis
limit	liczba całkowita	Liczba wyników do zwrócenia (maks. 100)
przesunięcie	liczba całkowita	Liczba wyników do pominięcia
stan	ciąg znaków	Filtruj według statusu: aktywne, zamknięte, w toku

Rozpocznij rozmowę

GET /rozmowy/{id}

Pobierz szczegóły konkretnej rozmowy, w tym wszystkie wiadomości.

Utwórz rozmowę

POST /rozmowy

Programowo rozpocznij nową rozmowę.

Wiadomości

Wyślij wiadomość

POST /rozmowy/{id}/wiadomości

Wyślij wiadomość do istniejącej rozmowy.

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

Haki internetowe

Skonfiguruj webhooki, aby otrzymywać powiadomienia w czasie rzeczywistym o zdarzeniach konwersacji.

Dostępne zdarzenia

Zdarzenie	Opis
rozmowa.rozpoczęta	Rozpoczęto nową rozmowę
wiadomość.odebrana	Otrzymano nową wiadomość od gościa
rozmowa.zamknięta	Rozmowa została zamknięta
lead.captured	Zebrano informacje kontaktowe

Limity stawek

Żądania API są ograniczone, aby zapewnić uczciwe użycie:

Plan	Limit stawki
Wersja próbna	100 żądań/godzinę
Zawod	1000 żądań/godz
Biznes	10 000 żądań/godz