Сұрақтар және мәселелерді шешу
Төменде Шлюз режимінде (PBX→Telegram) пайда болуы мүмкін қателер сипатталған — тіркеу кезінде (PBX→SIP.TG) де, қоңырау орнату сәтінде де (SIP→Telegram немесе Telegram→SIP). Олардың кейбіреулері АТС логтарында, кейбіреулері Telegram аккаунтына қоңырау шалуға тырысқанда код ретінде көрінеді. Барлық қателер нақты пайдалануда жиі кездеспейді, бірақ диагностика үшін олар туралы білу пайдалы.
Анықтама үшін:
- Manager — Worker серверлеріне және сессия сақтау орындарына қосылуды басқаратын SIP.TG компоненті.
- Worker — қоңырауларды, RTP трафигін өңдейтін және SIP сигнал беруін орындайтын жұмыс компоненті.
Егер сіз Шлюзбен жұмысты енді бастасаңыз, мына мақалаларды да қарауды ұсынамыз:
- Telegram-мен өзара әрекеттесу — қоңыраулар үшін Telegram аккаунтын қалай авторизациялау керек.
- АТС-пен өзара әрекеттесу — SIP қосылымы опцияларының толық сипаттамасы.
- Жазылымдарға шолу — сіздің «Шлюз» жазылымыңыз қажетті желілер санын қамтитынына көз жеткізу үшін.
Жиі қойылатын сұрақтар (FAQ)
Егер біреу бұл аккаунтқа тікелей қоңырау шалса не болады?
Егер біреу бұл аккаунтқа тікелей қоңырау шалса не болады?
Шлюзді баптаған кезде Telegram аккаунты кіріс қоңырауларды АТС-ке бағыттайды.
Егер адам рұқсат етілген қоңырау шалушылар тізімінде болса, қоңырау АТС-ке бағытталады, ал бұл аккаунт ашық құрылғыда қоңырауды қолмен де қабылдауға болады.
Әдетте, барлығы АТС арқылы өтуі үшін басқа құрылғыларда қоңырауларды қабылдауды өшіру ұсынылады.
Бірден бірнеше Telegram аккаунтымен жұмыс істеуге бола ма?
Бірден бірнеше Telegram аккаунтымен жұмыс істеуге бола ма?
Иә, «Шлюз» жазылымында бірнеше Telegram аккаунтын төлеуге болады. Бірінші аккаунт айына 15 EUR, әр қосымша аккаунт айына 150 EUR тұрады.
Мәтіндік хабарламаларды да өңдеу керек болса ше?
Мәтіндік хабарламаларды да өңдеу керек болса ше?
Егер шлюз баптауларында «Хабарламаларды өңдеу» опциясы қосылса, Шлюз кіріс хабарламаларды өңдей алады. Бұл автожауап, Callback режимі және сыртқы бот арқылы хабарламаларды өңдеу мүмкіндіктерін қосады.
Толығырақ SIP.TG сессия баптаулары бөлімін қараңыз.
Бұл қаншалықты сенімді?
Бұл қаншалықты сенімді?
SIP.TG-дің барлық инфрақұрылымы бірнеше деректер орталықтарына бөлінген. Дегенмен, өте маңызды жүйелер үшін өз Worker серверлерін қарастыруға болады.
Шлюз ретінде қандай Telegram аккаунтын пайдаланған дұрыс?
Шлюз ретінде қандай Telegram аккаунтын пайдаланған дұрыс?
Компания үшін жеке жұмыс аккаунтын құру ұсынылады — жеке Telegram-ды іскерлік қоңыраулармен араластырмау үшін. Бұл аккаунт әрқашан онлайн болуы маңызды (немесе сессияны SIP.TG бұлтты сақтау орнында сақтаңыз).
Бір Telegram аккаунтын бірнеше қызметкер арасында бөлісуге бола ма?
Бір Telegram аккаунтын бірнеше қызметкер арасында бөлісуге бола ма?
Иә, бірақ бұл барлығы бір Telegram аккаунтын пайдаланады дегенді білдіреді, ал кіріс қоңыраулар барлық құрылғыларға бір уақытта түседі. Біреу жауап бергеннен кейін, басқаларда қоңырау үзіледі.
Неліктен бір адам жауап бергенде басқаларда қоңырау үзіледі?
Неліктен бір адам жауап бергенде басқаларда қоңырау үзіледі?
Бұл Шлюздің қалыпты мінез-құлқы: АТС қоңыраудың қабылданғанын көреді. Басқа клиенттерге CANCEL жіберіледі. Егер әр қызметкердің өз Telegram аккаунты болуы керек болса, бірнеше шлюз жазылымын пайдаланыңыз.
SIM-карта қажет пе?
SIM-карта қажет пе?
Telegram аккаунты телефон нөмірі негізінде құрылады. Әдетте кез келген SIM-картаны алып, Telegram-да тіркейді, содан кейін нөмір дәстүрлі оператор дауыстық қоңыраулары үшін пайдаланылмауы мүмкін. Ең бастысы — Telegram-ды қалпына келтіру үшін бұл нөмірге қолжетімділікті жоғалтпау.
RTP үшін қандай порт диапазоны қолданылады?
RTP үшін қандай порт диапазоны қолданылады?
Біздің SIP стекі Yate негізделген, мұнда әдепкі UDP порттар диапазоны 16384-32768.
Жалпы сипаттағы мәселелер
Telegram шлюзіне кіріс қоңырау түспейді
Telegram шлюзіне кіріс қоңырау түспейді
- Telegram аккаунтының белсенді және мессенджермен бұғатталмағанын тексеріңіз.
- Telegram құпиялылық баптауларында барлығынан қоңырауларға рұқсат етілгенін тексеріңіз.
Шлюзді пайдаланғанда біржақты естілу
Шлюзді пайдаланғанда біржақты естілу
Софтфондағы сияқты, бұл көбінесе кодектер немесе желілік шектеулер мәселесі.
- Нақты кодекті (
alaw
немесеmulaw
) көрсетіп көріңіз. - UDP трафигіне рұқсат етілгенін тексеріңіз.
Дауыстық мәзірде DTMF танылмайды
Дауыстық мәзірде DTMF танылмайды
- Шлюздің SIP аккаунты баптауларында RFC2833 немесе INFO әдісінің АТС-ке сәйкес таңдалғанын тексеріңіз.
- Кодекті ауыстырып көріңіз, кейде inband DTMF және жоғары қысу бір-бірімен үйлеспейді.
Жалпы SIP қателері
Мұндай жауаптар қоңыраулар кезінде де, қарапайым SIP транкын тіркеу кезінде де пайда болуы мүмкін. Төменде көрсетілген кодты SIP.TG сервері сіздің АТС-ке жібереді.
401 Unauthorized
401 Unauthorized
402 …
402 …
Мәні: «Шлюз» жазылымының шектеуі. Бұл Telegram аккаунтында Шлюз режимі үшін төленген желілер жоқ, жазылым мерзімі аяқталған немесе ресурстар көлемі асып кеткен дегенді білдіреді.
Не істеу керек:
- @siptg_bot ботында
/subscriptions
командасы арқылы «Шлюз» тарифінің белсенді екенін және желілер саны жеткілікті екенін тексеріңіз. - Егер жазылым мерзімі аяқталса немесе қосымша желілер қажет болса, жазылымды ұзарту/кеңейту (қараңыз: Жазылымдарға шолу).
- Telegram аккаунтының қажетті жазылымға шынымен байланысты екеніне көз жеткізіңіз (бірнеше аккаунт үшін төлем жасағанда).
500 Database error
500 Database error
Мәні: SIP.TG жағындағы дерекқорға байланысты ішкі қате. Мұндай жағдайлар өте сирек кездеседі.
Не істеу керек:
- Әдетте уақытша сипатқа ие және автоматты түрде шешіледі.
- Қайталап көріңіз, егер қате жиі қайталанса, көмек сұраңыз. Толығырақ Көмек алу жолы бөлімін қараңыз.
503 No response from Manager
503 No response from Manager
Мәні: Worker ішкі желілік мәселе салдарынан SIP.TG Manager серверімен байланыса алмайды. Сіздің АТС бұны 503
жауап ретінде көреді.
Не істеу керек:
- Әдетте, бұл қысқа мерзімді ақаулар. 1-2 минут күтіп, қоңырауды қайталаңыз.
- Егер мәселе шешілмесе, SIP транкын басқа Worker серверіне ауыстыруға болады (қараңыз: АТС-пен өзара әрекеттесу).
PBX → SIP.TG тіркеу кезіндегі қателер
Мұнда сіздің АТС SIP.TG Worker серверіне тіркелуге тырысқанда (PBX→SIP.TG типті қосылым) келіп түсуі мүмкін жауаптар жинақталған. Төменде көрсетілген барлық қателер әдетте 403 немесе 404 кодына ие.
403 Wrong password
403 Wrong password
Мәні: АТС дұрыс авторизациялануға тырысады, бірақ көрсетілген пароль SIP.TG күтетін парольмен сәйкес келмейді.
Не істеу керек:
- @siptg_bot ботынан
/gateway
бөліміндегі парольді тексеріп, АТС-те енгізілгенімен салыстырыңыз. - Қажет болса, ботта паролді өзгертіңіз («Паролді өзгерту» түймесі) және жаңасын АТС жағында енгізіңіз.
- Логин (username) де қателер жоқ екеніне көз жеткізіңіз.
403 Untrusted IP address
403 Untrusted IP address
Мәні: Пароль дұрыс, бірақ сіздің IP мекенжайыңыз осы SIP қосылымы үшін рұқсат етілген мекенжайлар тізімінде жоқ.
Не істеу керек:
- @siptg_bot ботында,
/gateway
бөлімінде тиісті SIP қосылымының баптауларын ашып:- Сіздің IP мекенжайыңызды сенімділер тізіміне қосыңыз.
- Немесе кез келген IP-ден қосылуға рұқсат беру үшін тізімді тазалаңыз (бірақ қауіпсіздік шараларын сақтаңыз).
- Егер желіңізде сыртқы IP өзгерсе, баптау кезінде мұны ескеріңіз (ACL-ді толығымен өшіру қажет болуы мүмкін).
403 Telegram session is inactive
403 Telegram session is inactive
Мәні: Байланыстырылатын Telegram аккаунты белсенді емес (авторизация жоғалған). Нәтижесінде SIP.TG нақты Telegram байланысы болмағандықтан транкті тіркеуден бас тартады.
Не істеу керек:
- @siptg_bot ботында
/gateway
бөлімінде Telegram аккаунтын қайта қосыңыз (телефон нөмірін авторизациялаңыз). - Егер Telegram аккаунты жойылған болса, Шлюз үшін басқа телефон нөмірін тағайындауға тура келеді.
- Толығырақ Telegram-мен өзара әрекеттесу бөлімін қараңыз.
403 Session storage is inactive
403 Session storage is inactive
Мәні: Telegram сессиясы сақталған сақтау орны (бұлтты немесе өз сақтау орны) қазіргі уақытта өшірілген немесе қолжетімсіз. Демек, Telegram сессиясымен жұмыс істеу мүмкіндігі жоқ.
Не істеу керек:
- Егер SIP.TG бұлтты сақтау орнын пайдалансаңыз,
/gateway
бөлімінде мәртебесін тексеріңіз. Мұндай ақаулар әдетте қысқа мерзімді болады. - Егер өз сақтау орнын пайдалансаңыз, оның іске қосылғанын және қолжетімді екенін тексеріңіз. Қажет болса, SIP.TG бұлтына ауысыңыз.
403 Worker is inactive
403 Worker is inactive
Мәні: Таңдалған Worker сервері SIP.TG жағында өшірілген немесе жаңарту/қайта жүктеу процесінде. Сервер PBX→SIP.TG тіркеуін қабылдай алмайды.
Не істеу керек:
- Боттың
/gateway
бөлімінде Worker баптауларын тексеріңіз. Егер сервер өшірілген болса, басқасын таңдаңыз немесе оның қайта белсенді болуын күтіңіз. - Егер бұл сіздің өз Worker серверіңіз болса, оны іске қосыңыз/қайта іске қосыңыз.
403 Worker address is not set
403 Worker address is not set
Мәні: Worker серверінің конфигурациясы «PBX→SIP.TG» типті қосылымдарды қарастырмайды. Мысалы, сервер тек «SIP.TG→PBX» немесе «IP⇿IP» үшін бапталған.
Не істеу керек:
- @siptg_bot ботында қосылым түрін (PBX→SIP.TG) қайта тексеріп, тиісті Worker таңдаңыз.
- Басқа түрдегі SIP қосылымын құрыңыз («SIP.TG→PBX» немесе «IP⇿IP»).
403 Route is not permitted
403 Route is not permitted
Мәні: Пайдаланылған Telegram сессиясына қолжетімділік қайтарып алынған немесе ол сізге тиесілі емес. Мысалы, сессияны құрған әкімші құқықтарынан айырылған, және сіз бұл сессияны пайдалана алмайсыз.
Не істеу керек:
- Өз Шлюз сессияңызды құрыңыз. Боттың
/gateway
бөлімінде сіз басқаратын Telegram нөмірін қосыңыз. - Бұрын сессияны құрған әкімші сіздің қолжетімділігіңізді алып тастамағанына көз жеткізіңіз.
404 Route not found
404 Route not found
Мәні: SIP сұрауында көрсетілген логин жоқ немесе қазірдің өзінде жойылған. SIP.TG сервері мұндай «аккаунтты» таппайды.
Не істеу керек:
/gateway
бөлімінде алынған логин/username-ді қайта тексеріңіз.- Егер бұл жазба бұрын жойылған болса, жаңасын құрыңыз.
- Сіздің АТС-те бот берген логиннің дәл солай жазылғанына көз жеткізіңіз (қосымша таңбалар немесе бос орындарсыз).
SIP → Telegram қоңырау кезіндегі қателер
Бұл қателер сіздің АТС қазірдің өзінде тіркелген (немесе IP-to-IP) және Telegram-ға шығыс қоңырау кезінде SIP.TG сервері Telegram аккаунтына дұрыс қоңырау шала алмаса, кодты қайтарады.
403 USER_PRIVACY_RESTRICTED
403 USER_PRIVACY_RESTRICTED
Мәні: Telegram пайдаланушысы оған қоңырау шала алатын адамдар шеңберін шектеген (мысалы, тек контактілер), ал сіздің шлюз аккаунтыңыз бұл тізімге кірмеген.
Не істеу керек:
- Қоңырау шалынатын пайдаланушыдан қоңырау рұқсатын баптауды сұраңыз: «Баптаулар → Құпиялылық → Дауыстық қоңыраулар» → «Барлық пайдаланушылар» немесе сіздің шлюз аккаунтыңызды «Әрқашан рұқсат ету» тізіміне қосу.
- Немесе мақсатты пайдаланушының контактілерінде шынымен бар аккаунтты пайдаланыңыз.
404 Not Found / 404 Chat not found / 404 USERNAME_NOT_OCCUPIED
404 Not Found / 404 Chat not found / 404 USERNAME_NOT_OCCUPIED
Мәні: SIP.TG берілген идентификатор (нөмір, user_id, username) бойынша Telegram аккаунтын таба алмады. Telegram мұндай жауапты мынадай жағдайларда қайтаруы мүмкін:
- Нөмір шынымен Telegram-да тіркелмеген.
- Пайдаланушы аты жоқ немесе босатылған.
- Профиль шектеулерге байланысты қолжетімсіз.
- Сіздің шлюз аккаунтыңыз телефон нөмірі бойынша іздеуді тым жиі жасайды.
Не істеу керек:
- Дұрыс идентификаторды пайдаланып жатқаныңызға көз жеткізіңіз (егер телефон болса — бұл нақты Telegram нөмірі болуы керек).
- Егер жиі пайда болса, форматта қателеспегеніңізді тексеріңіз. Мүмкін ішкі user_id пайдалану дұрысырақ.
405 REGISTER is required first
405 REGISTER is required first
Мәні: Сіз PBX→SIP.TG алдын ала тіркеусіз INVITE жібересіз, ал Worker толық REGISTER талап етеді.
Не істеу керек:
- АТС жағында «Registration» режимін қосыңыз (PBX→SIP.TG транкын тіркеңіз). Толығырақ АТС-пен өзара әрекеттесу бөлімін қараңыз.
408 Timeout of waiting RPC result
408 Timeout of waiting RPC result
Мәні: Telegram сервері уақытында жауап бермеді, немесе SIP.TG сұрауы Telegram-ға жүгінгенде ілініп қалды. Бұл шамадан тыс жүктеме немесе Telegram-дың спамға қарсы сүзгісі кезінде, қысқа уақытта көп шығыс қоңыраулар болғанда орын алады.
Не істеу керек:
- Шығыс қоңыраулардың қарқындылығын төмендетіңіз.
- Уақытша ақау болса, күтіп, қайталап көріңіз.
470 Anonymous user
470 Anonymous user
Мәні: SIP.TG ішкі user_id бойынша пайдаланушыға қоңырау шалуға тырысады, олмен нақты расталған контакт жоқ. Telegram мұндай «анонимді» қоңырауларды қабылдамайды.
Не істеу керек:
- Әдетте расталған нөмір немесе username бойынша қоңырау шалу керек, немесе пайдаланушы сізді контактілерге қосып, алдымен жазуы керек.
500 (басқалар)
500 (басқалар)
Мәні: Telegram жағындағы кез келген басқа ішкі қате. Кейде бұл аудио арнаны өңдеу кезіндегі күтпеген ақаулар, ішкі шамадан тыс жүктеме және т.б. белгілейді.
Не істеу керек:
- Желінің тұрақтылығын тексеріп, қоңырауды қайталаңыз.
- Егер қате бір нөмірде тұрақты түрде пайда болса, көмек сұраңыз. Толығырақ Көмек алу жолы бөлімін қараңыз.
503 Account is not running
503 Account is not running
Мәні: SIP.TG Worker сервері INVITE алды, бірақ қажетті аккаунт үшін белсенді сессия жоқ. Яғни, АТС REGISTER жауабын күтпей INVITE жіберген болуы мүмкін.
Не істеу керек:
- PBX→SIP.TG транкының сәтті тіркелгенін және Worker белсенді аккаунтты көретінін тексеріңіз.
- Кейде АТС-те транкты қайта жүктеу көмектеседі. Қажет болса, АТС-пен өзара әрекеттесу бөлімін қараңыз.
503 Session is not running
503 Session is not running
Мәні: Telegram сессиясы іс жүзінде ажыратылған. Ботта @siptg_bot сессия көрсетілгенімен, ол шынымен авторизацияланбаған болуы мүмкін.
Не істеу керек:
/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-дың спамға қарсы қорғанысы, қысқа уақытта тым көп шығыс қоңыраулар, әсіресе бейтаныс нөмірлерге болған кезде.
Не істеу керек:
- Қоңырау шалу жылдамдығын төмендетіңіз (АТС немесе скрипт жағынан).
- Жүктемені бөлу үшін бірнеше түрлі Telegram аккаунттарын пайдаланыңыз.
- Көрсетілген «retry after N» уақытын күтіп, қайталаңыз.
503 Worker is not ready
503 Worker is not ready
Мәні: Worker жақында қайта жүктелді немесе жаңартылуда және әлі инициализацияны аяқтамаған. Нәтижесінде қоңыраулар SIP деңгейінде қабылданбайды.
Не істеу керек:
- 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
Мәні: Қоңырау шалушының аккаунтында да SIP.TG Шлюзі белсендірілген. Қызмет мұндай әрекетті (Telegram→SIP) циклдар немесе күтпеген қоңырау циклдары болмас үшін блоктайды.
Не істеу керек:
- Егер шлюз болып табылатын аккаунттан қоңыраулар қабылдау қажет болса, оған басқа режимді (мысалы, Софтфон) немесе Шлюзсіз басқа Telegram аккаунтын пайдаланған дұрыс.
503 SIP account is unavailable
503 SIP account is unavailable
503 Worker is unavailable
503 Worker is unavailable
Егер аталған шешімдердің ешқайсысы көмектеспесе, көмек сұраңыз. Толығырақ Көмек алу жолы бөлімін қараңыз.