Інтегруйте sem.chat у свої програми за допомогою нашого потужного REST API.
sem.chat API дозволяє вам програмно керувати розмовами, надсилати повідомлення та отримувати доступ аналітика. Усі API запити вимагають автентифікації за допомогою API ключа.
https://api.sem.chat/v1 Включіть свій API ключ у заголовок авторизації всіх запитів:
Authorization: Bearer your_api_key_here Отримайте список усіх розмов для вашого account.
| Параметр | Тип | Опис |
|---|---|---|
| limit | integer | Кількість результатів для повернення (макс. 100) |
| offset | integer | Кількість результатів, які потрібно пропустити |
| рядок | статусу | Фільтрувати за статусом: активний, закритий, очікує |
Отримати деталі певної розмови, включаючи всі повідомлення.
Почати нову розмову програмно.
Надіслати повідомлення до наявної розмови.
// Example request body { "content": "Hello, how can I help you today?", "sender": "agent" } Налаштувати вебхуки для отримання сповіщень у реальному часі про події розмов.
| Подія | Опис |
|---|---|
| conversation.started | Було розпочато нову бесіду |
| message.received | Отримано нове повідомлення від відвідувача |
| conversation.closed | Розмову закрито |
| lead.captured | Контактну інформацію зібрано |
API запити обмежені забезпечити справедливе використання:
| План | Ліміт тарифів |
|---|---|
| Пробна версія | 100 запитів/годину |
| Pro | 1000 запитів/годину |
| Бізнес | 10 000 запитів/годину |
За документацією API визначте мінімальний набір даних і прав для конкретного процесу. Зберігайте облікові дані лише в серверному сховищі секретів, ніколи в браузерному коді, відкритому репозиторії, знімках екрана чи повідомленнях підтримки. Розділяйте розробку й продакшн, перевіряйте вхідні дані, коректно обробляйте ліміти та повторні запити й не записуйте чутливі дані клієнтів. Протестуйте прострочені ключі, дублікати подій, мережеві збої та безпечний відкат. Призначте відповідальних за ротацію й інциденти та регулярно видаляйте непотрібні права.