Пригласить участника в группу

Активити (робот) "Пригласить участника в группу" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Приглашение новых участников в рабочую группу с персональным сообщением;
Автоматическое приглашение при создании проекта или группы;
Приглашение с поясняющим текстом о целях группы;
Интеграция с процессами онбординга - приглашение с инструкциями;
Приглашение сотрудников по результатам поиска или отбора;
Массовые приглашения с индивидуальным текстом через итератор;
Приглашение контрагентов (экстранет) с описанием условий доступа;
Уведомление о приглашении с контактной информацией;
Приглашение при смене владельца проекта;
Приглашение с указанием сроков или условий участия.

Как работает активити (робот):
- Активити (робот) отправляет приглашение участнику в рабочую группу через API sonet_group.user.invite;
- В отличие от "Добавление участника" - пользователь получает приглашение и может принять или отклонить;
- Поддерживается персонализированный текст приглашения (message);
- При передаче нескольких ID приглашается только первый пользователь.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Идентификатор группы, в которую приглашается пользователь. Примеры: - {=Variable:GROUP_ID}, {=A12345:i_group_id}, 42
ID пользователя	Обязательный параметр. ID пользователя, которому отправляется приглашение. Примеры: - {=Document:ASSIGNED_BY_ID}, {=Variable:NEW_MEMBER_ID}, user_1
Текст приглашения	Необязательный параметр. Персональное сообщение, которое увидит приглашаемый. Может содержать инструкции, сроки, контакты. Примеры: - Добро пожаловать в группу проекта "Название"! Срок до {{=date('d.m.Y', {=System:Now})}}; - Вас приглашают в рабочую группу. Свяжитесь с координатором для уточнения деталей.
Запускать от имени	Сотрудник с правами на приглашение в группу.

Примеры использования активити (робота)

Описание примера	Решение
Приглашение с приветствием при создании группы	group_id - {=A12345:i_group_id}, list_users - {=Variable:USER_ID}, message - Добро пожаловать в группу проекта!
Приглашение с указанием дедлайна	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Проект до {{=date('d.m.Y', {=Variable:DEADLINE})}}
Приглашение ответственного за сделку	group_id - {=Variable:GROUP_ID}, list_users - {=Document:ASSIGNED_BY_ID}, message - Вас добавляют в группу по сделке
Массовое приглашение через итератор	group_id - {=Variable:GROUP_ID}, list_users - {=Iterator:Value}, message - Общее приглашение в рабочую группу
Приглашение с контактами координатора	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Координатор: {=Variable:COORDINATOR_NAME}, тел. {=Variable:PHONE}
Приглашение при смене владельца	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:NEW_OWNER_ID}, message - Вы назначены новым владельцем группы
Приглашение с инструкцией по доступу	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Инструкция: 1. Примите приглашение 2. Ознакомьтесь с материалами
Приглашение из результата поиска групп	group_id - {=A12345:search_result_first_string}, list_users - {=Variable:USER_ID}, message - Приглашение в найденную группу
Приглашение создателя процесса	group_id - {=Variable:GROUP_ID}, list_users - {=Template:TargetUser}, message - Вы создали группу, примите приглашение
Приглашение с названием проекта	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Группа: {=Variable:PROJECT_NAME}

Возвращаемые параметры данного активити (робота):
- Успех выполнения (good_track) - 1 при успешной отправке приглашения, 0 при ошибке.

Параметр "Успех выполнения" = 1 означает, что приглашение отправлено.
Пользователь может отклонить его - это не отражается в параметре.

Ограничения и рекомендации:

Приглашение vs добавление:
Приглашение требует согласия пользователя.
Для немедленного добавления без согласия используйте активити (робот) "Добавление участника(ов) в группу".

Один пользователь:
При нескольких ID в list_users приглашается только первый пользователь.

Ваша корзина пуста

Пригласить участника в группу