PBX жүйелерімен интеграция SIP қосылымдары арқылы жүзеге асырылады, олар PBX жағынан да, SIP.TG жағынан да бірлесіп конфигурацияланады.

SIP.TG жағында SIP қосылымын жасау үшін:

  1. @siptg_bot іске қосып, /gateway бөліміне өтіңіз.
  2. АТС-ке қосқыңыз келетін Telegram сессиясын таңдаңыз немесе “Қосылу” түймесін басып жаңа сессия жасаңыз (толығырақ Сессияны қадамдық қосу бөлімінде).
  3. Қосылым түріне сәйкес жаңа SIP қосылымын жасау түймелерінің бірін басыңыз: ”🆕 PBX→SIP․TG”, ”🆕 SIP․TG→PBX” немесе ”🆕 IP⇿IP”.

​
АТС-ке SIP қосылымын конфигурациялау

Көптеген параметрлер түймелерде ағымдағы мәндер ретінде көрсетіледі. Бұл параметрлерді өзгерту үшін, тиісті түймені басып, бот сұрағанда жаңа мәнді енгізіңіз.

Алайда, кейбір түймелер басқаша жұмыс істейді:

  • Worker: басқанда, қол жетімді Worker серверлерінің тізімі пайда болады. Толық сипаттамасын көру және тағайындау үшін қажетті серверді тізімнен таңдаңыз.
  • Белгі түймелері, мысалы “DTMF кіріс”, “DTMF шығыс”, “Қайта теру”, “Желілер”, “Хабарламаларды өңдеу”, “Callback” және “Жазылымды бөлісу”, ауыстырғыш ретінде жұмыс істейді. Бір рет басу опцияны іске қосады немесе өшіреді.
  • Қосылым протоколы (UDP/TCP/TLS): әр басқан сайын келесі қол жетімді протоколға ауысады.
  • Аккаунтты көрсету және Парольді қалпына келтіру: PBX жағында көрсетілуі керек SIP.TG-ге қосылу параметрлерін көрсетеді.

Төменде әр түрлі SIP қосылым түрлеріне арналған арнайы параметрлер берілген.

​
PBX → SIP.TG

Бұл режимде сіздің PBX SIP.TG-де SIP клиенті ретінде тіркеледі. Боттан SIP логин мен құпия сөз аласыз және оларды PBX-те көрсетесіз.

Бұл ең қарапайым қосылу әдісі және көптеген жүйелерге (Asterisk, 3CX, FreePBX, т.б.) сәйкес келеді.

PBX→SIP.TG қосылым параметрлері бар скриншот

​
SIP.TG → PBX

Мұнда SIP.TG Worker сервері сіздің PBX-те тіркеледі. Ботта сіз PBX параметрлерін орнатасыз: логин, құпия сөз және мекенжай.

PBX-тегі ақ тізімге SIP.TG IP-мекенжайларын қосуды ұмытпаңыз. Ағымдағы тізім: files.sip.tg/fw.txt.

SIP.TG→PBX қосылым параметрлері бар скриншот

​
IP ⇿ IP

Екі жақ бір-бірінің IP-мекенжайын біледі. Тіркеу мүмкін емес немесе қажет емес жағдайларда қолданылады (мысалы, статикалық бағдарлау).

Тәжірибелі пайдаланушыларға арналған. PBX жағында маршруттарды конфигурациялауды қажет етеді.

IP⇿IP қосылым параметрлері бар скриншот

​
Қоңырау шалушы идентификаторларының түрлері

Әрбір Telegram пайдаланушысында үш түрлі идентификатор болуы мүмкін:

  • Телефон нөмірі, аккаунт тіркелген нөмір. Ол әрқашан бар, бірақ әдепкі бойынша басқа пайдаланушылар үшін құпиялылық параметрлерімен жасырылған. Едәуір шектеулермен, телефон нөмірі арқылы пайдаланушымен байланыс орнату мүмкін.
  • Пайдаланушы аты (Username) — бұл бірегей әріптік пайдаланушы аты. Әдепкі бойынша ол жоқ, көптеген пайдаланушылар оны орнатады, бірақ ол болмауы мүмкін. Керісінше, пайдаланушыда бірнеше жинақтаушы пайдаланушы аты болуы мүмкін. Пайдаланушы атымен пайдаланушымен байланыс орнатуға болады, шектеулер телефон нөміріне қарағанда әлдеқайда жеңіл, бірақ бұлттық PBX жүйелері көбінесе сандық емес қоңырау шалушы идентификаторларын пайдалануды қарастырмайды.
  • Пайдаланушы ID — ішкі сандық идентификатор. Әрқашан бар, ешқашан өзгермейді, бірақ тек пайдаланушы ID арқылы пайдаланушымен байланыс орнату мүмкін емес — оны басқа әдістердің бірімен байланыс орнатылғаннан кейін ғана пайдалануға болады.
Идентификатор түріФорматБайланыс мүмкіндігіМіндеттіӨзгертілетінPBX қолдауы
Телефон нөмірісандықшектеуліиәиәиә
Пайдаланушы атыәріптікиәжоқиәшектеулі
Пайдаланушы IDсандықжоқиәжоқиә

Кестеден әр идентификатордың барлық сценарийлерде қолдануға кедергі келтіретін маңызды шектеулері бар екенін көруге болады. SIP.TG идентификаторлардың барлық түрлері мен олардың комбинацияларын қолдайды, сонымен қатар қажеттіліктеріңізге сәйкес оларды пайдалану басымдығын орнатуға мүмкіндік береді.

​
Telegram → PBX

Әрбір SIP қосылымы үшін Telegram → PBX қоңыраулары үшін INVITE хабарламасындағы From өрісінде берілетін Caller ID құру ережелерін орнатуға болады.

Caller ID құру ережелері бірнеше жолдардан тұрады, әр жолда бір ереже. Әр ереже үлгі жол болып табылады, онда {phone}, {username} және {userid} үлгі параметрі ретінде рұқсат етіледі. Соңғы Caller ID құру кезінде, қоңырау шалушы Telegram пайдаланушысы туралы мәндерден тұратын барлық үлгі параметрлерінің бірінші ережесі қолданылады.

Caller ID-ден басқа, From өрісінде қоңырау шалушының аты (Caller Name) да болуы мүмкін, оның құрылуын жоғарыда аталған параметрлерден басқа, тағы екі параметрі бар ұқсас ережелермен басқаруға болады:

  • {name} — UTF-8 форматындағы көрсетілетін аты (эмодзилерге байланысты PBX жағында мәселелер туындауы мүмкін);
  • {name_ascii} — ASCII-ге түрлендірілген көрсетілетін аты (қауіпсіз нұсқа).

​
PBX → Telegram

PBX жағынан INVITE сұрауын алған кезде, шақырылатын идентификатор жоғарыда сипатталған Caller ID параметріне толық сәйкес түсіндіріледі. Дегенмен, идентификатор түрін анықтау және ондағы префикстер мен бөтен таңбаларды кесіп тастау алгоритмі онша айқын көрінбейді.

​
CRM интеграциясы

CRM интеграциясы әдетте SIP.TG-мен тікелей емес, SIP.TG стандартты SIP-транк ретінде қосылатын PBX арқылы жүзеге асырылады. CRM өзі қоңыраулар мен контактілерді PBX-тің мүмкіндіктеріне байланысты “көреді”. CRM-де SIP.TG үшін арнайы модульдерді немесе плагиндерді орнату әдетте қажет емес.

Көбінесе өзара әрекеттесу келесідей құрылады:

  1. Telegram қоңырауы SIP.TG шлюзіне (Telegram аккаунтына) келеді.
  2. SIP.TG шлюзі қоңырауды SIP-ге түрлендіріп, оны PBX-ке (SIP-транк арқылы) жібереді.
  3. PBX CRM интеграциясы үшін қажетті модуль немесе плагині бар болса, кіріс қоңырауды таниды, клиент картасын көрсетеді, қоңырауды тіркейді немесе басқа әрекеттерді орындайды.
  4. Әңгіме аяқталғаннан кейін қоңырау туралы деректер (мысалы, ұзақтығы, нәтижесі) CRM-де де сақталады.

​
Қосымша конфигурация қажет болған кезде

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 интеграциясының стандартты құралдарын пайдалану жеткілікті.

Егер мәселелер немесе қателер туындаса, Сұрақтар және мәселелерді шешу бөлімін пайдаланыңыз.