ДокументацияНастройка проекта

Аккаунты

для администратора школыПройти по шагам в Академии

Telegram-номера проекта: с них TERVIO пишет клиентам и принимает их сообщения. Раздел видит администратор. Список обновляется сам раз в полминуты.

Верхний ряд

  • Добавить аккаунт — мастер из трёх шагов: «Данные аккаунта» (телефон, название, api_id и api_hash), код из Telegram и облачный пароль — если он на номере включён.
  • Куда приходит код — в приложение Telegram — в чат «Telegram» с синей галочкой на телефоне или компьютере, где этот номер уже открыт. СМС не будет: сторонним сервисам Telegram коды по СМС не присылает. Если к номеру привязана почта для входа, код может прийти на неё. Куда он ушёл на самом деле, окно пишет по ответу Telegram. Бывает, что Telegram сначала просит привязать почту: тогда войдите в номер в приложении Telegram на телефоне, привяжите почту и запросите код снова. Код не пересылайте через Telegram — пересланный там код Telegram отменяет. Каждый запрос кода и куда он ушёл — в Журнале.
  • Где взять api_id и api_hash — на my.telegram.org/apps — войти по номеру этого же аккаунта, раздел «API development tools». Пары ещё нет — завести приложение: название любое, платформа Desktop. api_id — короткое число, api_hash — строка из 32 символов. Пара делается один раз и остаётся у номера навсегда, для каждого номера она своя.
  • Проверить связь — TERVIO спрашивает Telegram о каждом номере и пишет итог: все ли на связи, а если нет — сколько номеров не работает. Без этой кнопки раздел показывает то, что TERVIO знает из своей базы.
  • «Список» и «Здоровье» — переключатель вида. «Здоровье» — те же номера карточками: статус, приём и отправка, счётчики суток и часа вместе с пределами («12 / 25»), «группы» — группы и каналы номера из его предела, и отметки бед — пауза Telegram, заморозка, прогрев и разгон, ограничение по жалобам, «без новых чатов» и «лимит групп», отозванные ссылки, номер без своего адреса. Фильтр «Только с бедой» оставляет номера, с которыми надо что-то делать. Нажатие на карточку открывает номер в списке.
  • Ссылки-приглашения — собирает ссылки для групповых чатов, где ссылки ещё нет: по ней клиент заходит в свой чат. Работа идёт на живых номерах, около минуты на сотню чатов, и отправка клиентам в это время чуть медленнее. Если у части чатов не получилось, нажмите ещё раз.
  • Поиск — по телефону или нику номера.

Сводка

  • «Номера» — всего; «в работе» — на связи и без ограничений; «с бедой» — заморожен, на паузе, ограничен Telegram, без новых чатов или с отозванными ссылками; «вне связи» — TERVIO не на связи с номером, сообщения его клиентов не приходят.
  • «Чаты от TERVIO» — сколько групповых чатов создал TERVIO «За день» или «За неделю», сколько живых групповых чатов всего и то же по каждому номеру. Чужие группы, в которые номер добавили, сюда не входят.

Строка номера

  • Колонки — телефон; название и ник; «ID подключения» — его вписывают в условие блока сценария, переменная {id_подключения} («Сценарии»); статус; дата последнего диалога.
  • Статусы — «онлайн»; «офлайн» — TERVIO не на связи с номером; «флуд» и «карантин» — отправка закрыта на время, рядом видно, до какого; «заморожен» — номер выпал из работы, нужен человек; «частичный бан» — ограничение Telegram по жалобам; «без новых чатов» — Telegram не даёт номеру создавать чаты; «бан» — номер заблокирован, вернуть его нельзя, нужен другой. Наведите на статус — подсказка скажет, что с номером.
  • Кнопки в строке — «Переподключить» — у номера со статусом «заморожен» или «офлайн»; «⋯» — меню действий. То же меню открывается правым кликом по строке и долгим нажатием на телефоне.

Раскрытая строка: состояние

Стрелка ▸ в начале строки раскрывает номер: сверху состояние, ниже — «Настройки номера».

  • «Приём сообщений» и «Отправка» — две отдельные метки: номер на паузе принимает сообщения, но не пишет. Если проверка связи нашла беду, рядом появляется «Связь с Telegram» с объяснением.
  • Счётчики — «Чатов сегодня», «Приглашений сегодня» и «Сообщений за час» рядом с пределом («12 из 25»); полоска желтеет с 80 % и краснеет, когда предел выбран. «Пауза Telegram» — сколько ещё закрыта отправка.
  • Групп и каналов — в скольких группах и каналах состоит номер, вместе с групповыми чатами, из предела Telegram: 500, у номера с Telegram Premium 1000. Лички и боты сюда не входят. Число желтеет с 80 % предела и краснеет с 95 %: на пределе номер не создаёт групповые чаты и не вступает в группы. Считается по кнопке «Пересчитать» — тогда же TERVIO узнаёт у Telegram, есть ли у номера Premium; рядом видно, когда считали.
  • Внизу — дата последнего диалога и с какого числа номер в TERVIO.

Настройки номера

  • Название — так номер подписан в списках и в чатах. Пустым его оставить нельзя.
  • Профиль в Telegram — то, что клиенты видят у номера в самом Telegram: фото, имя, фамилия, «О себе» и ник. TERVIO читает профиль из Telegram при каждом открытии номера. «Загрузить фото» — выбрать картинку и кадр для кружка, «Убрать фото» снимает текущее (если у номера есть фото старше, Telegram покажет предыдущее). Имя — до 64 знаков, фамилия — до 64, «О себе» — до 70, с Telegram Premium — до 140. Ник — от 5 до 32 латинских букв, цифр и _, первой — буква; пустой ник снимает его. Смену и снятие ника TERVIO переспрашивает: старые ссылки t.me перестанут вести на номер. Ник занят или Telegram просит подождать — изменения не сохраняются, и TERVIO пишет, что делать. Менять профиль номеру на паузе нельзя. Меняйте его нечасто: частая смена может насторожить Telegram.
  • Новые чаты — переключатель «Заводить новые чаты и звать в них клиентов» и поле «не больше … чатов в сутки»: от 1 до 25, пусто — норма платформы, её число написано под полем. Выключите у номера, который только принимает переданные чаты. Поднимая предел, риск берёте на себя: за создание чатов Telegram ограничивает номер чаще всего.
  • Сообщений в час — поле «не больше … в час»: от 1 до 120, пусто — норма платформы. Сверх предела воронки и рассылки ждут следующего часа; ответы клиентам, которые писали последние полчаса, сниженный предел не урезает. Действует сразу.
  • Облачный пароль — нужен, чтобы при передаче чата номер сам передал права владельца группы и вышел из неё. TERVIO проверяет пароль у Telegram и показывает только отметку «сохранён»; «Стереть» его убирает. Как работает передача — «Настройки» → «Проект» → «Воронка».

Беды номера и что делать

  • «Флуд» и «карантин» — номер на связи и принимает входящие (новые чаты тоже появляются в TERVIO), закрыта только отправка. Такая пауза снимается сама, когда выйдет срок, — если на номере нет ограничения Telegram по жалобам.
  • Пауза Telegram от суток — «заморожен» — так TERVIO отличает «притормозил» от наказания. Номер остаётся на приёме, но с него ничего не уходит и ничего не копится: сообщения клиентам отменяются сразу, с отметкой в переписке, воронки этого номера стоят. Когда срок выйдет, номер сам в работу не вернётся: TERVIO напишет, что его можно вернуть, и в раскрытой строке заработает кнопка «Вернуть в работу». Раньше срока она не срабатывает, при ограничении по жалобам — тоже. Вернули — начните с малого: номер только что наказан.
  • Срок паузы вышел, а номер не пишет — так выглядит ограничение самого Telegram по жалобам: свою паузу TERVIO снимает по часам, чужую снять не может. Статус меняется на «частичный бан» и перестаёт обещать время снятия. Лечится только апелляцией через @SpamBot с самого номера. Об ограничении TERVIO пишет в уведомлениях один раз, когда его распознаёт, — второго письма по окончании паузы нет.
  • «Частичный бан» и «без новых чатов» — в раскрытой строке над настройками появляется плашка с причиной и датой. Личка и текущие чаты работают. Номер с отметкой «без новых чатов» TERVIO в создание чатов не берёт: новые групповые чаты заводят другие номера, лид не зависает. «Проверить у @SpamBot» спрашивает Telegram, снято ли ограничение, и снимает отметку, если да. «Снять отметку вручную» возвращает номер в создание чатов только внутри TERVIO — у Telegram ограничение от этого не пройдёт.
  • «Лимит групп» — номер состоит в предельном для Telegram числе групп и каналов — 500, у Telegram Premium 1000. Жалобы тут ни при чём: номер пишет и принимает, а новые групповые чаты заводят другие номера. Выйдите с него из старых групп, которые больше не нужны, и нажмите «Снять отметку: старые чаты убраны».
  • «Ссылки отозваны» — Telegram отозвал ссылки-приглашения номера: чаты живы, но войти по ссылке, отправленной раньше, клиент уже не может. Новые ссылки TERVIO выпускает сам, старые нужно отправить заново.
  • Переподключить — номер выпал из работы («заморожен» или «офлайн») — в его строке и на карточке «Здоровья» появляется кнопка «Переподключить». Она возвращает в строй тот же самый номер: переписка, чаты и распределение по операторам остаются на месте, второй аккаунт заводить не нужно. Код Telegram пришлёт в приложение, где номер уже открыт (подробно — «Куда приходит код» выше), его вводят в окне; если на номере включён облачный пароль, спросят и его. Пока код не введён, с аккаунтом ничего не происходит. У остальных номеров то же действие лежит в меню «⋯». Номеру на паузе переподключение вернёт приём сообщений, но отправку не откроет; замороженный после долгой паузы возвращают кнопкой «Вернуть в работу». При бане не поможет: заблокированный номер Telegram не вернёт никаким кодом, тут нужен другой номер.
  • Уведомление на 80 % нормы — когда с номера за час ушло 80 % часовой нормы (но не больше 48 сообщений) или за сутки создано 80 % чатов, в уведомления приходит «Аккаунт подходит к своей норме» (событие «Аккаунту стало тесно» в «Уведомлениях») — TERVIO считает и то, что написали с телефона.

Меню «⋯»

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

«Выйти со всех чатов» и «Удалить аккаунт» не отменяются. Перед нажатием проверьте номер в строке: обе кнопки задевают живых клиентов.

Менеджеры отдела продаж

Карточка внизу раздела. Сюда вписывают ники (@username) менеджеров, которые заходят в групповые чаты со своих Telegram-аккаунтов, — можно несколько через запятую. ID подтягивается сам через номер проекта; если не нашёлся, нажмите «Подтянуть ID». В переписке их сообщения подписаны «менеджер» и не считаются сообщениями клиента в аналитике. Снятая галочка «Активен» — человек больше не считается менеджером.