Добавление участников команды

Обновлено 18 августа 2026

Описание: добавление участников в существующую команду двумя способами — приглашение по номеру телефона и перемещение из другой команды этого же партнера.

Приглашение участников в команду по номеру телефона

Описание: отправляет SMS с приглашением участнику по номеру телефона. Получив SMS, участник переходит по ссылке, попадает в личный кабинет СберЧаевых и подтверждает свое вступление в команду.

Последовательность шагов

1. Подготовить запрос — сформировать тело запроса для POST /api/team/invite/send с параметрами:
   • Authorization — передать apiKey партнера
   • teamUuid — UUID команды, в которую приглашают участника
   • invites — массив приглашений, каждый элемент содержит:
     • phone — номер телефона участника
2. Отправить запрос через POST /api/team/invite/send.
3. Обработать успешный ответ:
   • Приглашение отправлено — участник получает SMS со ссылкой для перехода в личный кабинет СберЧаевых
   • После перехода по ссылке участник видит приглашение вступить в команду и должен подтвердить его
4. Участник подтверждает вступление — после подтверждения участник становится членом команды.

Альтернативные сценарии ошибок

Код ошибки	Описание
field.invalid.format.error	Некорректный формат переданных параметров
team.notFound.error	Команда не найдена
client.notFound.error	Клиент не найден
client.blocked.error	Клиент заблокирован
header.invalid.error	Заголовок Authorization не передан
no.session.error	Клиент не аутентифицирован

Добавление участников из другой команды этого же партнера

Описание: перемещение участника из одной команды партнера в другую. Позволяет перебрасывать уже существующих участников между командами без необходимости повторного приглашения.

Последовательность шагов

1. Подготовить запрос — сформировать тело запроса для POST /api/team/member/add с параметрами:
   • Authorization — передать apiKey партнера
   • teamUuid — UUID команды, в которую перемещают участника
   • memberUuid — UUID участника, которого перемещают
2. Отправить запрос через POST /api/team/member/add с заголовком Authorization (apiKey партнера).
3. Обработать успешный ответ:
   • Участник успешно добавлен в новую команду
   • Участник автоматически становится доступным в целевой команде

Альтернативные сценарии ошибок

Код ошибки	Описание
field.invalid.format.error	Некорректный формат переданных параметров
team.notFound.error	Команда не найдена
member.notFound.error	Участник не найден
client.notFound.error	Клиент не найден
client.blocked.error	Клиент заблокирован
header.invalid.error	Заголовок Authorization не передан
no.session.error	Клиент не аутентифицирован