Взаимодействие с АТС
Взаимодействие с АТС происходит через SIP-подключения, которые совместно настраиваются как на стороне АТС, так и на стороне SIP.TG.
Чтобы создать SIP подключение на стороне SIP.TG:
Ниже приведено описание специфичных настроек для каждого типа SIP-подключения.
Из таблицы видно, что каждый идентификатор имеет серьёзные ограничения, не позволяющие его использовать во всех сценариях. SIP.TG поддерживает все типы идентификаторов и их комбинации, а также позволяет задавать приоритет их использования под свои нужды.
Такой Caller ID в разных ситуациях может принимать все три типа идентификаторов, в зависимости от того, какие из них имеются у пользователя:
Кроме Caller ID, поле From также может содержать имя абонента (Caller Name), формированием которого можно также управлять при помощи аналогичны правил, но помимо перечисленных выше параметров есть ещё два:
В зависимости от наличия у пользователя Номера телефона и Username, будет использоваться:
Чаще всего взаимодействие устроено так:
- Запустите бота @siptg_bot и перейдите в раздел
/gateway. - Выберите сессию Telegram, которую хотите подключить к АТС, либо создайте новую при помощи кнопки «Подключить» (подробнее см. Пошаговое подключение сессии).
- Нажмите одну из кнопок для создания нового SIP-подключения, соответствующую типу подключения: «🆕 PBX→SIP․TG», «🆕 SIP․TG→PBX» или «🆕 IP⇿IP».
Настройка SIP-подключения к АТС
Большинство настроек отображаются прямо на кнопках в виде текущих значений. Чтобы изменить эти настройки, достаточно нажать соответствующую кнопку и ввести новое значение по запросу бота. Однако некоторые кнопки работают по-другому:- Worker: при нажатии появляется список доступных Worker-серверов. Выберите нужный сервер из списка, чтобы увидеть его подробное описание и назначить.
- Кнопки с флажками, такие как «DTMF вх.», «DTMF исх.», «Перезвонить», «Линии», «Обработка сообщений», «Callback» и «Поделиться подпиской», работают как переключатели. Одно нажатие активирует или деактивирует опцию.
- Протокол соединения (UDP/TCP/TLS): при каждом нажатии происходит переключение на следующий доступный протокол.
- Показать аккаунт и Сбросить пароль: отображают параметры подключения к SIP.TG, которые нужно указать на стороне АТС.
Worker сервер
Worker сервер
Позволяет выбрать сервер, который будет соединяться с АТС или провайдером телефонии.Предусмотрено 3 типа серверов:
На бесплатной подписке доступны только некоторые из публичных серверов SIP.TG.
| Тип сервера | Описание | Обозначение |
|---|---|---|
| Публичные сервера SIP.TG | Основные сервера, поддерживаемые SIP.TG | ✅ |
| Публичные сервера других пользователей | Общедоступные сервера, размещённые другими пользователями | 🌐 |
| Приватные сервера | Ваши собственные сервера, доступные только для ваших SIP-аккаунтов | 🔑 |
Аудиокодеки
Аудиокодеки
Выбор кодеков влияет на качество и совместимость голосовой связи. Поддерживаются кодеки Opus, alaw, mulaw, GSM и другие.
Методы передачи DTMF
Методы передачи DTMF
DTMF необходим для взаимодействия с голосовым меню. Доступны методы RFC2833 (рекомендуется), INFO и inband.
Правила преобразования номеров
Правила преобразования номеров
Позволяют задать формат набора номера для совместимости с АТС. Подробнее в разделе «Правила преобразования номеров».
Приоритет
Приоритет
Приоритет позволяет задать порядок вызова SIP-аккаунтов при звонке Telegram → SIP.Применяются следующие правила:
- Аккаунты с одинаковым приоритетом вызываются одновременно.
- Чем меньше приоритет, тем раньше вызываются SIP-аккаунты.
- Переход к следующему приоритету происходит после неуспеха дозвона на все SIP-аккаунты предыдущего приоритета.
Caller ID и Caller Name
Caller ID и Caller Name
Правила формирования идентификатора (Caller ID) и отображаемого имени (Caller Name) абонента при звонке, которое применяется к обоим направлениям.Подробнее см. Типы идентификаторов абонента.
PBX → SIP.TG
В этом режиме ваша АТС регистрируется на SIP.TG как SIP-клиент. Вы получаете SIP-логин и пароль от бота и указываете их в вашей АТС.Это наиболее простой способ подключения и подходит для большинства систем (Asterisk, 3CX, FreePBX и др.).
Скриншот с настройками SIP-подключения PBX→SIP.TG
Показать аккаунт и Сбросить пароль
Показать аккаунт и Сбросить пароль
Показывают логин, пароль и адрес подключения текущей SIP-линии, которую необходимо зарегистрировать на стороне вашей АТС.«Сбросить пароль» предварительно генерирует новый SIP-пароль для данной линии. После сброса его необходимо будет обновить на стороне АТС.
Доверенные IP
Доверенные IP
Список IP-адресов и подсетей, с которых разрешено подключение к данному аккаунту.
SIP.TG → PBX
Здесь Worker-сервер SIP.TG регистрируется на вашей АТС. В боте вы задаёте параметры вашей АТС: логин, пароль и адрес.Не забудьте добавить IP-адреса SIP.TG в белый список на вашей АТС. Актуальный список: files.sip.tg/fw.txt.
Скриншот с настройками SIP-подключения SIP.TG→PBX
Логин, Пароль, Домен и Прокси
Логин, Пароль, Домен и Прокси
Основные параметры подключения, которые нужно заполнить чтобы подключение к вашей АТС было возможным.«Прокси» можно заполнять только в том случае, если он отличается от «Домена».
Номер на АТС
Номер на АТС
Когда пользователь нажимает кнопку звонка 📞 в приложении Telegram без отправки любых сообщений — этот номер будет использоваться в качестве номера по умолчанию, который поступит в АТС.
IP ⇿ IP
Обе стороны знают IP-адрес друг друга. Используется в случаях, когда регистрация невозможна или не нужна (например, статическая маршрутизация).Подходит для продвинутых пользователей. Требует настройки маршрутов на стороне АТС.
Скриншот с настройками SIP-подключения IP⇿IP
Адрес:порт
Адрес:порт
IP-адрес и порт противоположной стороны (вашей АТС).Чтобы подключение состоялось, на стороне АТС нужно также создать подключение с конкретным IP-адресом сервера SIP.TG. Для этого используется IP-адрес Worker-сервера, назначенный SIP-подключению.Текущий IP-адрес используемого Worker-сервера отобразится в сообщении, когда вы запросите изменение текущего параметра.
Поле:Значение
Поле:Значение
Если вы хотите использовать несколько SIP-подключений между одинаковыми IP-адресами, это поле позволяет задать дополнительный SIP-заголовок для корректной идентификации подключения.Параметр задаётся в виде пары
{название SIP поля}:{значение SIP поля}, разделённое двоеточием :.Номер на АТС
Номер на АТС
Когда пользователь нажимает кнопку звонка 📞 в приложении Telegram без отправки любых сообщений — этот номер будет использоваться в качестве номера по умолчанию, который поступит в АТС.
Типы идентификаторов абонента
Каждый пользователь Telegram может иметь до трёх типов идентификаторов:- Номер телефона, на который зарегистрирован аккаунт. Он имеется всегда, но по умолчанию скрыт настройками приватности для чужих пользователей. С большими ограничениями, но по номеру телефона можно устанавливать контакт с пользователем.
- Username — это уникальное буквенное имя пользователя. По умолчанию его нет, многие пользователи его устанавливают, но строго говоря оно может отсутствовать. А может быть наоборот — пользователь может иметь несколько коллекционных Username. По Username можно устанавливать контакт с пользователем и ограничения сильно мягче, чем для Номера телефона, но облачные АТС часто не предусматривают использование нечисловых идентификаторов абонента.
- User ID — внутренний числовой идентификатор. Есть всегда, никогда не меняется, но устанавливать контакт с пользователем только по User ID невозможно — его можно использовать только после того как контакт был установлен одним из других способов.
| Тип идентификатора | Формат | Возможность контакта | Обязательное | Изменяемое | Поддержка АТС |
|---|---|---|---|---|---|
| Номер телефона | числовой | ограниченная | да | да | да |
| Username | буквенный | да | нет | да | ограниченная |
| User ID | числовой | нет | да | нет | да |
Telegram → АТС
Для каждого SIP-подключения можно установить правила формирования Caller ID, который будет передаваться в полеFrom в сообщении INVITE при звонках Telegram → АТС.
Правила формирования Caller ID представляют собой несколько строк, по одному правилу в каждой строке. Каждое правило — это шаблонная строка, в которой в качестве шаблонных параметров допустимы {phone}, {username} и {userid}. При формировании финального Caller ID используется первое правило, все шаблонные параметры которого содержат значения о звонящем пользователе Telegram.
Примеры формирования Caller ID
Примеры формирования Caller ID
- Если Номер телефона не скрыт — будет использован он.
- В противном случае, если установлен Username — система выберет его.
- И лишь в самом исключительном случае будет использоваться User ID с префиксом
0— эта метка позволяет разрешать неоднозначность в интерпретации типа идентификатора.
{name}— отображаемое имя в UTF-8 (из-за смайликов может вызвать проблемы на стороне АТС);{name_ascii}— отображаемое имя, преобразованное в ASCII (безопасный вариант).
Пример формирования Caller Name
Пример формирования Caller Name
- либо Номер телефона с префикстом
+, за которым следует отображаемое имя, записанное в скобках, - либо Username с префиксом
@,з а которым также следует отображаемое имя, записанное в скобках, - либо в самом крайнем случае — просто отображаемое имя без посторонних символов.
АТС → Telegram
При получении запросаINVITE со стороны АТС, вызываемый идентификатор будет интерпретироваться в полном соответствии с тем же параметром Caller ID, который описан выше. Однако, алгоритм определения типа идентификатора и отсечения в нём префиксов и посторонних символов уже не выглядит так очевидно.
Подробный алгоритм обработки правил
Подробный алгоритм обработки правил
Как и в случае звонков Telegram → АТС, правила проверяются последовательно и выбор останавливается на первом, которое удовлетворяет заданным критериям после преобразований:
- Все шаблонные параметры в правиле заменяются соответствующими им регулярными выражениями:
{phone}→+?[1-9]\d*: число, которое не может начинаться на0и опционально может начинаться с символа+;{username}→@?[a-zA-Z]\w*: буквенно-числовая строка, которая может начинаться только с буквы и опционально с префиксом@;{userid}→[1-9]\d*: число, которое не может начинаться на0и не может иметь префиксов.
- В результате п.1 получается комплексное регулярное выражение, на предмет соответствия которому и проверяется поступивший идентификатор из INVITE URI.
- В результате удовлетворения регулярному выражению, хотя это несёт лишь теоретический смысл, в идентификаторе может быть распознано сразу несколько типов идентификаторов. В таком случае будет выбрано первое значение в указанном порядке:
{userid},{username},{phone}.
Интеграция с CRM
Интеграция с CRM обычно реализуется не напрямую с SIP.TG, а через АТС, в которую SIP.TG подключается как стандартный SIP-транк. Сама CRM «видит» звонки и контакты благодаря возможностям АТС. Отдельных модулей или плагинов именно для SIP.TG в CRM устанавливать, как правило, не требуется.
- Telegram-звонок поступает на Шлюз SIP.TG (аккаунт Telegram).
- Шлюз SIP.TG конвертирует звонок в SIP и передаёт его в АТС (по SIP-транку).
- АТС, обладая нужным модулем или плагином интеграции с CRM, распознаёт входящий вызов, отображает карточку клиента, логирует звонок или выполняет другие действия.
- По окончании разговора данные о звонке (например, длительность, результат) тоже сохраняются в CRM.
Как АТС узнаёт о номере клиента?
Как АТС узнаёт о номере клиента?
Почти любая современная АТС при входящем или исходящем звонке может использовать SIP-заголовки (CallerID, From и т. п.), чтобы «пробросить» данные в CRM-модуль. При звонках из Telegram через Шлюз SIP.TG в SIP-транк передаётся идентификатор звонящего (чаще всего отображается как Telegram ID или username), а уже логика в АТС сопоставляет этот идентификатор с записями CRM.Если ваша АТС умеет управлять CallerID для исходящих вызовов (например, «подставляет» нужный номер), то CRM может автоматически записать в карточку и реальный телефонный номер, и контакты из Telegram. Но деталей у каждой CRM и АТС — масса; в целом это не регулируется напрямую со стороны SIP.TG.
Как инициировать вызов из CRM?
Как инициировать вызов из CRM?
Если CRM «умеет» инициировать вызов (например, чтобы кликнуть на номер и позвонить), она обычно делает это через АТС, шлёт туда команду Call API или AMI (Asterisk, 3CX и т. п.). Дальше АТС переводит запрос в SIP-транк SIP.TG, а Шлюз звонит в Telegram. Всё это снова стандартное взаимодействие «CRM → АТС → SIP-транк», где SIP.TG просто выполняет роль оператора связи для Telegram.
Пример настройки
Пример настройки
- В АТС создаёте учётную запись (SIP-транк) с реквизитами, выданными при настройке
/gatewayв @siptg_bot. - В CRM активируете готовый плагин или модуль (для Asterisk, 3CX, FreePBX, Yate и т. п.) либо настраиваете внешние запросы к АТС по её API.
- Проверяете, что CRM получает события о звонках (всплывает карточка, пишутся логи) и при необходимости подключаете более глубокую логику (распределение вызовов, привязка записей разговора, автоматизация).
- Для исходящих звонков из CRM — проверяете, что АТС может сформировать вызов по SIP-транку «SIP.TG» (обычно выбирается маршрут или правило набора для такой линии).
Когда нужна дополнительная настройка
1
Расширенные поля SIP-заголовков
Если ваша CRM формирует или ожидает какие-то специфические заголовки (например, X-CRM-ID), то такие ситуации решаются средствами вашей АТС (AGI-скрипты в Asterisk, кастомные настройки в 3CX и т. п.). На стороне SIP.TG нет возможности напрямую влиять на произвольные SIP-заголовки.
2
Нужен переадресовываемый CallerID
В некоторых случаях CRM требует видеть исходный номер звонящего полностью (например, для «привязки» к конкретному клиенту). Если звонок из Telegram, то номер может быть любым (или отсутствовать вовсе), и тут уже от логики вашей АТС зависит, как подставлять CallerID. Иногда добавляют дополнительную базу соответствия «Telegram ID → телефон клиента».
3
Включение записи разговоров в CRM
Запись разговоров можно включить как в самой АТС, так и в режиме «Запись звонков» на стороне SIP.TG (в Софтфоне). Если хотите хранить записи именно в CRM, уточните, умеет ли ваша АТС передавать файлы записи туда. С точки зрения SIP.TG, это «прозрачная» передача звука по SIP, и дополнительных настроек для записи нет.
Дополнительные советы
- Единый подход: все настройки, связанные с CRM, обычно выполняются в интерфейсе вашей АТС. Вы воспринимаете SIP.TG как обычного оператора связи (SIP-транк).
- Типичные АТС (Asterisk, 3CX, FreeSWITCH, Yate, Oktell, Panasonic и прочие) имеют плагины или REST-интерфейсы для интеграции с CRM. Изучите документацию АТС: скорее всего, там есть готовый пример.
- Сценарии приёма и маршрутизации вызовов (IVR, очередь операторов, автоматическая переадресация) — всё это общие функции АТС. Шлюз SIP.TG не ограничивает и не усложняет такие сценарии: они работают так же, как и при других SIP-транках.
Не усложняйте. Чтобы «подружить» CRM с Telegram-звонками, достаточно подключить Шлюз SIP.TG к вашей АТС и использовать стандартные инструменты интеграции CRM, которые есть в АТС.Если возникли проблемы или ошибки, воспользуйтесь разделом Вопросы и решение проблем.