Налаштування Шлюзу на боці @siptg_bot

Через Telegram-шлюз в АТС можна приймати і здійснювати одночасні паралельні дзвінки через єдиний Telegram-Акаунт компанії (до 100 одночасних ліній).

Підключення відбувається у вигляді стандартного SIP-транку (VoIP) до будь-якої офісної або хмарної SIP-АТС, звідки за потрібною логікою дзвінки розподіляються між співробітниками або користувачами АТС.

Ідеальне рішення для відділів продажу та підтримки компаній провідних комунікацію з клієнтами через Telegram.

Крок 1: Вибір Telegram-аккаунта для підключення

Налаштування Telegram-аккаунта для підключення шлюзу для дзвінків у SIP-АТС
  • Визначтеся Telegram-акаунтом, який необхідно налаштувати для переадресації вхідних дзвінків з нього у вашу SIP-АТС та/або здійснення вихідних дзвінків у Telegram (підключати Шлюз можна як безпосередньо з облікового запису, на якому він повинен працювати, так і з облікового запису адміністратора)
  • Зверніться до облікового запису адміністратора @siptg_bot. Якщо бот ще не активовано, запустіть його командою /start
  • Для налаштування функції Шлюзу наберіть команду /gateway або виберіть її з меню бота.

Крок 2: Підключення віртуального пристрою

Налаштування сховища сесій Telegram-аккаунтів для підключення шлюзу для дзвінків у SIP-АТС
Дозвольте @siptg_bot створити та підключити віртуальний пристрій, прив'язаний до потрібного Telegram-акаунту для переадресації дзвінків з нього. Ця процедура запускається натисканням на кнопку «Підключити» і відбувається в 3 кроки:

  • Вкажіть номер телефону Телеграм-акаунта для дзвінків (до якого підключається Шлюз)
  • Виберіть Сховище сесій, що використовується, для пристрою, що підключається (за замовчуванням використовується захищене хмарне Сховище SIP.TG, найшвидший і найпростіший варіант)
  • Вкажіть боту код з офіційного облікового запису Telegram для прив'язки пристрою (код прийде на обліковий запис, до якого підключається Шлюз)
Варіанти використання Сховища сесій
У разі використання хмарного сховища сесій від SIP.TG від вас не знадобиться жодних дій, цей варіант вибраний за замовчуванням на відповідному кроці підключення віртуального пристрою.

Пристрій, що підключається, використовується виключно для перенаправлення дзвінків (якщо явно не вмикається відповідний режим обробки повідомлень ботом, наприклад, для функції текстової Автовідповіді).

Після підключення всі сесії віртуальних пристроїв для облікових записів клієнтів зберігаються на наших захищених серверах.

У разі наявності особливих вимог щодо конфіденційності сесій акаунтів, що зберігаються, можна встановити власне Сховище сесій, зробити налаштування відповідного модуля, після чого вибирати його при створенні сесії віртуального пристрою. Протестувати підключення свого Сховища сесій можна як на платних, так і безкоштовних тарифах.

Докладніше про встановлення власного Сховища Сесій
Примітка щодо 2FA (двофакторної аутентифікації)
При підключеній двоетапній автентифікації нова сесія Telegram для віртуального пристрою SIP.TG може бути створена тільки якщо в якості другого способу підтвердження було вказано резервний email, тоді на нього прийде код підтвердження.

З метою безпеки ми не запитуємо пароль до 2FA від Telegram-Акаунта до якого підключається Шлюз, але змушені його змінити після підключення пристрою, новий пароль для 2FA буде згенерований для облікового запису шлюзу автоматично і показаний ботом, а також висланий на вказаний email.

При використанні інших методів 2FA на час створення сесії двоетапну аутентифікацію необхідно вимкнути, а після створення сесії її можна буде знову включити.

Крок 3: Налаштування реєстрації з SIP-АТС (створення VoIP SIP-Trunk)

Налаштування VoIP Trunk між Telegram та SIP-АТС
SIP-вузлом для встановлення зв'язку з вашою АТС є один із наших Worker-серверів, саме з ними створюється VoIP SIP-Trunk.

Worker-сервера виробляють конвертацію та передачу голосового потоку між Telegram та вашої SIP-АТС.

Можливі 3 способи реєстрації між Worker-серверами SIP.TG та вашою SIP-АТС:
PBX->SIP.TG (АТС реєструється на Worker, найчастіший метод)

У цьому випадку у бота треба отримати реквізити SIP-акаунта, які потім необхідно вказати на АТС для реєстрації при підключенні транка.
Налаштування VoIP Trunk між Telegram та SIP-АТС
SIP.TG->PBX (Worker реєструється на АТС)

  • У цьому випадку роботу необхідно вказати реквізити SIP-акаунта на стороні АТС.
  • Актуальний список IP-адрес наших серверів розташований за цим посиланням, їх необхідно додати в white-лист firewall для АТС.
  • Після збереження реквізитів АТС для активації реєстрації потрібно натиснути кнопку увімкнення.
Налаштування VoIP Trunk між Telegram та SIP-АТС з реєстрацією
IP-IP (зв'язок Worker та АТС без реєстрації)

  • У цьому випадку з АТС необхідно ініціювати дзвінок за адресою IP і порту отриманого від бота для підтвердження IP адреси АТС.
  • Після збереження реквізитів АТС для активації реєстрації потрібно натиснути кнопку увімкнення.
  • Для ідентифікації кількох SIP-акаунтів даного типу, розміщених на одній IP-адресі, передбачена додаткова ідентифікація на основі довільного поля та його значення в SIP-повідомленні.
  • Обов'язково вказуйте поле Номер на АТС для отримання вхідних дзвінків за АТС.
Налаштування VoIP Trunk між Telegram та SIP-АТС без реєстрації
Важлива примітка щодо вибору Worker-сервера
  • У разі використання хмарних серверів SIP.TG вибирати Worker сервер варто у своїй країні.
  • Якщо у вашій країні немає Worker-сервера, а реєстрація з вибраним вами сервером не проходить, спробуйте змінити його та повторити спробу реєстрації.
  • Ви можете використовувати свій Worker-сервер, після встановлення та налаштування адміністратор облікового запису зможе його вибирати (докладніше про встановлення своїх модулів).
Встановлення свого набору кодеків та способу передачі DTMF
За промовчанням для зв'язку з серверами SIP.TG встановлено наступний набір кодеків – opus,g722/16000,alaw,mulaw,g729.

Як метод передачі DTMF сигналів за замовчуванням використовується RFC2833, але підтримуються також методи inband и INFO.

Обидва значення можуть бути змінені за необхідності.

Докладніше про налаштування кодеків
Докладніше про способи передачі DTMF
Налаштування Firewall на стороні АТС
Якщо Ви використовуєте Firewall для захисту АТС, переконайтеся, що актуальні адреси наших Worker-серверів, з яких відбувається підключення до АТС, присутні в white-листі.

Всі IP-адреси наших серверів перераховані у файлі:
https://files.sip.tg/fw.txt

Іноді мережа Worker-серверів оновлюється, про це ми повідомляємо в каналі новин @siptg_news (Рекомендуємо адміністраторам на нього підписатися).
Про інфраструктуру Worker-серверів
Інфраструктура Worker-серверів SIP.TG надійно захищена, сервери за потреби швидко масштабуються, розташовані у різних географічних зонах.

У разі потреби для всіх прив'язаних SIP-акаунтів можна вказати конкретний Worker-сервер, у тому числі розташований на власних серверах.

Для використання власного Worker-сервера (або кількох) встановіть та зробіть налаштування відповідного модуля, після чого вкажіть його в налаштуваннях підключення (на безкоштовних тарифних планах дана можливість НЕ надається).

Докладніше про встановлення власних Worker-серверів
Перевірка стану облікових записів Шлюзу
Створені SIP-акаунти для Шлюзу будуть збережені в розділі /gateway, де для кожного облікового запису відображається його статус:

SIP-аккаунт шлюзу вимкнено
  • Для PBX -> SIP.TG реєстрацій такий статус з'являється, якщо АТС не зареєструвалася на нашому сервері, було введено неправильний логін або пароль, не коректно заповнені параметри підключення, немає доступу до Worker-серверів (заблоковано IP або є проблеми мережі)
  • Для SIP.TG -> PBX реєстрацій такий статус з'являється, якщо введено неправильний логін або пароль, не коректно заповнені параметри підключення, немає доступу до АТС (заблоковано IP або є проблеми мережі) або він був вимкнений вручну.
  • Для IP <-> IP підключень це означає, що SIP-аккаунт на АТС не активний (у цьому режимі використовується UDP, постійного з'єднання немає)

SIP-аккаунт шлюзу підключено
  • Шлюз коректно налаштований та готовий до роботи.
Блокування IP адрес АТС за неправильні паролі
Вказуйте реквізити підключення до серверів SIP.TG акуратно. У нас активований захист від перебору паролів, тому IP-адреса АТС може бути заблокована на довільний період часу, якщо вона підключається до серверів SIP.TG без увімкненої опції реєстрації, з неправильним логіном або паролем, з недовіреним IP тощо.
Обмеження на число SIP-акаунтів для одного Шлюзу
У режимі Шлюз за замовчуванням є обмеження на кількість SIP-акаунтів, що підключаються, в 10 штук. В окремих випадках для розподілу значного навантаження це число може знадобитися збільшити, для цього звертайтеся до служби підтримки.

Крок 4: Перевірка роботи

Перевірка роботи VoIP Trunk між Telegram та SIP-АТС
Якщо всі параметри внесені коректно, SIP-аккаунт позначений зеленим індикатором, то Шлюз готовий до роботи.

Після того, як на стороні АТС буде налаштовано відповідну маршрутизацію дзвінків, можете здійснити тестові голосові дзвінки на підключений Telegram акаунт та/або здійснити дзвінок Telegram-користувачам з вашої АТС.

Докладніше про принцип налаштування на стороні АТС

Крок 5: Конфігурація Caller-ID та Caller-Name

Перевірка роботи VoIP Trunk між Telegram та SIP-АТС
Вкажіть у якому вигляді на АТС повинен передаватися номер абонента. Можна встановити пріоритет значень, а також префікс або суфікс перед значенням, щоб відрізняти дзвінки через телеграм від звичайних дзвінків.

Для Caller-ID є 3 значення:
  • userid (рекомендуємо використовувати як основний, внутрішній Telegram-id користувача, є завжди)
  • username (латиниця та цифри, може бути не встановлений у користувача)
  • phone (телефонний номер, прив'язаний до облікового запису, може бути прихований налаштуваннями приватності)
Також можна вказати, що передавати на АТС як поле Caller-Name.

На етапі первинного налаштування цей крок можна пропустити.

Важливо! Якщо вказується префікс або суфікс для Caller-ID, то при здійсненні вихідних дзвінків з АТС Телеграм їх необхідно зберегти.

Крок 6: Конфігурація функцій користувача

Перевірка роботи VoIP Trunk між Telegram та SIP-АТС
Вкажіть, чи має користувачеві відображати DTMF клавіатуру під час вихідних та вхідних дзвінків з обліковим записом Шлюзу, кнопки Передзвонити та вибору Ліній, а також чи повинна відбуватися обробка текстових повідомлень (для функції Автовідповідь та дзвінків методом Callback).

На етапі первинного налаштування цей крок можна пропустити.

Докладніше про налаштування функцій користувача

Крок 7: Підключення платного тарифу

Тестування на тарифах Безкоштовний та Пробний
На тарифі Безкоштовний (підключений за замовчуванням) діятимуть такі обмеження:
  • тільки 1 лінія (паралельні дзвінки неможливі)
  • сумарно максимум 30 хв розмов на місяць
  • максимальна тривалість дзвінка 2 хвилини

На тарифі Пробний надається до 10 ліній для одночасних дзвінків, решта обмежень знімаються, вартість 100 руб/тиждень. Цей тариф можна підключити лише один раз, працює лише 1 тиждень.
Вартість використання на платних тарифах
Для оплати використовується тариф Gateway-Start або Gateway-Business, вартість розраховується, виходячи з кількості необхідних ліній для паралельних дзвінків.

Тариф Gateway-Start із двома лініями для паралельних дзвінків можна підключити самостійно. При необхідності максимальна кількість ліній для паралельних дзвінків може бути збільшена за запитом.

Для підключення тарифу Gateway-Business (від 10 ліній) та розрахунку його вартості зверніться до служби підтримки. У рамках тарифу Gateway-Business надається пріоритетна технічна підтримка та консультації на етапі впровадження.
Порядок оплати тарифу
Для оплати необхідно:

  • Перейти до розділу /tariff бота @siptg_bot
  • Вибрати тариф для Шлюзу, перейти до налаштування тарифу
  • Вказати необхідні параметри:
Термін оплати у місяцях (від 1 до 12)
Спосіб оплати
Кількість необхідних ліній для паралельних дзвінків (на тарифі Business)

  • Натиснути на кнопку «Почати оплату», дотримуватися вказівок віджету оплати.

Докладніше про способи оплати

Зверніть увагу


Як через SIP.TG приймати дзвінки з Telegram на стороні АТС, а також здійснювати вихідні дзвінки від імені єдиного Telegram-акаунту компанії

Що бачать користувачі при дзвінках на єдиний Telegram-Акаунт через SIP.TG, набір доступних для них функцій (DTMF, Автовідповідь, вибір Лінії, кнопка Передзвонити, вказівка ​​внутрішнього номера та дзвінок через Callback)

Обмеження та специфіка здійснення голосових дзвінків у Telegram через Шлюз SIP.TG

Особливості інтеграції Шлюзу SIP.TG для Telegram-дзвінків з CRM системами, прийом вхідних та здійснення вихідних дзвінків Telegram-користувачам через АТС

Способи оплати шлюзу SIP.TG для перекидання дзвінків між Telegram та SIP-телефонією

Призначення, переваги, порядок встановлення та налаштування власних Worker-серверів для SIP.TG

Призначення, переваги, порядок встановлення та налаштування власного Сховища сесій Telegram для SIP.TG