Skip to main content
Төменде Шлюз режимінде (PBX→Telegram) пайда болуы мүмкін қателер сипатталған — тіркеу кезінде (PBX→SIP.TG) де, қоңырау орнату сәтінде де (SIP→Telegram немесе Telegram→SIP). Олардың кейбіреулері АТС логтарында, кейбіреулері Telegram аккаунтына қоңырау шалуға тырысқанда код ретінде көрінеді. Барлық қателер нақты пайдалануда жиі кездеспейді, бірақ диагностика үшін олар туралы білу пайдалы. Анықтама үшін:
  • Manager — Worker серверлеріне және сессия сақтау орындарына қосылуды басқаратын SIP.TG компоненті.
  • Worker — қоңырауларды, RTP трафигін өңдейтін және SIP сигнал беруін орындайтын жұмыс компоненті.
Егер сіз Шлюзбен жұмысты енді бастасаңыз, мына мақалаларды да қарауды ұсынамыз:

​
Жиі қойылатын сұрақтар (FAQ)

Шлюзді баптаған кезде Telegram аккаунты кіріс қоңырауларды АТС-ке бағыттайды.
Егер адам рұқсат етілген қоңырау шалушылар тізімінде болса, қоңырау АТС-ке бағытталады, ал бұл аккаунт ашық құрылғыда қоңырауды қолмен де қабылдауға болады.
Әдетте, барлығы АТС арқылы өтуі үшін басқа құрылғыларда қоңырауларды қабылдауды өшіру ұсынылады.
Иә, «Шлюз» жазылымында бірнеше Telegram аккаунтын төлеуге болады. Бірінші аккаунт айына 15 EUR, әр қосымша аккаунт айына 150 EUR тұрады.
Егер шлюз баптауларында «Хабарламаларды өңдеу» опциясы қосылса, Шлюз кіріс хабарламаларды өңдей алады. Бұл автожауап, Callback режимі және сыртқы бот арқылы хабарламаларды өңдеу мүмкіндіктерін қосады.
Толығырақ SIP.TG сессия баптаулары бөлімін қараңыз.
SIP.TG-дің барлық инфрақұрылымы бірнеше деректер орталықтарына бөлінген. Дегенмен, өте маңызды жүйелер үшін өз Worker серверлерін қарастыруға болады.
Компания үшін жеке жұмыс аккаунтын құру ұсынылады — жеке Telegram-ды іскерлік қоңыраулармен араластырмау үшін. Бұл аккаунт әрқашан онлайн болуы маңызды (немесе сессияны SIP.TG бұлтты сақтау орнында сақтаңыз).
Иә, бірақ бұл барлығы бір Telegram аккаунтын пайдаланады дегенді білдіреді, ал кіріс қоңыраулар барлық құрылғыларға бір уақытта түседі. Біреу жауап бергеннен кейін, басқаларда қоңырау үзіледі.
Бұл Шлюздің қалыпты мінез-құлқы: АТС қоңыраудың қабылданғанын көреді. Басқа клиенттерге CANCEL жіберіледі. Егер әр қызметкердің өз Telegram аккаунты болуы керек болса, бірнеше шлюз жазылымын пайдаланыңыз.
Telegram аккаунты телефон нөмірі негізінде құрылады. Әдетте кез келген SIM-картаны алып, Telegram-да тіркейді, содан кейін нөмір дәстүрлі оператор дауыстық қоңыраулары үшін пайдаланылмауы мүмкін. Ең бастысы — Telegram-ды қалпына келтіру үшін бұл нөмірге қолжетімділікті жоғалтпау.
Біздің SIP стекі Yate негізделген, мұнда әдепкі UDP порттар диапазоны 16384-32768.

​
Жалпы сипаттағы мәселелер

  • Telegram аккаунтының белсенді және мессенджермен бұғатталмағанын тексеріңіз.
  • Telegram құпиялылық баптауларында барлығынан қоңырауларға рұқсат етілгенін тексеріңіз.
Софтфондағы сияқты, бұл көбінесе кодектер немесе желілік шектеулер мәселесі.
  • Нақты кодекті (alaw немесе mulaw) көрсетіп көріңіз.
  • UDP трафигіне рұқсат етілгенін тексеріңіз.
  • Шлюздің SIP аккаунты баптауларында RFC2833 немесе INFO әдісінің АТС-ке сәйкес таңдалғанын тексеріңіз.
  • Кодекті ауыстырып көріңіз, кейде inband DTMF және жоғары қысу бір-бірімен үйлеспейді.

​
Жалпы SIP қателері

Мұндай жауаптар қоңыраулар кезінде де, қарапайым SIP транкын тіркеу кезінде де пайда болуы мүмкін. Төменде көрсетілген кодты SIP.TG сервері сіздің АТС-ке жібереді.
Мәні: SIP Digest Auth қолданғандағы стандартты жауап. АТС INVITE немесе REGISTER-ді толық авторизация деректерінсіз жібереді, ал SIP.TG сервері авторизацияны сұрайды.
Егер 401 қатесі қатарынан бірнеше рет қайталанса, бұл пароль/логин қате екенін немесе АТС жағында Digest Auth қолдауы өшірілгенін білдіреді.Не істеу керек:
  • @siptg_bot ботынан алынған логин/парольдің (/gateway бөлімі) АТС баптауларында дұрыс енгізілгенін тексеріңіз.
  • АТС-те SIP авторизация режимі (Digest Auth) қосылғанын тексеріңіз.
  • Қажет болса, /gateway бөлімінде парольді өзгертіп, оны қайта енгізіңіз.
Мәні: «Шлюз» жазылымының шектеуі. Бұл Telegram аккаунтында Шлюз режимі үшін төленген желілер жоқ, жазылым мерзімі аяқталған немесе ресурстар көлемі асып кеткен дегенді білдіреді.Не істеу керек:
  • @siptg_bot ботында /subscriptions командасы арқылы «Шлюз» тарифінің белсенді екенін және желілер саны жеткілікті екенін тексеріңіз.
  • Егер жазылым мерзімі аяқталса немесе қосымша желілер қажет болса, жазылымды ұзарту/кеңейту (қараңыз: Жазылымдарға шолу).
  • Telegram аккаунтының қажетті жазылымға шынымен байланысты екеніне көз жеткізіңіз (бірнеше аккаунт үшін төлем жасағанда).
Мәні: SIP.TG жағындағы дерекқорға байланысты ішкі қате. Мұндай жағдайлар өте сирек кездеседі.Не істеу керек:
  • Әдетте уақытша сипатқа ие және автоматты түрде шешіледі.
  • Қайталап көріңіз, егер қате жиі қайталанса, көмек сұраңыз. Толығырақ Көмек алу жолы бөлімін қараңыз.
Мәні: Worker ішкі желілік мәселе салдарынан SIP.TG Manager серверімен байланыса алмайды. Сіздің АТС бұны 503 жауап ретінде көреді.Не істеу керек:
  • Әдетте, бұл қысқа мерзімді ақаулар. 1-2 минут күтіп, қоңырауды қайталаңыз.
  • Егер мәселе шешілмесе, SIP транкын басқа Worker серверіне ауыстыруға болады (қараңыз: АТС-пен өзара әрекеттесу).

​
PBX → SIP.TG тіркеу кезіндегі қателер

Мұнда сіздің АТС SIP.TG Worker серверіне тіркелуге тырысқанда (PBX→SIP.TG типті қосылым) келіп түсуі мүмкін жауаптар жинақталған. Төменде көрсетілген барлық қателер әдетте 403 немесе 404 кодына ие.
Мәні: АТС дұрыс авторизациялануға тырысады, бірақ көрсетілген пароль SIP.TG күтетін парольмен сәйкес келмейді.Не істеу керек:
  • @siptg_bot ботынан /gateway бөліміндегі парольді тексеріп, АТС-те енгізілгенімен салыстырыңыз.
  • Қажет болса, ботта паролді өзгертіңіз («Паролді өзгерту» түймесі) және жаңасын АТС жағында енгізіңіз.
  • Логин (username) де қателер жоқ екеніне көз жеткізіңіз.
Мәні: Пароль дұрыс, бірақ сіздің IP мекенжайыңыз осы SIP қосылымы үшін рұқсат етілген мекенжайлар тізімінде жоқ.Не істеу керек:
  • @siptg_bot ботында, /gateway бөлімінде тиісті SIP қосылымының баптауларын ашып:
    • Сіздің IP мекенжайыңызды сенімділер тізіміне қосыңыз.
    • Немесе кез келген IP-ден қосылуға рұқсат беру үшін тізімді тазалаңыз (бірақ қауіпсіздік шараларын сақтаңыз).
  • Егер желіңізде сыртқы IP өзгерсе, баптау кезінде мұны ескеріңіз (ACL-ді толығымен өшіру қажет болуы мүмкін).
Мәні: Байланыстырылатын Telegram аккаунты белсенді емес (авторизация жоғалған). Нәтижесінде SIP.TG нақты Telegram байланысы болмағандықтан транкті тіркеуден бас тартады.Не істеу керек:
  • @siptg_bot ботында /gateway бөлімінде Telegram аккаунтын қайта қосыңыз (телефон нөмірін авторизациялаңыз).
  • Егер Telegram аккаунты жойылған болса, Шлюз үшін басқа телефон нөмірін тағайындауға тура келеді.
  • Толығырақ Telegram-мен өзара әрекеттесу бөлімін қараңыз.
Мәні: Telegram сессиясы сақталған сақтау орны (бұлтты немесе өз сақтау орны) қазіргі уақытта өшірілген немесе қолжетімсіз. Демек, Telegram сессиясымен жұмыс істеу мүмкіндігі жоқ.Не істеу керек:
  • Егер SIP.TG бұлтты сақтау орнын пайдалансаңыз, /gateway бөлімінде мәртебесін тексеріңіз. Мұндай ақаулар әдетте қысқа мерзімді болады.
  • Егер өз сақтау орнын пайдалансаңыз, оның іске қосылғанын және қолжетімді екенін тексеріңіз. Қажет болса, SIP.TG бұлтына ауысыңыз.
Мәні: Таңдалған Worker сервері SIP.TG жағында өшірілген немесе жаңарту/қайта жүктеу процесінде. Сервер PBX→SIP.TG тіркеуін қабылдай алмайды.Не істеу керек:
  • Боттың /gateway бөлімінде Worker баптауларын тексеріңіз. Егер сервер өшірілген болса, басқасын таңдаңыз немесе оның қайта белсенді болуын күтіңіз.
  • Егер бұл сіздің өз Worker серверіңіз болса, оны іске қосыңыз/қайта іске қосыңыз.
Мәні: Worker серверінің конфигурациясы «PBX→SIP.TG» типті қосылымдарды қарастырмайды. Мысалы, сервер тек «SIP.TG→PBX» немесе «IP⇿IP» үшін бапталған.Не істеу керек:
  • @siptg_bot ботында қосылым түрін (PBX→SIP.TG) қайта тексеріп, тиісті Worker таңдаңыз.
  • Басқа түрдегі SIP қосылымын құрыңыз («SIP.TG→PBX» немесе «IP⇿IP»).
Мәні: Пайдаланылған Telegram сессиясына қолжетімділік қайтарып алынған немесе ол сізге тиесілі емес. Мысалы, сессияны құрған әкімші құқықтарынан айырылған, және сіз бұл сессияны пайдалана алмайсыз.Не істеу керек:
  • Өз Шлюз сессияңызды құрыңыз. Боттың /gateway бөлімінде сіз басқаратын Telegram нөмірін қосыңыз.
  • Бұрын сессияны құрған әкімші сіздің қолжетімділігіңізді алып тастамағанына көз жеткізіңіз.
Мәні: SIP сұрауында көрсетілген логин жоқ немесе қазірдің өзінде жойылған. SIP.TG сервері мұндай «аккаунтты» таппайды.Не істеу керек:
  • /gateway бөлімінде алынған логин/username-ді қайта тексеріңіз.
  • Егер бұл жазба бұрын жойылған болса, жаңасын құрыңыз.
  • Сіздің АТС-те бот берген логиннің дәл солай жазылғанына көз жеткізіңіз (қосымша таңбалар немесе бос орындарсыз).

​
SIP → Telegram қоңырау кезіндегі қателер

Бұл қателер сіздің АТС қазірдің өзінде тіркелген (немесе IP-to-IP) және Telegram-ға шығыс қоңырау кезінде SIP.TG сервері Telegram аккаунтына дұрыс қоңырау шала алмаса, кодты қайтарады.
Мәні: Telegram пайдаланушысы оған қоңырау шала алатын адамдар шеңберін шектеген (мысалы, тек контактілер немесе премиум-жазылымы бар пайдаланушылар), ал сіздің шлюз аккаунтыңыз бұл тізімге кірмеген.Не істеу керек:
  • Қоңырау шалынатын пайдаланушыдан қоңырау рұқсатын баптауды сұраңыз: «Баптаулар → Құпиялылық → Дауыстық қоңыраулар» → «Барлық пайдаланушылар» немесе сіздің шлюз аккаунтыңызды «Әрқашан рұқсат ету» тізіміне қосу.
  • Немесе мақсатты пайдаланушының контактілерінде шынымен бар аккаунтты пайдаланыңыз.
Мәні: SIP.TG берілген идентификатор (нөмір, user_id, username) бойынша Telegram аккаунтын таба алмады. Telegram мұндай жауапты мынадай жағдайларда қайтаруы мүмкін:
  • Нөмір шынымен Telegram-да тіркелмеген.
  • Пайдаланушы аты жоқ немесе босатылған.
  • Профиль шектеулерге байланысты қолжетімсіз.
  • Сіздің шлюз аккаунтыңыз телефон нөмірі бойынша іздеуді тым жиі жасайды.
Не істеу керек:
  • Дұрыс идентификаторды пайдаланып жатқаныңызға көз жеткізіңіз (егер телефон болса — бұл нақты Telegram нөмірі болуы керек).
  • Егер жиі пайда болса, форматта қателеспегеніңізді тексеріңіз. Мүмкін ішкі user_id пайдалану дұрысырақ.
Мәні: Сіз PBX→SIP.TG алдын ала тіркеусіз INVITE жібересіз, ал Worker толық REGISTER талап етеді.Не істеу керек:
Мәні: Telegram сервері уақытында жауап бермеді, немесе SIP.TG сұрауы Telegram-ға жүгінгенде ілініп қалды. Бұл шамадан тыс жүктеме немесе Telegram-дың спамға қарсы сүзгісі кезінде, қысқа уақытта көп шығыс қоңыраулар болғанда орын алады.Не істеу керек:
  • Шығыс қоңыраулардың қарқындылығын төмендетіңіз.
  • Уақытша ақау болса, күтіп, қайталап көріңіз.
Мәні: SIP.TG ішкі user_id бойынша пайдаланушыға қоңырау шалуға тырысады, олмен нақты расталған контакт жоқ. Telegram мұндай «анонимді» қоңырауларды қабылдамайды.Не істеу керек:
  • Әдетте расталған нөмір немесе username бойынша қоңырау шалу керек, немесе пайдаланушы сізді контактілерге қосып, алдымен жазуы керек.
Мәні: Telegram жағындағы кез келген басқа ішкі қате. Кейде бұл аудио арнаны өңдеу кезіндегі күтпеген ақаулар, ішкі шамадан тыс жүктеме және т.б. белгілейді.Не істеу керек:
  • Желінің тұрақтылығын тексеріп, қоңырауды қайталаңыз.
  • Егер қате бір нөмірде тұрақты түрде пайда болса, көмек сұраңыз. Толығырақ Көмек алу жолы бөлімін қараңыз.
Мәні: SIP.TG Worker сервері INVITE алды, бірақ қажетті аккаунт үшін белсенді сессия жоқ. Яғни, АТС REGISTER жауабын күтпей INVITE жіберген болуы мүмкін.Не істеу керек:
  • PBX→SIP.TG транкының сәтті тіркелгенін және Worker белсенді аккаунтты көретінін тексеріңіз.
  • Кейде АТС-те транкты қайта жүктеу көмектеседі. Қажет болса, АТС-пен өзара әрекеттесу бөлімін қараңыз.
Мәні: Telegram сессиясы іс жүзінде ажыратылған. Ботта @siptg_bot сессия көрсетілгенімен, ол шынымен авторизацияланбаған болуы мүмкін.Не істеу керек:
  • /gateway бөлімінде сессия мәртебесін қайта тексеріңіз, қажет болса Telegram нөмірін қайта авторизациялаңыз.
  • Егер қате жиі пайда болса, басқа Worker-ге ауысып көріңіз немесе аккаунтты қайта жүктеңіз.
Мәні: SIP.TG Telegram сессиялары сақтау орнымен байланысты жоғалтты, сондықтан ағымдағы мәртебені білу немесе қоңырау жасау мүмкін емес.Не істеу керек:
  • Егер бұлтты сақтау орнын пайдалансаңыз, қалпына келтіруді күтіңіз (әдетте бір-екі минут).
  • Егер өз сақтау орнын пайдалансаңыз, логтарды және модуль мәртебесін тексеріңіз.
Мәні: Бұл Telegram-дың спамға қарсы қорғанысы, қысқа уақытта тым көп шығыс қоңыраулар, әсіресе бейтаныс нөмірлерге болған кезде.Не істеу керек:
  • Қоңырау шалу жылдамдығын төмендетіңіз (АТС немесе скрипт жағынан).
  • Жүктемені бөлу үшін бірнеше түрлі Telegram аккаунттарын пайдаланыңыз.
  • Көрсетілген «retry after N» уақытын күтіп, қайталаңыз.
Мәні: Worker жақында қайта жүктелді немесе жаңартылуда және әлі инициализацияны аяқтамаған. Нәтижесінде қоңыраулар SIP деңгейінде қабылданбайды.Не істеу керек:
  • 1-2 минут күтіп, қоңырауды қайталаңыз.
  • Немесе @siptg_bot ботында қосылымыңыз үшін басқа Worker серверін таңдаңыз.

​
Telegram → SIP қоңырау кезіндегі қателер

Мұнда нақты пайдаланушы Telegram қосымшасынан Шлюз аккаунтына қоңырау шалуға тырысқан және Worker қоңырауды сіздің АТС-ке аударуға тырысқан жағдайлар қарастырылады. Егер АТС қате қайтарса немесе SIP.TG жағында қате пайда болса, пайдаланушы Шлюз аккаунтымен чатта қатені көруі мүмкін. Бұл бөлімде тек SIP.TG жағында пайда болуы мүмкін қателер тізімделеді.
Мәні: Қоңырау шалушының аккаунтында да SIP.TG Шлюзі белсендірілген. Қызмет мұндай әрекетті (Telegram→SIP) циклдар немесе күтпеген қоңырау циклдары болмас үшін блоктайды.Не істеу керек:
  • Егер шлюз болып табылатын аккаунттан қоңыраулар қабылдау қажет болса, оған басқа режимді (мысалы, Софтфон) немесе Шлюзсіз басқа Telegram аккаунтын пайдаланған дұрыс.
Мәні: Telegram-дан кіріс қоңырау кезінде Worker сіздің АТС-ке жете алмады. Бұл PBX→SIP.TG транкы істен шықса немесе IP-to-IP болса, бірақ қажетті порт жауап бермесе орын алады.Не істеу керек:
  • АТС-тің тіркелгенін (PBX→SIP.TG кезінде) немесе IP-to-IP қосылымының белсенді екенін тексеріңіз.
  • Фаерволда SIP/UDP пакеттерінің блокталмағанын және RTP порттарын ашқаныңызды тексеріңіз.
  • Толығырақ АТС-пен өзара әрекеттесу бөлімін қараңыз.
Мәні: Worker сервері қазіргі уақытта қоңырауды тасымалдау үшін қолжетімсіз (желілік мәселелер немесе қайта жүктеу), және қоңырау 503 кодымен қабылданбайды.Не істеу керек:
  • Біраз уақыт күтіңіз немесе Шлюз аккаунтын басқа Worker-ге ауыстырыңыз (боттың /gateway бөлімі).
  • Егер бұл сіздің жеке Worker серверіңіз болса, оның логтарын тексеріп, қажет болса қайта іске қосыңыз.
Егер аталған шешімдердің ешқайсысы көмектеспесе, көмек сұраңыз. Толығырақ Көмек алу жолы бөлімін қараңыз.
⌘I