Запись в группу

Метод завершает запись в целевой CRM: находит или создаёт ученика, создаёт заявку и при наличии места добавляет ученика в группу. Все операции ограничены компанией OAuth-клиента.

Запрос

POST /api/v2/enrollments
Scope: enrollments:write
Content-Type: application/json

Запрос содержит:

• applicationKey — постоянный ключ операции;
• channel, platformUserId, personKey — технический контекст Mini App;
• phone — подтверждённый телефон контактного лица;
• payload — данные контактного лица, ученика, выбранной группы, уровня и договора;
• audit — дата принятия условий, канал, IP и User-Agent.

Ответ

{
  "applicationId": 501,
  "studentId": 1204,
  "reqId": 811,
  "groupOfStudentId": 940,
  "status": "ENROLLED",
  "waitlist": false
}

Операция идемпотентна по сочетанию компании, applicationKey и направления. Повтор запроса возвращает созданные ранее сущности и не создаёт дубликаты. Платформенный идентификатор передаётся как служебный контекст, но не привязывается к карточке ученика в другой CRM: сообщения отправляет исходный бот.