АТС-пен өзара әрекеттесу
PBX жүйелерімен интеграция SIP қосылымдары арқылы жүзеге асырылады, олар PBX жағынан да, SIP.TG жағынан да бірлесіп конфигурацияланады.
SIP.TG жағында SIP қосылымын жасау үшін:
Төменде әр түрлі SIP қосылым түрлеріне арналған арнайы параметрлер берілген.
Кестеден әр идентификатордың барлық сценарийлерде қолдануға кедергі келтіретін маңызды шектеулері бар екенін көруге болады. SIP.TG идентификаторлардың барлық түрлері мен олардың комбинацияларын қолдайды, сонымен қатар қажеттіліктеріңізге сәйкес оларды пайдалану басымдығын орнатуға мүмкіндік береді.
Мұндай Caller ID әртүрлі жағдайларда пайдаланушыда қай идентификаторлар бар екеніне байланысты идентификатордың үш түрін де қабылдай алады:
Caller ID-ден басқа, From өрісінде қоңырау шалушының аты (Caller Name) да болуы мүмкін, оның құрылуын жоғарыда аталған параметрлерден басқа, тағы екі параметрі бар ұқсас ережелермен басқаруға болады:
Пайдаланушыда телефон нөмірі мен пайдаланушы атының болуына байланысты, келесілердің бірі қолданылады:
Көбінесе өзара әрекеттесу келесідей құрылады:
- @siptg_bot іске қосып,
/gatewayбөліміне өтіңіз. - АТС-ке қосқыңыз келетін Telegram сессиясын таңдаңыз немесе “Қосылу” түймесін басып жаңа сессия жасаңыз (толығырақ Сессияны қадамдық қосу бөлімінде).
- Қосылым түріне сәйкес жаңа SIP қосылымын жасау түймелерінің бірін басыңыз: ”🆕 PBX→SIP․TG”, ”🆕 SIP․TG→PBX” немесе ”🆕 IP⇿IP”.
АТС-ке SIP қосылымын конфигурациялау
Көптеген параметрлер түймелерде ағымдағы мәндер ретінде көрсетіледі. Бұл параметрлерді өзгерту үшін, тиісті түймені басып, бот сұрағанда жаңа мәнді енгізіңіз. Алайда, кейбір түймелер басқаша жұмыс істейді:- Worker: басқанда, қол жетімді Worker серверлерінің тізімі пайда болады. Толық сипаттамасын көру және тағайындау үшін қажетті серверді тізімнен таңдаңыз.
- Белгі түймелері, мысалы “DTMF кіріс”, “DTMF шығыс”, “Қайта теру”, “Желілер”, “Хабарламаларды өңдеу”, “Callback” және “Жазылымды бөлісу”, ауыстырғыш ретінде жұмыс істейді. Бір рет басу опцияны іске қосады немесе өшіреді.
- Қосылым протоколы (UDP/TCP/TLS): әр басқан сайын келесі қол жетімді протоколға ауысады.
- Аккаунтты көрсету және Парольді қалпына келтіру: PBX жағында көрсетілуі керек SIP.TG-ге қосылу параметрлерін көрсетеді.
Worker сервері
Worker сервері
PBX-ке немесе телефония провайдеріне қосылатын серверді таңдауға мүмкіндік береді.3 түрлі сервер бар:
Тегін жазылымда тек кейбір SIP.TG жалпы серверлері қол жетімді.
| Сервер түрі | Сипаттама | Таңба |
|---|---|---|
| SIP.TG жалпы сервері | SIP.TG қолдауымен негізгі серверлер | ✅ |
| Басқа пайдаланушылардың сервері | Басқа пайдаланушылар ұсынған жалпыға қол жетімді серверлер | 🌐 |
| Жеке серверлер | Сіздің жеке серверлеріңіз, тек сіздің SIP аккаунттарыңыз үшін қол жетімді | 🔑 |
Аудио кодектер
Аудио кодектер
Кодектерді таңдау дауыстық байланыс сапасы мен үйлесімділігіне әсер етеді. Opus, alaw, mulaw, GSM және басқа кодектер қолданылады.
DTMF жіберу әдістері
DTMF жіберу әдістері
DTMF дауыстық мәзірмен өзара әрекеттесу үшін қажет. RFC2833 (ұсынылған), INFO және inband әдістері қол жетімді.
Нөмірлерді түрлендіру ережелері
Нөмірлерді түрлендіру ережелері
PBX-пен үйлесімділік үшін нөмір теру форматын орнатуға мүмкіндік береді. Толығырақ Нөмірлерді түрлендіру ережелері бөлімінде.
Басымдық
Басымдық
Басымдық Telegram → SIP қоңырауы кезінде SIP аккаунттарын шақыру ретін орнатуға мүмкіндік береді.Келесі ережелер қолданылады:
- Бірдей басымдықтағы аккаунттар бір уақытта шақырылады.
- Басымдық неғұрлым төмен болса, SIP аккаунттары соғұрлым ертерек шақырылады.
- Келесі басымдыққа өту алдыңғы басымдықтың барлық SIP аккаунттарына сәтсіз қоңыраудан кейін жүзеге асады.
Caller ID және Caller Name
Caller ID және Caller Name
Қоңырау шалу кезінде қоңырау шалушы идентификаторы мен көрсетілетін қоңырау шалушы атын қалыптастыру ережелері, екі бағытқа да қолданылады.Толығырақ Қоңырау шалушы идентификаторларының түрлері бөлімінде.
PBX → SIP.TG
Бұл режимде сіздің PBX SIP.TG-де SIP клиенті ретінде тіркеледі. Боттан SIP логин мен құпия сөз аласыз және оларды PBX-те көрсетесіз.Бұл ең қарапайым қосылу әдісі және көптеген жүйелерге (Asterisk, 3CX, FreePBX, т.б.) сәйкес келеді.
PBX→SIP.TG қосылым параметрлері бар скриншот
Аккаунтты көрсету және Парольді қалпына келтіру
Аккаунтты көрсету және Парольді қалпына келтіру
PBX жағында тіркелуі керек ағымдағы SIP желісінің логинін, құпия сөзін және қосылу мекенжайын көрсетеді.“Парольді қалпына келтіру” осы желі үшін жаңа SIP құпия сөзін алдын ала жасайды. Қалпына келтіргеннен кейін оны PBX жағында жаңарту қажет болады.
Сенімді IP-мекенжайлар
Сенімді IP-мекенжайлар
Осы аккаунтқа қосылуға рұқсат етілген IP-мекенжайлар мен субжелілер тізімі.
SIP.TG → PBX
Мұнда SIP.TG Worker сервері сіздің PBX-те тіркеледі. Ботта сіз PBX параметрлерін орнатасыз: логин, құпия сөз және мекенжай.PBX-тегі ақ тізімге SIP.TG IP-мекенжайларын қосуды ұмытпаңыз. Ағымдағы тізім: files.sip.tg/fw.txt.
SIP.TG→PBX қосылым параметрлері бар скриншот
Логин, Құпия сөз, Домен және Прокси
Логин, Құпия сөз, Домен және Прокси
PBX-ке қосылуды мүмкін ету үшін толтырылуы керек негізгі қосылым параметрлері.“Прокси” тек “Домен”-нен өзгеше болса ғана толтырылуы керек.
PBX-тегі нөмір
PBX-тегі нөмір
Пайдаланушы хабарлама жібермей Telegram қолданбасындағы қоңырау түймесін 📞 басқанда — бұл нөмір әдепкі нөмір ретінде қолданылып, PBX-ке жіберіледі.
IP ⇿ IP
Екі жақ бір-бірінің IP-мекенжайын біледі. Тіркеу мүмкін емес немесе қажет емес жағдайларда қолданылады (мысалы, статикалық бағдарлау).Тәжірибелі пайдаланушыларға арналған. PBX жағында маршруттарды конфигурациялауды қажет етеді.
IP⇿IP қосылым параметрлері бар скриншот
Мекенжай:порт
Мекенжай:порт
Қарсы жақтың (сіздің PBX) IP-мекенжайы мен порты.Қосылымды орнату үшін PBX жағында SIP.TG серверінің нақты IP-мекенжайымен қосылым жасау қажет. Бұл үшін SIP қосылымына тағайындалған Worker серверінің IP-мекенжайы қолданылады.Worker серверінің ағымдағы IP-мекенжайы ағымдағы параметрді өзгертуді сұрағанда хабарламада көрсетіледі.
Өріс:Мән
Өріс:Мән
Егер бірдей IP-мекенжайлар арасында бірнеше SIP қосылымын пайдаланғыңыз келсе, бұл өріс қосылымды дұрыс анықтау үшін қосымша SIP тақырыбын орнатуға мүмкіндік береді.Параметр
{SIP өріс аты}:{SIP өріс мәні} жұбы түрінде, қос нүкте : арқылы бөлінген.PBX-тегі нөмір
PBX-тегі нөмір
Пайдаланушы хабарлама жібермей Telegram қолданбасындағы қоңырау түймесін 📞 басқанда — бұл нөмір әдепкі нөмір ретінде қолданылып, PBX-ке жіберіледі.
Қоңырау шалушы идентификаторларының түрлері
Әрбір Telegram пайдаланушысында үш түрлі идентификатор болуы мүмкін:- Телефон нөмірі, аккаунт тіркелген нөмір. Ол әрқашан бар, бірақ әдепкі бойынша басқа пайдаланушылар үшін құпиялылық параметрлерімен жасырылған. Едәуір шектеулермен, телефон нөмірі арқылы пайдаланушымен байланыс орнату мүмкін.
- Пайдаланушы аты (Username) — бұл бірегей әріптік пайдаланушы аты. Әдепкі бойынша ол жоқ, көптеген пайдаланушылар оны орнатады, бірақ ол болмауы мүмкін. Керісінше, пайдаланушыда бірнеше жинақтаушы пайдаланушы аты болуы мүмкін. Пайдаланушы атымен пайдаланушымен байланыс орнатуға болады, шектеулер телефон нөміріне қарағанда әлдеқайда жеңіл, бірақ бұлттық PBX жүйелері көбінесе сандық емес қоңырау шалушы идентификаторларын пайдалануды қарастырмайды.
- Пайдаланушы ID — ішкі сандық идентификатор. Әрқашан бар, ешқашан өзгермейді, бірақ тек пайдаланушы ID арқылы пайдаланушымен байланыс орнату мүмкін емес — оны басқа әдістердің бірімен байланыс орнатылғаннан кейін ғана пайдалануға болады.
| Идентификатор түрі | Формат | Байланыс мүмкіндігі | Міндетті | Өзгертілетін | PBX қолдауы |
|---|---|---|---|---|---|
| Телефон нөмірі | сандық | шектеулі | иә | иә | иә |
| Пайдаланушы аты | әріптік | иә | жоқ | иә | шектеулі |
| Пайдаланушы ID | сандық | жоқ | иә | жоқ | иә |
Telegram → PBX
Әрбір SIP қосылымы үшін Telegram → PBX қоңыраулары үшінINVITE хабарламасындағы From өрісінде берілетін Caller ID құру ережелерін орнатуға болады.
Caller ID құру ережелері бірнеше жолдардан тұрады, әр жолда бір ереже. Әр ереже үлгі жол болып табылады, онда {phone}, {username} және {userid} үлгі параметрі ретінде рұқсат етіледі. Соңғы Caller ID құру кезінде, қоңырау шалушы Telegram пайдаланушысы туралы мәндерден тұратын барлық үлгі параметрлерінің бірінші ережесі қолданылады.
Caller ID құру мысалдары
Caller ID құру мысалдары
- Телефон нөмірі жасырылмаған болса — ол қолданылады.
- Әйтпесе, егер пайдаланушы аты орнатылған болса — жүйе оны таңдайды.
- Және тек ең ерекше жағдайда
0префиксімен пайдаланушы ID қолданылады — бұл тег идентификатор түрін түсіндірудегі екіұштылықты шешуге мүмкіндік береді.
{name}— UTF-8 форматындағы көрсетілетін аты (эмодзилерге байланысты PBX жағында мәселелер туындауы мүмкін);{name_ascii}— ASCII-ге түрлендірілген көрсетілетін аты (қауіпсіз нұсқа).
Caller Name құру мысалы
Caller Name құру мысалы
- телефон нөмірі
+префиксімен, одан кейін жақшаға жазылған көрсетілетін аты, - немесе
@префиксімен пайдаланушы аты, одан кейін жақшаға жазылған көрсетілетін аты, - немесе ең соңғы жағдайда — бөтен таңбаларсыз тек көрсетілетін аты.
PBX → Telegram
PBX жағынанINVITE сұрауын алған кезде, шақырылатын идентификатор жоғарыда сипатталған Caller ID параметріне толық сәйкес түсіндіріледі. Дегенмен, идентификатор түрін анықтау және ондағы префикстер мен бөтен таңбаларды кесіп тастау алгоритмі онша айқын көрінбейді.
Ережелерді өңдеудің толық алгоритмі
Ережелерді өңдеудің толық алгоритмі
Telegram → PBX қоңыраулары жағдайындағыдай, ережелер дәйекті түрде тексеріледі және түрлендірулерден кейін берілген критерийлерге сәйкес келетін біріншісінде таңдау тоқтайды:
- Ережедегі барлық үлгі параметрлері оларға сәйкес келетін тұрақты өрнектермен ауыстырылады:
{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-транк ретінде қосылатын PBX арқылы жүзеге асырылады. CRM өзі қоңыраулар мен контактілерді PBX-тің мүмкіндіктеріне байланысты “көреді”. CRM-де SIP.TG үшін арнайы модульдерді немесе плагиндерді орнату әдетте қажет емес.
- Telegram қоңырауы SIP.TG шлюзіне (Telegram аккаунтына) келеді.
- SIP.TG шлюзі қоңырауды SIP-ге түрлендіріп, оны PBX-ке (SIP-транк арқылы) жібереді.
- PBX CRM интеграциясы үшін қажетті модуль немесе плагині бар болса, кіріс қоңырауды таниды, клиент картасын көрсетеді, қоңырауды тіркейді немесе басқа әрекеттерді орындайды.
- Әңгіме аяқталғаннан кейін қоңырау туралы деректер (мысалы, ұзақтығы, нәтижесі) CRM-де де сақталады.
PBX клиенттің нөмірін қалай біледі?
PBX клиенттің нөмірін қалай біледі?
Кіріс немесе шығыс қоңырау кезінде кез келген заманауи PBX SIP тақырыптарын (CallerID, From, т.б.) қолдана алады, деректерді CRM модуліне “өткізу” үшін. SIP.TG шлюзі арқылы Telegram-нан SIP-транкқа қоңырау шалғанда, қоңырау шалушының идентификаторы беріледі (көбінесе Telegram ID немесе пайдаланушы аты ретінде көрсетіледі), ал PBX-тегі логика бұл идентификаторды CRM жазбаларымен салыстырады.Егер сіздің PBX шығыс қоңыраулар үшін CallerID басқара алса (мысалы, қажетті нөмірді “алмастырады”), онда CRM картада нақты телефон нөмірі мен Telegram контактілерін автоматты түрде жазып алады. Бірақ әр CRM мен PBX үшін көптеген егжей-тегжейлер бар; жалпы, бұл SIP.TG жағынан тікелей реттелмейді.
CRM-нан қоңырауды қалай бастауға болады?
CRM-нан қоңырауды қалай бастауға болады?
Егер CRM қоңырауды бастай алатын болса (мысалы, нөмірді басып қоңырау шалу), әдетте ол мұны PBX арқылы жасайды, оған Call API немесе AMI пәрменін жібереді (Asterisk, 3CX, т.б.). Содан кейін PBX сұрауды SIP.TG SIP-транкіне аударады, ал шлюз Telegram-ға қоңырау шалады. Бұл тағы да стандартты “CRM → PBX → SIP-транк” өзара әрекеттестігі, мұнда SIP.TG Telegram үшін телекоммуникация операторының рөлін атқарады.
Орнату мысалы
Орнату мысалы
- PBX-те @siptg_bot ішінде
/gatewayорнату кезінде берілген тіркелгі деректері бар аккаунт (SIP-транк) жасаңыз. - CRM-де дайын плагинді немесе модульді (Asterisk, 3CX, FreePBX, Yate, т.б. үшін) белсендіріңіз немесе API арқылы PBX-ке сыртқы сұраныстарды конфигурациялаңыз.
- CRM қоңыраулар туралы оқиғаларды алатынын тексеріңіз (карта көрінеді, журналдар жазылады) және қажет болса, тереңірек логиканы қосыңыз (қоңырауларды бөлу, әңгіме жазбаларын байланыстыру, автоматтандыру).
- CRM-нан шығыс қоңыраулар үшін — PBX “SIP.TG” SIP-транкі арқылы қоңырау жасай алатынын тексеріңіз (әдетте мұндай желі үшін маршрут немесе теру ережесі таңдалады).
Қосымша конфигурация қажет болған кезде
1
SIP-тақырыптарының кеңейтілген өрістері
Егер сіздің CRM жүйеңіз арнайы тақырыптарды қалыптастырса немесе күтсе (мысалы, X-CRM-ID), мұндай жағдайлар сіздің АТС құралдарымен шешіледі (Asterisk-те AGI-скриптер, 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 және басқалары) CRM-мен интеграциялауға арналған плагиндері немесе REST-интерфейстері бар. АТС құжаттамасын зерттеңіз: мүмкін, онда дайын мысал бар.
- Қоңырауларды қабылдау және бағыттау сценарийлері (IVR, операторлар кезегі, автоматты қайта бағыттау) — бұлардың барлығы АТС-тің жалпы функциялары. SIP.TG шлюзі мұндай сценарийлерді шектемейді және күрделендірмейді: олар басқа SIP-транктардағыдай жұмыс істейді.
Күрделендірмеңіз. CRM-ні Telegram-қоңырауларымен “достастыру” үшін SIP.TG шлюзін сіздің АТС-ке қосып, АТС-те бар CRM интеграциясының стандартты құралдарын пайдалану жеткілікті.Егер мәселелер немесе қателер туындаса, Сұрақтар және мәселелерді шешу бөлімін пайдаланыңыз.