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

Початок Роботи

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

Базовий URL

https://api.sem.chat/v1

Автентифікація

Включіть ваш API ключ у заголовок Authorization усіх запитів:

Authorization: Bearer your_api_key_here

Розмови

List Розмови

GET /conversations

Отримати список усіх розмов for your account.

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

Отримати Розмову

GET /conversations/{id}

Отримати деталі конкретної розмови, включаючи всі повідомлення.

Створити Розмову

POST /conversations

Розпочати нову розмову programmatically.

Повідомлення

Надіслати Повідомлення

POST /conversations/{id}/messages

Надіслати повідомлення в існуючу розмову.

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

Вебхуки

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

Доступні Події

Подія	Опис
conversation.started	Розпочато нову розмову
message.received	Отримано нове повідомлення від відвідувача
conversation.closed	Розмову завершено
lead.captured	Зібрано контактну інформацію

Ліміти Запитів

API запити обмежені для забезпечення справедливого використання:

План	Ліміт Запитів
Безкоштовний	100 запитів/годину
Про	1,000 запитів/годину
Бізнес	10,000 запитів/годину