Chatonio

This is taking longer than usual.

Chatonio

Способы входа в хелпдеск: магическая ссылка, пароль или SSO

21 июля 2026 г. 174 просмотраБаза знаний и хелпдеск

У хелпдеска две части: база знаний и FAQ, открытые всем, и раздел заявок, где клиенты входят в аккаунт, чтобы создавать и отслеживать обращения. Chatonio предлагает три способа входа — магическая ссылка, email и пароль или SSO из вашего собственного приложения, — а также настройку, которая определяет, кто вообще может создать аккаунт.

Всё описанное ниже находится в разделе Проекты → [ваш проект] → База знаний → Настройки, в разделе «Доступ и вход». Сам хелпдеск-портал есть не на всех тарифах (сравнение тарифов) — если вы его ещё не создали, начните со статьи Настройка хелпдеска.

Магическая ссылка (по умолчанию)

Вход без пароля. Клиент вводит свой email на странице входа и получает одноразовую ссылку для входа. Один клик — и он в аккаунте: не нужно придумывать, запоминать и сбрасывать пароль.

  • Каждая ссылка срабатывает один раз и действует 15 минут.
  • Настраивать ничего не нужно — работает сразу.
  • Лучший вариант для клиентов, которые заходят от случая к случаю: забытый пароль им не грозит.

Email и пароль

Классический вход для клиентов, которые обращаются часто и привыкли к форме с паролем. Выберите способ авторизации Email и пароль.

  • Первый вход всё равно проходит через магическую ссылку: она подтверждает email клиента, после чего он задаёт пароль.
  • Дальше клиент входит по email и паролю. Вход по ссылке из письма остаётся доступным — как «забыли пароль» и как путь для первого входа.

SSO — вход из вашего приложения

Если у клиентов уже есть аккаунты в вашем продукте, SSO полностью убирает второй вход: пользователь нажимает «Поддержка» в вашем приложении и попадает в хелпдеск уже авторизованным. В общих чертах это выглядит так:

  1. Откройте раздел «Единый вход (SSO)» и нажмите Сгенерировать ключ. Сразу скопируйте его — он показывается ровно один раз.
  2. Ваш бэкенд подписывает этим ключом короткоживущий токен (действует 5 минут, одноразовый) с ID, email и именем пользователя. Точный формат токена и адрес редиректа показаны в блоке «Пример интеграции» рядом с ключом.
  3. Ваше приложение перенаправляет пользователя в хелпдеск с этим токеном — он попадает туда уже авторизованным.

Полезно знать:

  • Пока включён SSO, публичные формы входа по ссылке и по паролю скрыты — страница входа предлагает войти через ваше приложение. При желании можно заполнить поле «Куда отправлять клиентов после выхода», чтобы вернуть их на ваш сайт.
  • Сменить ключ немедленно аннулирует старый ключ — обновите его на своём бэкенде одновременно. Этим же ключом подписываются пропуска для входа посетителей в веб-чат (см. Виджет веб-чата: вход в чат под аккаунтом посетителя), поэтому смена ключа затрагивает и его.
  • Переключиться на SSO нельзя, пока ключ не сгенерирован, а кнопка «Отключить единый вход» автоматически возвращает хелпдеск к входу по магической ссылке — клиенты никогда не окажутся заблокированы из-за ошибки в настройке.
  • Хелпдеск узнаёт клиента по ID пользователя в токене. Если с таким ID сюда ещё никто не входил, но аккаунт с тем же email уже есть, вход отклоняется. Исключение — аккаунт, у которого ещё нет ID: клиент, которого пригласила ваша команда, или аккаунт, созданный до включения SSO. Он привязывается к пользователю, если в токене есть "email_verified": true. Добавляйте это поле, только если вы проверили, что адрес принадлежит пользователю. При таком отказе клиент видит сообщение: «Этот email уже привязан к другому аккаунту в этом хелпдеске. Пожалуйста, обратитесь к администратору.»
  • С каждым входом приходит и имя из токена: если переименовать пользователя в вашем приложении, его аккаунт в хелпдеске получит новое имя при следующем входе. Имя контакта, которое видит ваша команда, меняется вместе с ним, пока кто-нибудь из команды не переименует контакт.

Раздел «Единый вход (SSO)»: ключ ещё не задан, рядом кнопка «Сгенерировать ключ»

Одноразовая панель со сгенерированным ключом подписи и кнопкой копирования

Открытая регистрация или только по приглашению

Раздел «Доступ и вход»: как входят клиенты, кто может создать аккаунт, переключатель «Telegram-чат в центре поддержки»

Независимо от способа входа, настройка «Кто может создать аккаунт» определяет, кто его получит:

  • Открытая (по умолчанию) — любой посетитель может создать аккаунт со страницы входа.
  • Только по приглашению — саморегистрация выключена. Существующие клиенты входят как обычно, но для незнакомых email-адресов аккаунт не создаётся: новые аккаунты появляются только через вашу команду. Это действует и при SSO: корректного токена из вашего приложения недостаточно, если пользователь ещё не заведён, а когда заведённый вами пользователь впервые входит через SSO, в токене должно быть "email_verified": true (см. раздел о SSO выше).

Создание аккаунтов клиентов вручную

Операторы могут заводить аккаунты хелпдеска сами — для хелпдеска «только по приглашению» это единственный путь для новых клиентов, но работает он в любом режиме:

  1. Откройте страницу Контакты и нажмите Добавить клиента.
  2. Выберите тип клиента Портал и укажите email клиента (при желании — отображаемое имя).
  3. Нажмите Создать и отправить приглашение — клиент получит приветственное письмо со ссылкой для входа.

Созданные так аккаунты считаются подтверждёнными. Если хелпдеск работает в режиме пароля, приглашённому клиенту при первом входе будет предложено задать пароль; в режиме магической ссылки ссылка сразу выполняет вход.

Telegram-чат в хелпдеске

Если у вашего проекта есть Telegram-бот, клиенты могут привязать свой Telegram к аккаунту хелпдеска прямо в хелпдеске, а потом писать вам в Telegram уже от имени этого аккаунта. Ваша команда видит одного клиента, а инструменты для вошедших клиентов работают и там.

Включите «Telegram-чат в центре поддержки» внизу раздела «Доступ и вход» и нажмите «Сохранить изменения». По умолчанию настройка выключена. Включить её можно, только пока к проекту подключён Telegram-бот — через Telegram-канал или канал Telegram-группы; до тех пор переключатель неактивен, а под ним написано «Сначала подключите Telegram-бота.»

После этого клиенты увидят кнопку «Чат в Telegram» под кнопкой «Отправить тикет», в шапке каждого тикета и на странице «Настройки», в карточке «Telegram-чат». Посетителя, который не вошёл в аккаунт, кнопка сначала отправит на страницу входа. Кнопка открывает одно окно:

  • «Открыть Telegram» открывает вашего бота по одноразовой ссылке: она срабатывает один раз, только с этим ботом и действует 15 минут. Клиент нажимает Старт, и бот отвечает, что его Telegram привязан к аккаунту. После этого в окне видно «Подключено» и кнопку «Отключить». Если в проекте несколько Telegram-ботов, у каждого своя кнопка.
  • Блок «В группе Telegram» появляется, если в проекте есть канал Telegram-группы. Кнопка «Показать команду» выдаёт команду /link, которая срабатывает один раз в течение 15 минут. Клиент отправляет её в группу, которую ваша команда уже подключила к боту, и бот подтверждает привязку в группе. После этого все участники группы считаются этим аккаунтом. Привязанные группы перечислены в списке «Подключённые группы», у каждой есть кнопка «Отключить». Группа привязана только к одному аккаунту: команда другого аккаунта перепривяжет её.

Окно «Чат в Telegram»: кнопка «Открыть Telegram» для личного чата и блок «В группе Telegram» с одноразовой командой /link, кнопкой копирования и кнопкой «Новая команда»

Группа, которую ваша команда ещё не подключила, не привязывается: бот отвечает, что сначала её должна подключить команда. Исключение — канал Telegram-группы в режиме «Автоматически принимать любую группу»: там команда заодно подключает группу.

Личный чат, привязанный здесь, работает так же, как привязанный из веб-чата: сообщения клиента боту приходят на контакт его аккаунта, а его прежние чаты с этим ботом переносятся туда же. Подробности и ограничения — в статье Виджет веб-чата: вход в чат под аккаунтом посетителя, раздел «Привязка Telegram посетителя». Привязанная группа остаётся отдельным диалогом во «Входящих»: в контакте аккаунта она указана в блоке «Каналы», а у диалога группы виден зелёный щит «Подтверждён» с этим аккаунтом.

Привязанный Telegram считается вошедшим в аккаунт — и в личном чате, и в привязанной группе, — пока его не отключат. Инструменты с флажком Только вошедшим клиентам работают там для аккаунтов, у которых есть ваш ID пользователя, то есть для аккаунтов, в которые ваш сайт выполнял вход через SSO или вход в чат. Если клиенты входят в хелпдеск только по ссылке из письма или по паролю, привязка Telegram по-прежнему покажет команде одного клиента со щитом, но такие инструменты работать не будут. См. статью Как создать API-интеграцию, раздел «Инструменты для вошедших клиентов».

Это не то же самое, что «Уведомления в Telegram»: уведомления только сообщают о событиях по тикетам и не принимают ответы (см. Уведомления о тикетах для ваших клиентов).

Что выбрать?

  • Магическая ссылка — надёжный вариант по умолчанию для широкой аудитории и редких посетителей. Ноль настройки, ноль сбросов пароля.
  • Email и пароль — для клиентов, которые возвращаются часто и предпочитают классическую форму входа.
  • SSO — когда хелпдеск обслуживает пользователей вашего собственного продукта: один аккаунт, никакого второго входа, а доступом управляет ваше приложение.
  • Режим только по приглашению добавляйте в любом сочетании, когда хелпдеск предназначен для закрытой клиентской базы — B2B-клиентов, платных аккаунтов, внутренних команд.

Хотите, чтобы портал работал и на вашем собственном домене? См. статью Свой домен для хелпдеска.

Эта статья была полезной?