Материал о новой версии, описанной на сайте S-WEBS. Доступность для вашего портала уточните на странице приложения.
Что проверить до авторизации
Сначала установите приложение в нужном портале Битрикс24 и откройте его из портала. Если в браузере показан пример с тестовыми данными, он не подключён к реальному Telegram и не заменяет установленное приложение.
Для входа понадобится личный Telegram-аккаунт, доступ к нему и устройство, на котором можно завершить подтверждение. Если включена двухфакторная защита, подготовьте её пароль. Установку, права и условия получения версии описывает официальная инструкция S-WEBS; здесь рассматривается авторизация уже установленного приложения.
Выберите аккаунт осознанно. Название подключения должно помогать сотрудникам понять, для какой работы он используется. До первого сообщения определите, кто вправе вести диалог от этого аккаунта и с каким тестовым человеком вы проверите обмен.
Не пересылайте коды входа, пароль или QR в рабочий чат ради помощи с настройкой. Вход выполняется в форме приложения. Для обращения в поддержку достаточно раздела, времени действия и текста ошибки без секретных данных.
Как войти по номеру телефона
Последовательность в новой версии выглядит так:
- Откройте раздел «Подключения Telegram».
- Нажмите «Подключить» и задайте понятное название.
- Выберите тип «Личный аккаунт».
- Подтвердите создание подключения.
- Введите номер телефона с плюсом и кодом страны.
- Нажмите «Продолжить».
- Введите код способом, который предложил Telegram.
- При запросе двухфакторной защиты введите пароль в форме.
- Проверьте состояния «Авторизован» и «На связи».
Не меняйте номер на другой только потому, что код не пришёл сразу. Сначала прочитайте подсказку формы и убедитесь, что вход выполняется в нужный аккаунт. Если у команды несколько номеров, это помогает избежать авторизации другого рабочего или личного профиля.
Статусы относятся к конкретному подключению. Наличие готовой карточки одного аккаунта не означает, что все остальные подключения тоже авторизованы и готовы к отправке.
Где искать код и зачем нужен пароль
Код Telegram может прийти в служебный чат на уже авторизованном устройстве, а не по SMS. Поэтому ожидание только телефонного сообщения иногда задерживает настройку. Форма показывает доступный способ доставки; следуйте её текущему состоянию.
Если код не виден, проверьте служебный чат Telegram на устройстве с действующей сессией. Повторный запрос выполняйте, когда Telegram разрешает его. Последовательные нажатия без проверки подсказки не подтверждают, что выбран другой канал доставки.
Пароль двухфакторной защиты относится к отдельному условию входа. Если Telegram запрашивает его после кода, подтверждение ещё не завершено. Используйте пароль этого Telegram-аккаунта, не пароль от Битрикс24 и не данные коллеги.
Если время формы истекло, нажмите «Обновить» и продолжите по актуальному состоянию. Старый экран сам по себе не является основанием выходить из уже готового аккаунта. Сначала посмотрите состояние карточки подключения.
Когда использовать QR
QR позволяет завершить авторизацию с уже доступного Telegram-устройства, если в приложении показана кнопка «Войти по QR». Это альтернативный способ входа; он зависит от того, что предлагает Telegram при текущей авторизации.
Нажмите эту кнопку, затем в Telegram откройте «Настройки → Устройства → Подключить устройство» и отсканируйте QR. Выполните дополнительные запросы Telegram, если они появятся. После завершения снова проверьте состояние подключения в приложении.
QR не стоит вставлять в инструкцию для коллег или прикладывать к скриншоту ошибки. Для описания проблемы достаточно указать, на каком шаге она возникла. Если QR недоступен, используйте предложенный формой путь по телефону; нельзя обещать наличие обоих способов в каждом состоянии входа.
Как отличить вход от готовой переписки
Авторизация подтверждает доступ приложения к выбранному аккаунту. Рабочий результат подтверждает обмен с конкретным адресатом. Это разные этапы, и проверять их нужно последовательно.
| Что видно | Что уже проверено | Что проверить дальше |
|---|---|---|
| Приложение открывается из Битрикс24 | Доступен установленный экран | Авторизация Telegram |
| «Авторизован» и «На связи» | Готовность выбранного подключения | Отправка и ответ |
| Сообщение получено в Telegram | Исходящее направление для адресата | Ответ в Битрикс24 |
| Ответ появился и сохранился | Проверенный двусторонний обмен | Доступ нужного сотрудника |
Для первого теста удобно использовать личный чат в CRM. Администратор добавляет вкладку Telegram, затем выбирают тестовую карточку и привязывают личного собеседника. Подробные действия описаны в статье о Telegram-чате в сделке.
Учебный пример проверки
Администратор подключает согласованный рабочий аккаунт. Коллега, который участвует в тесте, разрешил написать ему в Telegram. Во вкладке тестовой сделки выбирают этот аккаунт и привязывают адресата по доступному номеру или username.
Отправьте нейтральный текст, например: «Проверяем подключение Telegram. Пожалуйста, ответьте “получено”». Дождитесь «Отправлено в Telegram», сверьте получение у коллеги и ответ во вкладке. Перезагрузите карточку, чтобы убедиться в сохранении обоих сообщений.
Если показано «В очереди», результат ещё не подтверждён. При неизвестном состоянии сначала проверьте сам Telegram-диалог, затем решайте вопрос о повторе. Не отправляйте один тест многократно только из-за отсутствия немедленного ответа.
После обмена назначьте доступ нужным сотрудникам, отделам или рабочим группам. Права на CRM-карточку сохраняют значение: доступ к аккаунту не заменяет их. Сотрудник без подходящего подключения обращается к администратору, а не повторяет установку приложения.
Сведения о поддерживаемых способах входа и доступности новой версии проверяйте на странице приложения.
Частые вопросы
Всегда ли код приходит по SMS?
Нет. Код может прийти в служебный чат Telegram на уже авторизованном устройстве. Проверьте подсказку формы о способе доставки и соответствующее устройство.
Можно ли войти по QR?
Да, если при текущем входе доступна кнопка «Войти по QR». QR сканируют в Telegram через «Настройки → Устройства → Подключить устройство» и завершают дополнительные запросы.
Достаточно ли статуса «Авторизован» для проверки переписки?
Нет. После авторизации проверьте фактическое получение сообщения в Telegram, ответ в выбранном назначении Битрикс24 и сохранение диалога после повторного открытия.
Нужно ли выходить из аккаунта при истёкшей форме входа?
Нет, истёкшая форма сама по себе этого не требует. Нажмите «Обновить», проверьте актуальное состояние и не выходите из уже готового подключения без необходимости.