Bitrix. Добавить пользователя в группу социальной сети

При использовании битрикса и системы "Портал Битрикс24" может потребоваться добавить пользователя в группу социальной сети. Сделать это можно при помощи CSocNetUserToGroup::Add():

function addUserToGroup ($userId, $groupId)
{
    global $APPLICATION;

    //1 - это id пользователя, от имени которого будет добавлен пользователь
    //в нашей системе, 1 - это id пользователя "Администратор"
    $initiatedByUserId = CUser::GetID() ? CUser::GetID() : 1;

    $arFields = array(
        "USER_ID" => $userId,
        "GROUP_ID" => $groupId,
        "ROLE" => SONET_ROLES_USER,
        "=DATE_CREATE" => $GLOBALS["DB"]->CurrentTimeFunction(),
        "=DATE_UPDATE" => $GLOBALS["DB"]->CurrentTimeFunction(),
        "INITIATED_BY_TYPE" => SONET_INITIATED_BY_USER,
        "INITIATED_BY_USER_ID" => $initiatedByUserId,
        "MESSAGE" => false,
    );
    
    $rs = CSocNetUserToGroup::Add($arFields);
    if ($rs === false) {
        echo 'Пользователь #' . $userId . ' не добавлен в группу #' . $groupId;
        if ($e = $APPLICATION->GetException()) {
            echo 'Error code: ' . $e->id . '; error message: ' . $e->msg;
        }
    } else {
        echo 'Пользователь #' . $userId . ' добавлен в группу #' . $groupId;
    }
}