Webhooks и REST API — для разработчиков
API позволяет интегрировать Prochat с CRM, ERP, Telegram-ботами и любыми внешними сервисами.
Получить API ключ
Перейдите в Настройки → Интеграции → API → Создать ключ. Задайте название и выберите права доступа (read / write / admin).
⚠️ Никогда не публикуйте API-ключ в открытом коде. Используйте переменные окружения.
Webhooks
Webhooks — уведомления от Prochat на ваш сервер при событиях:
dialog.created— новый диалогmessage.received— входящее сообщениеdialog.closed— диалог закрытoperator.assigned— назначен оператор
Зарегистрируйте URL в Настройки → Интеграции → Webhooks → Добавить endpoint. Запросы отправляются методом POST, тело — JSON.
{
"event": "message.received",
"dialog_id": "dlg_abc123",
"visitor": { "id": "vis_xyz", "name": "Аноним" },
"message": { "text": "Сколько стоит?", "timestamp": 1714000000 }
}
REST API — основные эндпоинты
Base URL: https://api.prochat.uz/v1
GET /dialogs | Список диалогов |
GET /dialogs/:id | Диалог с историей |
POST /dialogs/:id/messages | Отправить сообщение |
PATCH /dialogs/:id | Обновить статус, теги |
GET /operators | Список операторов |
GET /analytics/summary | Сводная аналитика |
Полная документация API будет опубликована в разделе Developer Docs. По вопросам интеграции: [email protected]