LogoLogo
www.mikopbx.ruTelegram сообществоФорум
Russian
Russian
  • Руководство по MikoPBX
    • Быстрое начало работы
    • Знакомство с MikoPBX
    • Системные требования
  • Установка
    • Отдельный компьютер
    • Виртуальные машины
      • VMware ESXi
      • VMware Fusion
      • VirtualBOX
      • VMware Workstation Pro
      • Hyper-V
      • Proxmox
    • Облачные сервисы
      • Yandex Cloud
        • Магазин приложений
        • Произвольный образ
        • Коммандная строка YC
      • VK Cloud
      • 1С:Облачная инфраструктура
      • AWS
        • AWS подробная инструкция
        • AWS Маркетплейс
      • Microsoft Azure
      • Google Cloud
        • Google Cloud подробная инструкция
        • Google Cloud Маркетплейс
      • Hetzner cloud (Empty)
      • Vscale
      • Selectel
      • DigitalOcean
      • Alibaba cloud
      • Vultr
    • В Docker контейнере
      • Установка докера и cоздание пользователя и каталогов
      • Запуск MikoPBX в контейнере
      • Запуск MikoPBX с помощью docker compose
  • Руководство пользователя
    • Телефония
      • Сотрудники
      • Очереди вызовов
      • IVR меню
      • Конференции
      • Звуковые файлы
      • История вызовов
    • Маршрутизация
      • Провайдеры телефонии
      • Входящие маршруты
      • Исходящие маршруты
      • Нерабочее время
    • Модули
      • Регистрация в маркетплейсе модулей
      • Управление модулями
      • Приложения диалпланов
    • Обслуживание
      • Обновление системы
        • Обновление из web-интерфейса
        • Обновление из консоли MikoPBX
        • Обновление Docker
      • Диагностика системы
      • Перезагрузка и выключение системы
    • Сеть и Firewall
      • Сетевые интерфейсы
      • Сетевой экран
      • Защита от взлома
    • Система
      • Общие настройки
      • Дата и время
      • Почта и уведомления
        • Настройка E-mail уведомлений для почтового сервиса Gmail
        • Настройка E-mail уведомлений для почтового сервиса Yandex
        • Настройка E-mail уведомлений для почтового сервиса Mail.ru
      • Доступ к AMI
      • Кастомизация системных файлов
  • Часто задаваемые вопросы
    • Интеграция с 1С
      • Перехват на ответственного
        • Перехват на ответственного в панели телефонии 4.0 как в панели 1.0
        • Отменить перехват на ответственного для конкретного провайдера
    • Установка
      • Установка на MDADM RAID1
      • Тонкая настройка firewall
      • Перенос MikoPBX на другой сервер
        • Перенос с помощью резервного копирования
        • Перенос с помощью резервного копирования по расписанию
        • Перенос с помощью rsync
      • Сброс к заводским настройкам
      • Мониторинг провайдеров на MikoPBX
    • Обслуживание
      • Изменить имя для авторизации
      • Закончилось место на доп. диске, увеличение размера диска
      • Закончилось место на доп. диске, перенос данных на новый диск
      • Хранение записей в общей папке windows
      • Резервный интернет и перерегистрация провайдеров
      • Сброс пароля администратора из консоли MikoPBX
    • Диагностика проблем
      • Подключение к АТС с помощью SSH
        • Подключение к АТС с помощью SSH-клиента (Putty)
        • Подключение с помощью SSH (Windows)
        • Подключение с помощью SSH (Linux/MacOS)
      • Подключение к АТС с помощью WinSCP
      • Получение логов с помощью приложения tcpdump
      • Снятие лога в АТС с помощью Wireshark
      • Анализ трафика средствами Sngrep
      • Настройка громкости
      • Решение проблем со звуком
      • Настройка Jitter
    • Входящая маршрутизация
      • Выбор провайдера при переадресации на мобильный
      • Уведомление о занятости, Call Waiting
      • Маршрутизация по DID номеру
      • Черные и белые списки
      • Разрешить донабор внутреннего номера в очереди
      • Нормализация входящего номера телефона
      • Настройка индивидуального нерабочего времени для учетной записи провайдера
      • Вывод информации о did-номере
      • Пример реализации типового маршрута входящих вызовов
      • Базовый пример IVR
    • Исходящая маршрутизация
      • Добавить P-Preferred-Identity и Remote-Party-ID заголовок
      • Конференция с постоянным внешним абонентом
      • Исходящий с набором внутреннего номера
      • Убрать все спецсимволы из набираемого номера
      • Запрет звонка через резервный маршрут
      • Звонки на экстренные номера
      • Звонок через определенного провайдера
      • Шаблоны номеров
        • Равномерное распределение исходящих
        • Удаление кода города из номера
        • Добавление префикса "8" к номеру
        • Замена префикса номера с "8, 7" на "+7"
        • Замена префикса номера с "+7" на "8"
        • Пример шаблона: звонки в другую страну (Украина, Беларусь, Латвия)
        • Как запретить замену "+" на "00"
        • Нормализация набираемого номера телефона
    • Сценарии и кейсы
      • Программное создание сотрудников
      • Уведомление в телеграмм о пропущенных
      • Позвонить в компанию с мобильного и набрав добавочный позвонить сторонней компании
      • Отправка входящего факса на email
      • Оценка клиентом качества обслуживания
      • Имитация внешних звонков
      • Отключение "нерабочего времени" для VIP номеров
      • Регистрация нескольких учетных записей от одного провайдера
      • Настройка индивидуального нерабочего времени для нескольких провайдеров, на одном хосте
      • Отключить переадресацию на мобильный для внутренних звонков
      • Уникальная фоновая музыка для очереди
      • Пауза для агента очереди
      • Динамические агенты очередей
      • Настройка функции "Paging"
      • Ограничить количество авторизаций на одном SIP аккаунте
      • Как реализовать функцию супервизора
      • Голосовая почта
      • Конвертация истории звонков FreePBX -> MikoPBX
      • SSL сертификат для web-интерфейса MIKOPBX от OPNSense
      • Скрытие номера от сотрудника
    • Соединение нескольких АТС
      • Объединение двух MikoPBX
      • Объединение MIKOPBX и Grandstream UCM6202
      • Объединение MikoPBX и FreePBX (PJSIP)
      • Объединение MikoPBX и FreePBX (IAX)
    • Настройка провайдеров
      • Ростелеком
      • MTT
      • Zadarma (Novofon)
      • Мегафон
      • Билайн
      • МТС
      • UIS (uiscom.ru)
      • MANGO OFFICE
      • dom.ru
      • Яндекс телефония
      • NEW-TEL
      • sip.tg
      • Lifecell
      • SIP Коннектор Bitrix24
      • ID Phone(Казахтелеком)
      • Имитация внешних входящих и исходящих звонков
      • Телфин
    • Настройка софтфонов
      • Bria Solo
      • Sessiontalk
      • Groundwire
      • MicroSIP
      • Zoiper
      • Jitsi
      • PhonerLite
      • Linphone (MacOS)
      • Telephone(MacOS)
      • Настройка WebRTC клиента SIPML5
      • Softphone.pro
      • 3CX Softphone
      • PortSIP
      • SIP.tg (Telegram)
    • Voip шлюзы
      • GoIP4
        • SMS в Telegram
      • Yeastar NeoGate TG 400
      • Grandstream HT503
      • Звонки через 3G модем Huawei E173 (chan_dongle)
    • IP-Телефоны
      • Snom D120
      • Yealink T19
      • Yealink T21
      • Yealink T28
      • Fanvil X3SP
    • Перестает работать сеть в MikoPBX
  • Модули
    • Модули МИКО
      • Интеграция с 1С
        • Панель телефонии 1.0 для 1С
        • Панель телефонии 4.0 для 1С
        • Модуль умной маршрутизации
      • Интеграция с amoCRM
        • Описание функционала amoCRM
        • Настройка интеграции с amoCRM
      • Интеграция с CRM Bitrix24
        • Описание функционала CRM Bitrix24
        • Настройка интеграции с Bitrix24
      • Управление телефонными группами
      • Резервное копирование
      • Автоматическая настройка телефонов
      • Автообработка пропущенных
      • Let's Encrypt
      • Управление доступом в систему
      • Модуль Автоинформатор
      • Оценка качества разговора
      • Синхронизация с LDAP/AD
      • Провайдер для звонков Telegram
      • Zabbix агент
      • Телефонная книга
      • Расширенная история звонков
  • Прочее
    • История версий
      • MikoPBX 2024.1
      • MikoPBX 2023.2
      • MikoPBX 2023.1.223
Powered by GitBook
On this page
  • Настройка Telegram
  • Аккаунт
  • Telegram Bot
  • Получение "App api_id" и "App api_hash"
  • Настройки модуля MikoPBX
  • Настройка провайдера
  • Входящий маршрут
  • Исходящий маршрут

Was this helpful?

Edit on GitHub
Export as PDF
  1. Модули
  2. Модули МИКО

Провайдер для звонков Telegram

Last updated 1 year ago

Was this helpful?

Поддержка модуля приостановлена, проблема в базовой библиотеке, пока она не будет решена, модуль не будет корректно работать. Рекомендуем использовть сервис https://www.sip.tg/

Обратите внимание: Все данные авторизации / секретные коды / данные переписки Telegram используются исключительно ЛОКАЛЬНО на вашей АТС и НЕ передаются на сервера МИКО.

Модуль состоит из нескольких компонент:

  • Шлюз SIP ↔ Telegram - позволяет принимать звонки от telegram и совершать исходящие звонки через telegram. Шлюз не зависит от прочих компонент, они лишь его дополняют

  • Телеграм клиент - работает совместно с ботом, во время входящего звонка звонящему отправляется клавиатура для ввода добавочного номера.

  • Телеграм бот - служит для формирования клавиатуры и отправки тональных команд в текущий канал. Для работы необходимо предварительно получить токен через интерфейс бота «@BotFather»

При звонке в компанию клиенту будет отправлена с сообщением клавиатура для ввода добавочного номера:

После завершения звонка клавиатура будет скрыта.

После неудачного звонка из компании (клиент не ответил). Клиенту будет отправлена визитка:

Текст визитки и клавиатуры ввода добавочного можно исправить в настройках модуля:

Screenshot here!

Настройка Telegram

Аккаунт

Необходимо настроить видимость номера телефона в разделе "Конфиденциальность" , а так же разрешить Всем звонить на номер телефона в разделе "Звонки":

Telegram Bot

Создайте бота

  1. Откройте чат с @BotFather в любом удобном клиенте Телеграм

  1. Отправьте команду

/newbot
  1. Введите «name» нового бота, к примеру new_keyboard_bot, имя должно быть коротким и понятным, имя увидит клиент при получении клавиатуры

  2. Введите «username» для нового бота, к примеру newest_keyboard_bot

Включите Inline Mode

  1. Отправьте боту команду

    /setinline
  2. Выберите созданного ранее бота

Получите Token

  1. Отправьте команду

    /mybots
  2. Выберите созданного ранее бота

  3. Кликните по кнопке «API Token»

  4. Скопируйте значение «token»

Начните диалог с ботом

  1. Отправьте из аккаунта телеграмм вашему боту команду

    /start
  2. Напишите боту произвольное сообщение, к примеру «Привет!»

С ботом должен быть открытый диалог, если не отправить ему команду «/start», то часть функционала работать не будет.

Получение "App api_id" и "App api_hash"

  1. Укажите номер телефона, привязанный к telegram аккаунту

  2. Перейдите в раздел «API development tools»

  1. Опишите параметры нового приложения:

  • «App title» - заголовок приложения

  • «Short name» - уникальное короткое имя приложения

  • «URL»- произвольный адрес сайта

  • «Platform» - Other

  • «Description» - произвольное описание

Выполните действие «Create application»

  1. Скопируйте значения «App api_id» и «App api_hash»

Настройки модуля MikoPBX

При восстановлении из бекапа может потребоваться повторная авторизация в telegram.

  1. Установите дополнительный модуль «Провайдер Telegram», (см. инструкции по установке модулей в разделе Управление модулями)

  2. Ведите значения «App api_id» и «App api_hash», полученные на предыдущем этапе, а так же Token бота, который вы получили при создании бота.

Сохраните изменения

  1. Добавьте новый номер по кнопке «Добавить»

  2. Запустите процесс авторизации для Шлюза, Клиента Telegram, для Бота

  1. Авторизуйте все линии. После подключения отобразится "Линии подключены". Подключенные каналы отобразятся зеленым цветом.

Кнопки авторизации отображают статус подключения:

  • Красный - Необходима авторизация

  • Оранжевый - Ожидается запуск сервиса

  • Зеленый - Соединение установлено

В любом из состояний возможно запустить процесс авторизации заново.

  • /storage/usbdisk1/mikopbx/custom_modules/ModuleTelegramProvider/db/7906660000

  • /storage/usbdisk1/mikopbx/custom_modules/ModuleTelegramProvider/db/madeline/7906660000

где 7906660000 - номер телефона, логин телеграмм аккаунта

Настройка провайдера

  1. Скопируйте адрес и порт из активной линии. В нашем случае это 127.0.0.1:30001

  1. Добавьте нового провайдера

  1. Введите «Название провайдера» - произвольное значение.

Укажите «Тип учетной записи» - «Аутентификация по IP адресу, без пароля».

Введите «Хост или IP адрес» - 127.0.0.1

«Расширенные настройки» - «Порт соединения SIP» - укажите порт линии, в текущем примере «30001»

  1. «Расширенные настройки» - «Отключить использование поля fromuser»

Сохраните изменения

  1. В разделе «Система» -> «Общие настройки» разрешите использование кодека Opus

Входящий маршрут

Порядок определения callerid: Telegram может передавать следующие идентификаторы:

  1. X-TG-Phone - номер телефона

  2. X-TG-Username - ник пользователя

  3. X-TG-ID - идентификатор пользователя

Некоторые идентификаторы могут быть скрыты клиентом в настройках приватности. Caller ID будет установлен исходя из этих полей, X-TG-Phone - имеет наивысший приоритет, X-TG-ID - низший.

Исходящий маршрут

Для настройки входящих маршрутов ознакомьтесь с документацией «Исходящие маршруты»

Обязательно добавить плюс при наборе номера! См. пример ниже.

Пример маршрута:

  • «Название правила» - siptg

  • «Номер начинается с» - 7

  • «Остальная часть номера состоит из указанного количества цифр» - 10

  • «Перед тем как начать звонок отсекаем» - 0

  • «цифр в начале номера, затем добавляем в начало » - символ плюс »+«

«App api_id» и «App api_hash» - это секретные параметры, которые привязываются к вашему telegram аккаунту. Никому не сообщайте эти значения! Они необходимы для подключения к API Telegram. Подробнее можно почитать в .

Перейдите по ссылке

В случае возникновения проблем, может потребоваться очистить служебные каталоги ():

Перейдите в раздел ""

Для настройки входящих маршрутов ознакомьтесь с документацией «»

документации
https://my.telegram.org/auth
с помощью SSH-клиента
Провайдеры телефонии
Входящие маршруты
Клавиатура для ввода добавочного номера
Визитка
Настройки приватности номера телефона
@BotFather
@BotFather
Inline Mode in @BotFather
Hello world to your bot
Telegram page
API development tools
AppParameters
«App api_id» и «App api_hash»
Раздел "Провайдеры телефонии"
Новый провайдер
Настройки провайдера
"Opus"
Исходящие вызовы