Принцип налаштування Шлюзу
на боці АТС

Налаштування на стороні АТС (або телефонного модуля CRM) проводиться після підключення сесії до потрібного телеграм-акаунту на стороні @siptg_bot та вибору способу зв'язку з АТС.

Налаштування на боці АТС складається з двох важливих етапів:

• Підключення SIP-транку
• Налаштування маршрутизації дзвінків

На відміну від стандартних телефонних номерів, при дзвінках з телеграм як Caller-ID може надходити одне з трьох значень (user-id, username, телефонний номер акаунта), а при вихідних дзвінках треба дотримуватися ряду обмежень Телеграм для захисту від спаму.

Протестувати проходження дзвінків можна на безкоштовному тарифі, але має ряд обмежень на дзвінки. Зняти обмеження на 1 тиждень можна, підключивши тариф Пробний за 100 руб. Після тестування системи для її використання необхідно підключити один із платних тарифів.

Зверніть увагу особливості налаштування Шлюза з різними CRM системами.

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

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

Залежно від конкретної АТС і методу зв'язку з серверами SIP.TG (який вибирається в роботі, один з трьох), що використовується, процедура підключення транка різниться.

При методі реєстрації PBX->SIP.TG (найпростіший і найчастіше використовуваний) на стороні АТС для транку, що підключається, треба вказати стандартні параметри (сервер, логін, пароль) які виходять в @siptg_bot в розділі /gateway при виборі відповідного способу реєстрації.

За методом реєстрації SIP.TG->PBX на стороні АТС треба отримати реквізити SIP-акаунту для підключення транка (адреса АТС, логін, пароль), які потім треба вказати в @siptg_bot у розділі /gateway для зв'язку відповідного типу.

При методі зв'язку IP-IP на стороні @siptg_bot треба вказати адресу АТС, номер для виклику на стороні АТС (і опціонально поле: значення), після чого здійснити дзвінок з АТС за адресою та портом, отриманим від @siptg_bot у розділі /gateway для відповідного способу зв'язку.

Іноді може знадобитися @siptg_bot для відповідного методу зв'язку також явно вказати використовуваний Worker-сервер (У потрібній країні, або свій), протокол зв'язку (UDP, TCP, TLS), набір кодеків, що використовуються, метод передачі DTMF сигналів.

Докладніше дивіться в інструкції з налаштування на стороні @siptg_bot

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

Вхідні та вихідні дзвінки від користувачів Telegram між Шлюзом та АТС відбуваються однаково, незалежно від способу підключення Шлюзу до АТС.

При вхідному дзвінку від користувача Telegram на аккаунт Шлюзу на АТС передається номер та ім'я, а для вихідного дзвінка достатньо вказати номер користувача в одному з допустимих форматів (userid, username, phone).

Вхідні дзвінки на АТС із Телеграм

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

Після налаштування одержувача вхідних дзвінків можна здійснити тестовий дзвінок на підключений до Шлюзу телеграм-акаунт, щоб переконатися у проходженні вхідних дзвінків.

Важливо! Тестовий дзвінок краще здійснювати з пристрою, де аккаунт Шлюзу не підключено. Дзвінок приходитиме одночасно і в АТС і на всі пристрої, де підключений телеграм-аккаунт Шлюза.

Якщо на АТС стоїть затримка на зняття трубки, дзвінок можна буде прийняти і з програми TelegramАле тоді через АТС такий дзвінок не піде.

Щоб дзвінок надходив тільки в АТС, треба відключити прийом дзвінків на інших пристроях з підключеним акаунтом Шлюзу. Це робиться в установках програми Телеграм для облікового запису Шлюза (☰ → Settings → Notification and Sounds → Calls → Accept calls on this Device).

До дзвінків через Шлюз застосовні будь-які доступні функції АТС для голосових дзвінків: запис дзвінків, переклад та утримання дзвінка, голосове меню, дзвінок групі, суфлювання тощо.

Зверніть увагу на те, з яким Caller-ID надійде вхідний дзвінок, він відповідає параметрам, заданим на стороні @siptg_bot (user-id, username або телефонний номер облікового запису + префікс або суфікс, що використовується).

Також на АТС від Шлюзу передається поле Caller-Name, яке може містити одне або кілька доступних значень про телеграм-користувача (name, username, Phone).

Докладніше про конфігурацію значень, що передаються Caller-ID та Caller-Name (крок 5)

Вихідні дзвінки з АТС до Телеграм

Для здійснення вихідних дзвінків через підключену лінію Шлюзу (транк у телеграм) у налаштуваннях АТС зазвичай необхідно явно вказати, хто з користувачів АТС (співробітників) має відповідне право.

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

Як номер користувача для дзвінка йому в Telegram можна використовувати одне з трьох значень:

• внутрішній user-id користувача (зазвичай використовується з префіксом * або 0, або іншої ознаки, має довільну довжину, від 5 до 20 цифр, є у всіх користувачів)
• номер телефону користувача, прив'язаний до Telegram-акаунту (10 цифр, може бути прихований налаштуваннями приватності)
• username користувача в Telegram (без символу @ на початку, тільки латинські літери та цифри, може бути не встановлений, підтримується деякими АТС)

Ми рекомендуємо використовувати user-id як Caller-ID і номери абонента з префіксом з 0 або *, Це найбільш універсальний спосіб. Але варто пам'ятати, що user-id не можна зателефонувати користувачеві першим, якщо з ним ще не було взаємного листування. Якщо все-таки необхідно зателефонувати користувачеві поза своїм списком контактів, то використовуйте його номер (якщо він не прихований) або username (якщо ваша АТС це дозволяє).

Про префікс перед Caller-ID (user-id або телефонний номер). Щоб відрізняти номери користувачів телеграм (userid або телефонний номер облікового запису) від звичайних телефонних номерів у логах АТС та/або CRM систем зручно задати їм префікс за @siptg_bot при конфігурації зв'язку з АТС (рекомендуємо використовувати символ * чи 0). Якщо встановлено префікс для Caller-ID його важливо зберігати у номері викликаного користувача під час здійснення вихідного дзвінка в Телеграм через підключену лінію Шлюза.

Найпростіший спосіб протестувати вихідні дзвінки в телеграм це здійснити дзвінок у відповідь на вхідний дзвінок (важливо, щоб збігався префікс перед номером, якщо він був заданий).

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