📚 Руководство по интеграции

🔌 API Endpoint

POST https://your-api-url.com/api/messages/

Заголовки (Headers):

  • Content-Type: application/json (обязательно)
  • X-Webhook-URL: https://your-crm.com/webhook (опционально) - URL для отправки ответа обратно
  • X-Idempotency-Key: unique-key-123 (опционально) - ключ для предотвращения дубликатов

Тело запроса (Body):

{
"client_id": "client_123", // Уникальный ID клиента
"content": "Текст сообщения от клиента", // Текст сообщения
"timestamp": "2025-11-27T12:00:00Z" // Опционально, по умолчанию текущее время
}

📥 Ответ API

{
"status": "success",
"original_message_id": "uuid",
"is_first_message": true,
"priority": "low",
"classification": {
"scenario": "GREETING",
"confidence": 0.92,
"reasoning": "..."
},
"response": {
"message_id": "uuid",
"text": "Автоматический ответ...",
"type": "bot_auto"
},
"webhook": {
"success": true
}
}

🔄 Webhook для ответов

Если вы указали заголовок X-Webhook-URL, система автоматически отправит ответ обратно в вашу CRM систему.

POST {your-webhook-url}
{
"client_id": "client_123",
"response_text": "Автоматический ответ...",
"message_id": "uuid",
"classification": {
"scenario": "GREETING",
"confidence": 0.92
}
}

📊 Примеры сценариев

GREETING - Приветствие и первое обращение
REFERRAL - Вопросы о реферальной программе
TECH_SUPPORT_BASIC - Базовые технические вопросы
FAREWELL - Прощание
COMPLAINT - Жалобы (автоматически эскалируются)
SCHEDULE_CHANGE - Изменение расписания
UNKNOWN - Неизвестный сценарий (требует эскалации)

⚠️ Важные замечания

  • • Rate limiting: максимум 10 сообщений в минуту на одного клиента
  • • Сообщения с низкой уверенностью ИИ автоматически эскалируются
  • • Жалобы и повторяющиеся запросы получают высокий приоритет
  • • Используйте X-Idempotency-Key для предотвращения дубликатов