Вопросы и решение проблем
Для корректной работы Софтфона в Telegram необходимо:
- Иметь активную подписку Софтфон в боте @siptg_bot.
- Убедиться, что в настройках конфиденциальности Telegram разрешены голосовые звонки от «Всех» или как минимум от @siptg.
- Правильно указать в боте адрес SIP-сервера (с нужным портом, если он нестандартный), логин и пароль.
- При необходимости настроить аудиокодеки и «Правила набора» так, чтобы они соответствовали требованиям вашей АТС или SIP-провайдера.
Частые вопросы (FAQ)
Софтфон — это когда вы используете Telegram в роли SIP-клиента (привязка к любому оператору SIP).
Шлюз — это когда подключаете Telegram-аккаунт к АТС, чтобы обработка Telegram-звонков происходила средствами АТС.
Да. Голосовой поток через Telegram — это интернет-канал, он не мешает вашим GSM-звонкам.
При создании аккаунта активируйте флажок «Запись звонков». Доступно на платной подписке (5 EUR/мес. за аккаунт). При необходимости, можно выбрать отдельный канал/чат, куда сохранять аудиофайлы.
Да. В разделе /softphone в боте @siptg_bot откройте SIP-аккаунт и нажмите «Отключить».
В боте @siptg_bot откройте настройки нужного аккаунта, нажмите «Пользователь» и выберите Telegram-профиль коллеги. Теперь все входящие вызовы пойдут ему, а вы останетесь Владельцем.
Да, если ваша подписка «Софтфон» позволяет нужное количество аккаунтов. Можно создать несколько SIP-аккаунтов. При исходящих вызовах будет появляться запрос о выборе аккаунта перед каждым звонком.
Если у вас нестандартный порт на стороне оператора или АТС, пропишите в поле «Домен» или «Прокси» через двоеточие (например: sip.example.com:5062). Для стандартного 5060 указывать не обязательно.
Проблемы и отладка
Ниже приведён расширенный список проблем, которые возникали у наших пользователей.
Симптомы
- В Telegram не появляется никакой информации о входящем вызове.
Возможные причины
- Запрещены голосовые звонки на уровне вашего аккаунта Telegram.
- SIP-аккаунт параллельно используется на другом устройстве (в другом Софтфоне, в виджете для звонков через браузер и т.д.).
- Потерялась связь между вашим аккаунтом Telegram и нашим @siptg.
Решение
- Проверьте настройки в Telegram: убедитесь, что в разделе «Конфиденциальность и безопасность → «Голосовые звонки» выбрана опция «Все».
- Обновите пароль SIP-аккаунта на стороне SIP-провайдера или АТС, и укажите новый пароль к аккаунту в разделе
/softphoneбота @siptg_bot. - Откройте чат @siptg и отправьте любое сообщение.
Симптомы
- Когда поступает входящий (или Callback) звонок, пользователь не успевает на него ответить, и в чате @siptg он отражается со статусом «Отклонённый звонок».
- Вследствие этого все входящие звонки автоматически отклоняются на всех устройствах, привязанных к аккаунту Telegram.
Возможные причины
- На одном из устройств приложение Telegram «зависло» в состоянии активного звонка, хотя никаких признаков активного звонка нет.
- Во время входящего звонка вы разговариваете через другое приложение или по мобильной связи и у Telegram нет доступа к микрофону устройства.
- Вы пытаетесь сделать тестовый звонок самому себе. Например, в то время как делаете дозвон по мобильной связи (тем самым блокируя микрофон), вызов поступает в Telegram, и из-за другого активного звонка новый Telegram-звонок отклоняется.
Решение
- Идентифицируйте проблемное устройство: каждое из ваших устройств по очереди необходимо отключать от интернета до тех пор, пока входящие звонки перестанут сбрасываться. После этого проблемное устройство нужно перезагрузить или на нём полностью выгрузить из памяти приложение Telegram.
- Сделать тестовый звонок, в котором участвуют два разных устройства, причём на втором устройстве ваш аккаунт Telegram не используется.
- В случае повторения проблемы, соберите логи с проблемного устройства для дальнейшего анализа и устранения неисправности. Подробнее см. Getting Log Files from Telegram.
Когда вы отправляете номер в чат, бот пытается дозвониться до вас (callback). Если вы не приняли входящий вызов в Telegram, исходящий не состоится.
Что делать:
- Включите уведомления о звонках в Telegram.
- Проверьте, что звонки разрешены от @siptg.
- Подтверждайте входящий вызов в течение 60 секунд.
Такое чаще всего связано с несовместимостью кодеков либо блокировкой UDP-трафика.
Решение
-
В боте @siptg_bot в разделе
/softphone→ Настройка SIP-аккаунта → Аудиокодеки установите краткий список, например:opus,alaw,mulaw.При необходимости укажите конкретный аудиокодек (например, только
alawилиmulaw). -
Если звонок идёт из-за рубежа или через мобильный интернет, попробуйте другой Worker-сервер.
Симптомы
- При исходящем или входящем вызове абонента не слышат, либо звук резко пропадает.
- Звонок сбрасывается в течение 5–10 секунд.
Возможные причины
- Неподходящий или конфликтующий аудиокодек.
- Провайдер или АТС не принимает текущий набор кодеков, либо Telegram не успевает согласовать параметры аудиопотока.
- Неправильная настройка RTP или ошибки в передаче голосовых пакетов.
Решение
-
В боте @siptg_bot в разделе
/softphone→ Настройка SIP-аккаунта → Аудиокодеки установите краткий список, например:opus,alaw,mulaw.При необходимости укажите конкретный аудиокодек (например, только
alawилиmulaw). -
Проверьте настройки Worker-сервера и брандмауэра.
Симптомы
- При попытке совершить исходящий звонок бот сообщает, что отсутствуют доступные линии.
- Возможно, в логах появляется ошибка с кодом, указывающая на недоступность линии.
Возможные причины
- Неверно настроенные «Правила набора», которые исключают корректные номера.
- Превышено количество активных SIP-аккаунтов, разрешённых подпиской.
- Ошибки в параметрах SIP-аккаунта (неверный логин, сервер или пароль).
Решение
- Проверьте и при необходимости сбросьте правила набора, введя значение
=в настройках SIP-аккаунта. - Убедитесь, что общее число SIP-аккаунтов соответствует оплаченной подписке.
- Попробуйте перезапустить SIP-аккаунт через команду
/softphoneв боте @siptg_bot.
Симптомы
- Бот сообщает, что превышены лимиты неуспешных звонков или что текущий SIP-аккаунт не разрешён тарифом.
- Звонки не проходят из-за превышения установленных лимитов.
Возможные причины
- Пользователь самостоятельно активировал SIP-аккаунт без привязки к администрируемой подписке.
- Превышены внутренние ограничения тарифного плана (например, по числу неуспешных попыток).
- Неправильно распределены или активированы SIP-аккаунты.
Решение
- Проверьте, что SIP-аккаунт включён и привязан в разделе
/softphoneбота. - Сверьте число активных аккаунтов с данными в разделе
/subscriptions. - Если аккаунт активирован самостоятельно, свяжитесь с поддержкой для его перенастройки под администрирование.
Симптомы
- При включении SIP-аккаунта появляется ошибка «Неверные параметры (params)». Аккаунт остаётся не подключённым.
Возможные причины
- Не указаны обязательные параметры для подключения: Логин, Пароль и Домен.
- Выбранный Шаблон настроек не содержит предустановленного значения Домен и Прокси для подключения.
Решение
- Установите корректное значение для параметров Домен и Прокси (если он отличается), и повторно включите SIP-аккаунт.
Симптомы
- Запись звонков работает только если её включать вручную во время каждого звонка.
- Запись звонка прерывается через 15 секунд.
Возможные причины
- В настройках SIP-аккаунта не включена настройка «Запись звонков».
- При оплате подписки «Софтфон» не была добавлена опция «Запись разговоров».
Решение
- Проверьте состояние настроек SIP аккаунта. Подробнее см. Настройка Софтфона.
- Подключите опцию «Запись разговоров» в настройках подписки. Подробнее см. Подписка «Софтфон».
Симптомы
- После завершения вызова Telegram продолжает отображать активный статус звонка.
- Новые входящие вызовы не принимаются, а активный вызов мешает совершать последующие звонки.
Возможные причины
- Задержка в передаче уведомления о завершении вызова через сеть Telegram.
- Проблема в клиентском приложении Telegram (особенно на Android), когда приложение не обновляет статус вызова.
Решение
- Обновите Telegram до последней версии.
- Полностью закройте приложение и запустите его снова или перезагрузите устройство.
- Если проблема возникает регулярно, соберите логи и обратитесь в публичную группу за поддержкой.
Симптомы
- Любой исходящий номер не проходит – звонок сразу блокируется с ошибкой (например, 404).
- При наборе номера появляется сообщение, что номер не соответствует правилам.
Возможные причины
- Неверно настроенные регулярные выражения, блокирующие корректные номера.
- Ручное изменение поля «Правила набора» привело к исключению всех номеров.
Решение
- Сбросьте настройки правил набора, введя значение
=в соответствующем поле. - При необходимости используйте корректные RegExp-правила для преобразования номеров, проверив их тестированием.
- Проверьте логи АТС на наличие сообщений о неподдерживаемых номерах.
Симптомы
- При отправке номера в чат с ботом появляется сообщение «Сделайте исходящий звонок», но звонок не доходит, если пользователь не отвечает вовремя.
- Исходящий набор «зависает» в ожидании обратного вызова.
Возможные причины
- Включён режим Callback, и пользователь не успевает ответить на обратный вызов бота.
- В настройках Telegram для бота запрещены входящие звонки.
Решение
- Если Callback не требуется, отключите его в разделе
/softphone. - Если функция нужна, удостоверьтесь, что настройки Telegram позволяют принимать вызовы от аккаунта @siptg.
- 403 Forbidden: неверный пароль/логин, либо оператор заблокировал вас.
- 404 Not Found: неправильный домен SIP или номер абонента не найден.
- 408 Request Timeout: провайдер не отвечает, попробуйте другой Worker или проверьте брандмауэр.
- 503 Service Unavailable: у оператора временные проблемы либо превышены лимиты Telegram (Too Many Requests).
Если у вас в Telegram включено «принимать звонки только от контактов», бот @siptg не сможет дозвониться.
- Включите «Принимать звонки от всех» (Меню → Настройки → Конфиденциальность → Голосовые звонки).
- Или добавьте @siptg в список «Всегда разрешать».
Бывает, когда сервис меняет Worker-сервер, а ваша АТС «запоминает» IP-адрес предыдущего.
- Убедитесь, что на стороне АТС в белом списке все IP Worker-серверов SIP.TG (см. список в файле https://files.sip.tg/fw.txt).
- Проверьте, не закончился ли срок регистрации аккаунта. Возможно, АТС требует более частую перерегистрацию.
- Ограничения Telegram при массовых вызовах:
При большом количестве исходящих звонков система может выдавать ошибки503 Too Many Requestsили408 Timeout of waiting RPC result. Решение – снизьте скорость обзвона. - Проблемы с DTMF:
Если при взаимодействии с голосовым меню (IVR) не распознаются нажатия, измените метод передачи DTMF в настройках (например, переключитесь сinbandнаRFC2833илиINFO). - Проблемы с регистрацией на Worker-сервере:
Иногда SIP-регистрация не происходит из-за того, что Worker-сервер не отвечает или IP-адрес не внесён в «белый список». Решение – проверьте настройки сети и добавьте необходимые IP в белый список. - Конфликты при самостоятельном обновлении настроек:
Если пользователи самостоятельно изменяют параметры SIP-аккаунта (например, аудиокодеки, правила набора), это может привести к ошибкам при массовом управлении. Рекомендуется централизованное администрирование через общий «админский» аккаунт.
Если описанные действия не помогли, обратитесь за помощью. Подробнее см. Как получить помощь.