Взаимодействие с Telegram
Для работы режима Шлюз необходимо подключить обычный Telegram-аккаунт, через который будут проходить звонки. В этом процессе участвуют две роли: сессия и администратор.
Роли аккаунтов сессии и администратора
- Аккаунт сессии — Telegram-аккаунт, который будет использоваться в качестве источника и получателя звонков. Подключается как виртуальное устройство к SIP.TG.
- Аккаунт администратора — Telegram-аккаунт, который взаимодействует с @siptg_bot и управляет сессией: подключает сессию, может изменять настройки, подключать SIP-АТС и получать уведомления об ошибках.
Один и тот же Telegram-аккаунт может использоваться в обеих ролях. Однако в корпоративной среде рекомендуется разделять их.
Пошаговое подключение сессии
Выбор Telegram-аккаунта
Выберите Telegram-аккаунт, который будет использоваться как шлюз. Убедитесь, что он не используется для личных звонков или переписок.
Подключение к боту @siptg_bot
Перейдите в @siptg_bot и выполните команду /gateway
. Нажмите кнопку «Подключить».
Выбор хранилища сессии
Укажите, где будет храниться сессия:
- Облачное хранилище SIP.TG — просто, быстро и безопасно.
- Собственное хранилище — для компаний с повышенными требованиями к приватности. Подробнее см. Хранилище сессий Telegram.
Ввод номера телефона и подтверждение
Укажите номер телефона выбранного Telegram-аккаунта. На него поступит код от официального аккаунта Telegram, который нужно ввести в бота для авторизации.
Если на аккаунте включена двухфакторная аутентификация (2FA), будет запущен безопасный процесс восстановления: Telegram отправит письмо на связанный email для сброса пароля. Это делается, чтобы не передавать ваш пароль в открытом виде.
Применение Telegram-настроек к аккаунту
Сразу после подключения сессии бот предложит применить рекомендуемые настройки. Они повышают надёжность и удобство приёма звонков:
- Отключить звонки на других устройствах — исключает конфликты, когда вызов поступает одновременно в несколько мест. Позволяет использовать Telegram сессии как канал только для звонков, а остальные устройства — для переписки.
- Разрешить звонки от всех пользователлей — важно, так как по умолчанию звонки от неизвестных номеров блокируются настройками Telegram и не будут доходить до АТС.
- Разрешить P2P звонки ото всех — если поддерживается, позволяет Telegram передавать аудио напрямую, без пересылки через серверы, улучшая качество связи и снижая задержки.
- Запретить добавление в группы — снижает риск получения лишних уведомлений, не связанных с задачами звонков.
Некоторые параметры Telegram можно изменить только спустя 24 часа после подключения аккаунта. Если получите ошибку — попробуйте позже.
Настройки сессии SIP.TG
Скриншот с настройками Telegram-сессии
DTMF вх. и DTMF исх.
DTMF вх. и DTMF исх.
Эти параметры включают или отключают использование DTMF-клавиатуры в разных направлениях звонков:
- DTMF вх. — используется при входящем Telegram-звонке (направление Telegram → SIP);
- DTMF исх. — используется при исходящем звонке на Telegram из вашей АТС (направление SIP → Telegram).
DTMF-клавиатура позволяет:
- взаимодействовать с голосовым меню АТС (IVR);
- вводить внутренние номера;
- отображать информацию о звонящем сотруднике при звонке Telegram-пользователю.
Клавиатура активируется свайпом вверх во время разговора. Поддерживаются режимы передачи (RFC2833, inband, SIP INFO) меняются в настройках SIP подключения и должны быть согласованы с настройками АТС.
Перезвонить и выбор линии
Перезвонить и выбор линии
Включает или отключает кнопки «Перезвонить» и «Линии» для Telegram-пользователей, которые взаимодействуют с аккаунтом шлюза. Кнопки появляется в чате после завершения звонка.
Нажатие на кнопку «Перезвонить» инициирует звонок на внутренний номер в АТС, который использовался во время предыдущего разговора, позволяя связать пользователя с конкретным сотрудником или отделом.
Кнопка «Линии» работает примерно также с той лишь разницей, что перед инициированием звонка отображает подключенные линии, через которые можно сделать звонок.
Обработка сообщений
Обработка сообщений
Включает или отключает возможность реагировать на текстовые сообщения, приходящие в Telegram-аккаунт сессии. При включении открываются дополнительные функции:
-
Callback — после отправки любого сообщения в чат, пользователь получит входящий звонок от шлюза с последующим соединением с отправленным в сообщении номером (либо номером по умолчанию; поведение настраивается в настройках SIP линии).
-
Inline-бот — если для сообщения не найден подходящий SIP-аккаунт для звонка, его можно обработать через внешнего inline-бота.
-
Автоответ — на каждое сообщение отправляется заранее заданный шаблон, например:
Этот аккаунт предназначен только для звонков. Для переписки используйте @support_bot.
Эти функции можно включать по отдельности и настраивать поведение в зависимости от ситуации.
Inline-бот
Inline-бот
Вы можете подключить собственного inline-бота, который будет использоваться для обработки входящих сообщений. Это особенно полезно в случаях, когда сообщение не может быть сопоставлено с номером телефона или не требуется звонок. Inline-бот может:
- отвечать по шаблону;
- собирать заявки;
- интегрироваться с внешними системами, такими как Helpdesk, CRM и др.
Дополнительно можно задать формат inline-запроса, который будет передаваться боту. Это позволяет структурировать обращение пользователя для более точной обработки.
Расширенные действия
Расширенные действия
- Отвязать / Передать — позволяет снять права администратора с текущего аккаунта или передать их другому Telegram-пользователю (см. Роли аккаунтов сессии и администратора).
- Поделиться подпиской — распространить действие подписки администратора на эту сессию (см. Роли аккаунтов сессии и администратора и Дополнительные Telegram-аккаунты).
- Отключить — полностью удалить виртуальное устройство, сбросить сессию и опционально очистить параметры SIP-подключений.