У хелпдеска две части: база знаний и FAQ, открытые всем, и раздел заявок, где клиенты входят в аккаунт, чтобы создавать и отслеживать обращения. Chatonio предлагает три способа входа — магическая ссылка, email и пароль или SSO из вашего собственного приложения, — а также настройку, которая определяет, кто вообще может создать аккаунт.
Всё описанное ниже находится в разделе Проекты → [ваш проект] → База знаний → Настройки, в разделе «Доступ и вход». Сам хелпдеск-портал есть не на всех тарифах (сравнение тарифов) — если вы его ещё не создали, начните со статьи Настройка хелпдеска.
Магическая ссылка (по умолчанию)
Вход без пароля. Клиент вводит свой email на странице входа и получает одноразовую ссылку для входа. Один клик — и он в аккаунте: не нужно придумывать, запоминать и сбрасывать пароль.
- Каждая ссылка срабатывает один раз и действует 15 минут.
- Настраивать ничего не нужно — работает сразу.
- Лучший вариант для клиентов, которые заходят от случая к случаю: забытый пароль им не грозит.
Email и пароль
Классический вход для клиентов, которые обращаются часто и привыкли к форме с паролем. Выберите способ авторизации Email и пароль.
- Первый вход всё равно проходит через магическую ссылку: она подтверждает email клиента, после чего он задаёт пароль.
- Дальше клиент входит по email и паролю. Вход по ссылке из письма остаётся доступным — как «забыли пароль» и как путь для первого входа.
SSO — вход из вашего приложения
Если у клиентов уже есть аккаунты в вашем продукте, SSO полностью убирает второй вход: пользователь нажимает «Поддержка» в вашем приложении и попадает в хелпдеск уже авторизованным. В общих чертах это выглядит так:
- Откройте раздел «Единый вход (SSO)» и нажмите Сгенерировать ключ. Сразу скопируйте его — он показывается ровно один раз.
- Ваш бэкенд подписывает этим ключом короткоживущий токен (действует 5 минут, одноразовый) с ID, email и именем пользователя. Точный формат токена и адрес редиректа показаны в блоке «Пример интеграции» рядом с ключом.
- Ваше приложение перенаправляет пользователя в хелпдеск с этим токеном — он попадает туда уже авторизованным.
Полезно знать:
- Пока включён SSO, публичные формы входа по ссылке и по паролю скрыты — страница входа предлагает войти через ваше приложение. При желании можно заполнить поле «Куда отправлять клиентов после выхода», чтобы вернуть их на ваш сайт.
- Сменить ключ немедленно аннулирует старый ключ — обновите его на своём бэкенде одновременно. Этим же ключом подписываются пропуска для входа посетителей в веб-чат (см. Виджет веб-чата: вход в чат под аккаунтом посетителя), поэтому смена ключа затрагивает и его.
- Переключиться на SSO нельзя, пока ключ не сгенерирован, а кнопка «Отключить единый вход» автоматически возвращает хелпдеск к входу по магической ссылке — клиенты никогда не окажутся заблокированы из-за ошибки в настройке.
- Хелпдеск узнаёт клиента по ID пользователя в токене. Если с таким ID сюда ещё никто не входил, но аккаунт с тем же email уже есть, вход отклоняется. Исключение — аккаунт, у которого ещё нет ID: клиент, которого пригласила ваша команда, или аккаунт, созданный до включения SSO. Он привязывается к пользователю, если в токене есть
"email_verified": true. Добавляйте это поле, только если вы проверили, что адрес принадлежит пользователю. При таком отказе клиент видит сообщение: «Этот email уже привязан к другому аккаунту в этом хелпдеске. Пожалуйста, обратитесь к администратору.» - С каждым входом приходит и имя из токена: если переименовать пользователя в вашем приложении, его аккаунт в хелпдеске получит новое имя при следующем входе. Имя контакта, которое видит ваша команда, меняется вместе с ним, пока кто-нибудь из команды не переименует контакт.
Открытая регистрация или только по приглашению
Независимо от способа входа, настройка «Кто может создать аккаунт» определяет, кто его получит:
- Открытая (по умолчанию) — любой посетитель может создать аккаунт со страницы входа.
- Только по приглашению — саморегистрация выключена. Существующие клиенты входят как обычно, но для незнакомых email-адресов аккаунт не создаётся: новые аккаунты появляются только через вашу команду. Это действует и при SSO: корректного токена из вашего приложения недостаточно, если пользователь ещё не заведён, а когда заведённый вами пользователь впервые входит через SSO, в токене должно быть
"email_verified": true(см. раздел о SSO выше).
Создание аккаунтов клиентов вручную
Операторы могут заводить аккаунты хелпдеска сами — для хелпдеска «только по приглашению» это единственный путь для новых клиентов, но работает он в любом режиме:
- Откройте страницу Контакты и нажмите Добавить клиента.
- Выберите тип клиента Портал и укажите email клиента (при желании — отображаемое имя).
- Нажмите Создать и отправить приглашение — клиент получит приветственное письмо со ссылкой для входа.
Созданные так аккаунты считаются подтверждёнными. Если хелпдеск работает в режиме пароля, приглашённому клиенту при первом входе будет предложено задать пароль; в режиме магической ссылки ссылка сразу выполняет вход.
Telegram-чат в хелпдеске
Если у вашего проекта есть Telegram-бот, клиенты могут привязать свой Telegram к аккаунту хелпдеска прямо в хелпдеске, а потом писать вам в Telegram уже от имени этого аккаунта. Ваша команда видит одного клиента, а инструменты для вошедших клиентов работают и там.
Включите «Telegram-чат в центре поддержки» внизу раздела «Доступ и вход» и нажмите «Сохранить изменения». По умолчанию настройка выключена. Включить её можно, только пока к проекту подключён Telegram-бот — через Telegram-канал или канал Telegram-группы; до тех пор переключатель неактивен, а под ним написано «Сначала подключите Telegram-бота.»
После этого клиенты увидят кнопку «Чат в Telegram» под кнопкой «Отправить тикет», в шапке каждого тикета и на странице «Настройки», в карточке «Telegram-чат». Посетителя, который не вошёл в аккаунт, кнопка сначала отправит на страницу входа. Кнопка открывает одно окно:
- «Открыть Telegram» открывает вашего бота по одноразовой ссылке: она срабатывает один раз, только с этим ботом и действует 15 минут. Клиент нажимает Старт, и бот отвечает, что его Telegram привязан к аккаунту. После этого в окне видно «Подключено» и кнопку «Отключить». Если в проекте несколько Telegram-ботов, у каждого своя кнопка.
- Блок «В группе Telegram» появляется, если в проекте есть канал Telegram-группы. Кнопка «Показать команду» выдаёт команду
/link, которая срабатывает один раз в течение 15 минут. Клиент отправляет её в группу, которую ваша команда уже подключила к боту, и бот подтверждает привязку в группе. После этого все участники группы считаются этим аккаунтом. Привязанные группы перечислены в списке «Подключённые группы», у каждой есть кнопка «Отключить». Группа привязана только к одному аккаунту: команда другого аккаунта перепривяжет её.
Группа, которую ваша команда ещё не подключила, не привязывается: бот отвечает, что сначала её должна подключить команда. Исключение — канал Telegram-группы в режиме «Автоматически принимать любую группу»: там команда заодно подключает группу.
Личный чат, привязанный здесь, работает так же, как привязанный из веб-чата: сообщения клиента боту приходят на контакт его аккаунта, а его прежние чаты с этим ботом переносятся туда же. Подробности и ограничения — в статье Виджет веб-чата: вход в чат под аккаунтом посетителя, раздел «Привязка Telegram посетителя». Привязанная группа остаётся отдельным диалогом во «Входящих»: в контакте аккаунта она указана в блоке «Каналы», а у диалога группы виден зелёный щит «Подтверждён» с этим аккаунтом.
Привязанный Telegram считается вошедшим в аккаунт — и в личном чате, и в привязанной группе, — пока его не отключат. Инструменты с флажком Только вошедшим клиентам работают там для аккаунтов, у которых есть ваш ID пользователя, то есть для аккаунтов, в которые ваш сайт выполнял вход через SSO или вход в чат. Если клиенты входят в хелпдеск только по ссылке из письма или по паролю, привязка Telegram по-прежнему покажет команде одного клиента со щитом, но такие инструменты работать не будут. См. статью Как создать API-интеграцию, раздел «Инструменты для вошедших клиентов».
Это не то же самое, что «Уведомления в Telegram»: уведомления только сообщают о событиях по тикетам и не принимают ответы (см. Уведомления о тикетах для ваших клиентов).
Что выбрать?
- Магическая ссылка — надёжный вариант по умолчанию для широкой аудитории и редких посетителей. Ноль настройки, ноль сбросов пароля.
- Email и пароль — для клиентов, которые возвращаются часто и предпочитают классическую форму входа.
- SSO — когда хелпдеск обслуживает пользователей вашего собственного продукта: один аккаунт, никакого второго входа, а доступом управляет ваше приложение.
- Режим только по приглашению добавляйте в любом сочетании, когда хелпдеск предназначен для закрытой клиентской базы — B2B-клиентов, платных аккаунтов, внутренних команд.
Хотите, чтобы портал работал и на вашем собственном домене? См. статью Свой домен для хелпдеска.