- Manager — управляющий компонент SIP.TG, отвечающий за подключение к Worker-серверам и Хранилищам сессий.
- Worker — рабочий компонент, обрабатывающий звонки, RTP-трафик и выполняющий SIP-сигнализацию.
- Взаимодействие с Telegram — как авторизовать Telegram-аккаунт для звонков.
- Взаимодействие с АТС — подробное описание опций SIP-подключения.
- Обзор подписок — чтобы убедиться, что ваша подписка «Шлюз» покрывает нужное количество линий.
Частые вопросы (FAQ)
Что будет, если кто-то позвонит на этот аккаунт напрямую?
Что будет, если кто-то позвонит на этот аккаунт напрямую?
Если человек в списке разрешённых вызывающих, звонок будет направлен в АТС, а на устройстве, где открыт этот аккаунт, можно вручную тоже принять звонок.
Обычно рекомендуется отключить приём звонков на других устройствах, чтобы всё шло через АТС.
Можно ли работать сразу с несколькими аккаунтами Telegram?
Можно ли работать сразу с несколькими аккаунтами Telegram?
Как быть, если надо обрабатывать и текстовые сообщения?
Как быть, если надо обрабатывать и текстовые сообщения?
Подробнее см. Настройки сессии SIP.TG.
Насколько это надёжно?
Насколько это надёжно?
Какой Telegram-аккаунт лучше использовать в качестве Шлюза?
Какой Telegram-аккаунт лучше использовать в качестве Шлюза?
Можно ли один Telegram-аккаунт разделить между несколькими сотрудниками?
Можно ли один Telegram-аккаунт разделить между несколькими сотрудниками?
Почему звонок сбрасывается у остальных, когда один человек ответил?
Почему звонок сбрасывается у остальных, когда один человек ответил?
Нужна ли SIM-карта?
Нужна ли SIM-карта?
Какой используется диапазон портов для RTP?
Какой используется диапазон портов для RTP?
Проблемы общего характера
Не поступает входящий вызов на Telegram-шлюз
Не поступает входящий вызов на Telegram-шлюз
- Проверьте, что Telegram-аккаунт активен, не заблокирован мессенджером.
- Убедитесь, что в настройках конфиденциальности Telegram разрешены звонки от всех.
Односторонняя слышимость при использовании Шлюза
Односторонняя слышимость при использовании Шлюза
- Попробуйте указать конкретный кодек (
alaw
илиmulaw
). - Убедитесь, что UDP трафик разрешён.
DTMF не распознаётся в голосовом меню
DTMF не распознаётся в голосовом меню
- Убедитесь, что в настройках SIP-аккаунта (Шлюза) выбран метод RFC2833 или INFO, совместимый с вашей АТС.
- Попробуйте переключить кодек, иногда inband DTMF и высокое сжатие не дружат.
Общие SIP-ошибки
Такие ответы могут появляться как при звонках, так и при простой регистрации SIP-транка. Указанный ниже код отвечает сервер SIP.TG вашей АТС.401 Unauthorized
401 Unauthorized
402 …
402 …
- В боте @siptg_bot командой
/subscriptions
проверьте, активен ли тариф «Шлюз» и достаточно ли линий. - Если срок подписки вышел или нужны дополнительные линии, оформите продление / расширение подписки (см. Обзор подписок).
- Убедитесь, что конкретный Telegram-аккаунт действительно привязан к нужной подписке (при оплате нескольких аккаунтов).
500 Database error
500 Database error
- Обычно носит временный характер и устраняется автоматически.
- Повторите попытку, при регулярном повторении ошибки обратитесь за помощью. Подробнее см. Как получить помощь.
503 No response from Manager
503 No response from Manager
503
.Что делать:- Как правило, это краткосрочные сбои. Попробуйте подождать 1–2 минуты и повторить вызов.
- Если проблема не решается, можно переключить SIP-транк на другой Worker-сервер (см. Взаимодействие с АТС).
Ошибки при регистрации PBX → SIP.TG
Здесь собраны ответы, которые могут прийти, когда ваша АТС пытается зарегистрироваться на Worker-сервере SIP.TG (подкючение с типом PBX→SIP.TG). Все указанные ниже ошибки обычно имеют код 403 или 404.403 Wrong password
403 Wrong password
- Проверьте пароль в разделе
/gateway
бота @siptg_bot и сравните с тем, что введено на АТС. - При необходимости смените пароль в боте (кнопка «Сменить пароль») и введите новый на стороне АТС.
- Убедитесь, что логин (username) тоже не содержит опечаток.
403 Untrusted IP address
403 Untrusted IP address
- В боте @siptg_bot, раздел
/gateway
, откройте настройки соответствующего SIP-подключения и:- Добавьте ваш IP-адрес в список доверенных.
- Или очистите список, чтобы разрешить подключения с любого IP (но соблюдайте меры безопасности).
- Если в вашей сети меняется внешний IP, учитывайте это при настройке (возможно, стоит полностью отключить ACL).
403 Telegram session is inactive
403 Telegram session is inactive
- В боте @siptg_bot в разделе
/gateway
переподключить Telegram-аккаунт (произвести авторизацию номера телефона). - Если аккаунт Telegram был удалён, придётся назначить другой номер телефона для Шлюза.
- Подробнее см. Взаимодействие с Telegram.
403 Session storage is inactive
403 Session storage is inactive
- Если используете облачное хранилище SIP.TG, проверьте статус в
/gateway
. Обычно такие сбои кратковременны. - Если у вас собственное Хранилище сессий, убедитесь, что оно запущено и доступно. При необходимости переключитесь на облако SIP.TG.
403 Worker is inactive
403 Worker is inactive
- В разделе
/gateway
бота проверьте настройки Worker. Если сервер отключён, выберите другой или подождите, пока он снова станет активен. - Если это ваш собственный Worker, запустите/перезапустите его.
403 Worker address is not set
403 Worker address is not set
- В боте @siptg_bot перепроверьте тип подключения (PBX→SIP.TG) и выберите подходящий Worker.
- Создайте SIP подключение другого типа («SIP.TG→PBX» или «IP⇿IP»).
403 Route is not permitted
403 Route is not permitted
- Создайте собственную сессию Шлюза. В разделе
/gateway
бота подключите номер Telegram, который контролируете. - Убедитесь, что администратор, создававший ранее сессию, не забрал у вас доступ.
404 Route not found
404 Route not found
- Перепроверьте логин/username, который вы получили в разделе
/gateway
. - Если ранее эта запись была удалена, создайте новую.
- Убедитесь, что в вашей АТС прописан именно тот логин, что выдан ботом (без лишних символов или пробелов).
Ошибки при звонке SIP → Telegram
Эти ошибки возникают, когда ваша АТС уже зарегистрирована (или IP-to-IP), и при исходящем вызове в Telegram сервер SIP.TG возвращает код, если не может корректно дозвониться до Telegram-аккаунта.403 USER_PRIVACY_RESTRICTED / 403 PRIVACY_PREMIUM_REQUIRED
403 USER_PRIVACY_RESTRICTED / 403 PRIVACY_PREMIUM_REQUIRED
404 Not Found / 404 Chat not found / 404 USERNAME_NOT_OCCUPIED
404 Not Found / 404 Chat not found / 404 USERNAME_NOT_OCCUPIED
- Номер действительно не зарегистрирован в Telegram.
- Username не существует или освобождён.
- Профиль недоступен из-за ограничений.
- Ваш аккаунт шлюза делает слишком часто поиск по номеру телефона.
- Убедиться, что вы используете правильный идентификатор (если используете телефон — это должен быть реальный Telegram-номер).
- Если возникает часто, проверьте, не ошиблись ли в формате. Возможно, лучше использовать внутренний user_id.
405 REGISTER is required first
405 REGISTER is required first
- На стороне вашей АТС включить режим «Registration» (зарегистрировать транк PBX→SIP.TG). Подробнее см. Взаимодействие с АТС.
408 Timeout of waiting RPC result
408 Timeout of waiting RPC result
- Снизить интенсивность исходящих звонков.
- Подождать и повторить попытку, если был временный сбой.
470 Anonymous user
470 Anonymous user
- Обычно нужно либо позвонить по подтверждённому номеру или username, либо чтобы пользователь сам добавил вас в контакты или написал вам сначала.
500 (прочие)
500 (прочие)
- Перепроверить стабильность сети, повторить вызов.
- Если ошибка появляется регулярно на одном и том же номере, обратитесь за помощью. Подробнее см. Как получить помощь.
503 Account is not running
503 Account is not running
- Убедиться, что транк PBX→SIP.TG успешно зарегистрирован и Worker видит активную учётную запись.
- Иногда помогает перезагрузить транк на АТС. При необходимости см. Взаимодействие с АТС.
503 Session is not running
503 Session is not running
- Перепроверить статус сессии в
/gateway
, при необходимости заново авторизовать номер Telegram. - Если ошибка возникает часто, попробуйте переключиться на другой Worker или перезагрузить аккаунт.
503 Telegram storage is unavailable
503 Telegram storage is unavailable
503 Too Many Requests: retry after … / 503 PEER_FLOOD
503 Too Many Requests: retry after … / 503 PEER_FLOOD
- Снизить скорость обзвона (на стороне АТС или вашего скрипта).
- Использовать несколько разных Telegram-аккаунтов, чтобы распределить нагрузку.
- Дождаться указанного времени «retry after N», затем повторить.
503 Worker is not ready
503 Worker is not ready
- Подождите 1–2 минуты и повторите вызов.
- Или в боте @siptg_bot выберите другой Worker-сервер для вашего подключения.
Ошибки при звонке Telegram → SIP
Здесь рассматриваются ситуации, когда реальный пользователь пытается позвонить на аккаунт Шлюза из приложения Telegram, а Worker пытается перевести вызов в вашу АТС. В случае, если АТС вернёт ошибку, либо если ошибка возникнет на стороне SIP.TG, пользователь может увидеть ошибку в чате с аккаунтом Шлюза. В этом разделе мы приводим только те ошибки, которые могут возникнуть на стороне SIP.TG.482 Caller has active gateway accounts
482 Caller has active gateway accounts
- Если действительно нужно принимать звонки от аккаунта, который тоже является шлюзовым, лучше используйте для него иной режим (например, Софтфон) или другой Telegram-аккаунт без Шлюза.
503 SIP account is unavailable
503 SIP account is unavailable
503 Worker is unavailable
503 Worker is unavailable