API Документация — sem.chat | REST API, Вебхуки и Интеграция

Начало Работы

API sem.chat позволяет программно управлять разговорами, отправлять сообщения и получать доступ к аналитике. Все API запросы требуют аутентификации с помощью API ключа.

Базовый URL

https://api.sem.chat/v1

Аутентификация

Включите ваш API ключ в заголовок Authorization всех запросов:

Authorization: Bearer your_api_key_here

Разговоры

Список Разговоров

GET /conversations

Получить список всех разговоров для вашего аккаунта.

Параметр	Тип	Описание
limit	integer	Количество результатов (макс 100)
offset	integer	Количество результатов для пропуска
status	string	Фильтр по статусу: active, closed, pending

Получить Разговор

GET /conversations/{id}

Получить детали конкретного разговора, включая все сообщения.

Создать Разговор

POST /conversations

Начать новый разговор программно.

Сообщения

Отправить Сообщение

POST /conversations/{id}/messages

Отправить сообщение в существующий разговор.

                // Пример тела запроса
{
  "content": "Привет, чем я могу вам помочь?",
  "sender": "agent"
}
            

Вебхуки

Настройте вебхуки для получения уведомлений в реальном времени о событиях разговоров.

Доступные События

Событие	Описание
conversation.started	Начат новый разговор
message.received	Получено новое сообщение от посетителя
conversation.closed	Разговор завершен
lead.captured	Собрана контактная информация

Лимиты Запросов

Запросы API ограничены для обеспечения справедливого использования:

Тариф	Лимит
Бесплатный	100 запросов/час
Про	1,000 запросов/час
Бизнес	10,000 запросов/час