Телефония: өз PBX

Мекемедегі телефон әдетте қалғанынан бөлек тұрады: нөмір байланыс операторында, тұтқа сөре үстінде, кім қоңырау шалғанын тек тұтқаны көтерген адам есте сақтайды. «Телефония» бөлімі осының бәрін жұмыс құралына айналдырады: филиалда өз PBX пайда болады — сіздің нөміріңізге қоңырауларды қабылдайтын, оларды өз ережелеріңіз бойынша қызметкерлерге бөлетін, сөйлесулерді жазып алатын және талдауға беретін телефон станциясы.

Ашу: Әкімші панелі → Телефония (admin.cenaly.com/telephony). Бөлім кеңейтімдер дүкеніндегі «Телефония» карточкасымен қосылады — әдепкі бойынша ол жасырылған.

Өз PBX деген не#

PBX сіздің филиалыңызға толығымен бөлінеді. Бұл — бұлттағы өз статикалық IP-мекенжайы және өз қосылу мекенжайы бар жеке машина: ол арқылы бөтен дауыс өтпейді, байланыс операторларындағы тіркелгілер сіздікі, біз нөмірлерді бермейміз және қайта сатпаймыз. Жаңа филиалдарға барлығына ортақ сервер мүлде ұсынылмайды.

Бөлімнің жоғарғы жағында үш жеке сұрақтан тұратын «Алғашқы қоңырауға дейін» чек-парағы бар. Баптаулар — төрт қадам (филиалдың SIP-тіркелгісін жасау → кіріс желісін қосу → кіріс қоңырауының жолын баптау → кемінде бір ішкі нөмір беру), «4-тен 3» есебі тек солар бойынша жүреді, аяқталмаған қадам — қажетті қойындыға сілтеме. Тексеру қоңырауы — қоңыраулар журналындағы белгі: соңғы қабылданған кіріс қоңырау; *43 эхо-тесті дыбысты тексереді, бірақ провайдер желісін емес, сондықтан қасында кеңес ретінде көрсетілген. Сөйлесуді жазу — сіздің таңдауыңыз (өшірілген / қоңырау шалушыларды ескертумен қосылған), ол «бәрі дайын» дегенге кірмейді: жасыл белгі үшін жазу қажет емес. Баптаулар дайын болып, қоңырау өткенде, чек-парақ бір жасыл жолға жиналады.

Неден бастау керек#

Тәртібі осылай, әрі ол қоңырау жолының тәртібі де — сырттан ішке қарай:

1-қадам. Нөмір: провайдер немесе шлюз#

Кіріс нөмірді сіз әкелесіз — байланыс операторымен өз шартыңыз бойынша. Үш көз бар, әрі олар қосылады:

Транктер мен нөмірлер саны шектелмеген — бұл сіздің машинаңыз және операторлардағы сіздің тіркелгілеріңіз; PBX баптаулары тізімінің жалпы шегі — 500 жазба.

2-қадам. Қызметкерлерге ішкі нөмірлер#

«Қызметкерлер мен топтар» қойындысы — ішкі нөмірлер. Олардың екі түрі бар: біздің ішкі нөмір (телефон немесе софтфон қосылатын біздің PBX-тегі тіркелгі; нөмірді өзіңіз бересіз — 2–6 цифр, мекеменің өз нөмірлеуі, ішкі нөмірлер санының шегі жоқ) және байланыс операторының мұраланған нөмірі — оның артында адамда бұрыннан бар нөмір тұр: бөгде PBX-тің ішкі нөмірі, ұялы немесе қалалық нөмір. Оған құпиясөз берілмейді, адамға қоңырау таңдалған арна арқылы жетеді.

3-қадам. Телефондар және софтфондар#

Сол бес мән (сервер, логин, құпиясөз, 5060 порты, UDP транспорты) кез келген аппаратқа енгізіледі: үстел телефоны, даяшының DECT трубкасы, домофон, ескі аналогты телефонға арналған адаптер немесе компьютер мен смартфондағы бағдарламалық телефон. Бір ішкі нөмірді бірден бірнеше құрылғыға тіркеуге болады.

Толық талдау — SIP-телефондарды баптау: деректемелерді қайдан алуға болады, мекеменің желісінен не қажет (шығыс UDP 5060 және 10000–20000, роутерде өшірілген SIP ALG), телефонды қашан зауыттық параметрлерге қайтару керек және 26 аппарат тобы бойынша қадамдық нұсқаулықтар. Сонда — *43 эхо-тесті: тердіңіз, өз дауысыңызды естідіңіз, ал қоңыраулар журналында осы аппарат бойынша жоғалтулар, джиттер және кідіріс пайда болды.

Өзінің жеке тіркелгілерін әркім өзі қосады: Параметрлер → «Жеке SIP-тіркелгілер» (admin.cenaly.com/settings?tab=sip-accounts) — бұл адамның бөгде жүйелердегі (байланыс операторында, кеңсе PBX-інде) тіркелулері немесе өз ішкі нөмірімен тіркелуі. Олар оның логиніне байланысты, компанияға емес, тек оған көрінеді және Cenaly қолданбаларының телефонына оның құрылғыларындағы Android үшін ғана келеді — Cenaly Admin («Телефон» қойындысы), Cenaly CRM («Тағы» → «Телефон») және Cenaly SIP Phone. Олар филиалдың PBX-іне, үстел телефондарына және веб-әкімшілікке түспейді (параметрлерді қараңыз).

4-қадам. Кіріс қоңырауларды маршруттау#

«Кіріс қоңырау жолы» қойындысы — «қоңырау келгенде кімге қоңырау шалу керек» ережелері. Ережелер жоғарыдан төменге тексеріледі, бірінші сәйкес келгені жеңеді; реттілік — басымдық, олар көрсеткілермен орны ауыстырылады.

Қоңырау шалу шахматкасы — жолы қатысушы, ал бағаны 5 секунд болатын тор: «алғашқы 10 секундта хостес қоңырау шалады, 10-нан бастап менеджер қосылады, 20-дан бастап хостес үнсіз қалады». Ұяшықтар тінтуірмен сүйреп боялады. Соңғы жол — AI: ол қоңырау шалмайды, жауап береді, сондықтан соңғы адам қоңырау шалуын аяқтаған жерден басталады.

Ережелер тізімінің астында — әдепкі жауап: бірде-бір ереже сәйкес келмесе не болады (сәлемдесу, автожауап беруші, бот). Сол жерде «әңгіме өңделуде» хабарламасының қосқышы, тіл таңдауымен және өз мәтінімен — кейбір елдерде ескерту міндетті, сондықтан әдепкі бойынша ол қосулы.

Ережелер қарап тұрған провайдерді жойсаңыз, панель алдымен сұрайды және әр ереже бойынша онымен не болатынын айтады: «осы провайдерсіз жұмысын жалғастырады» (шартта басқа нөмірлер немесе провайдерлер қалды), «өшіріледі» (провайдерсіз шарт кеңірек болар еді) немесе «өшіріледі және шартсыз қалады». Ережелер жойылмайды — шахматка мен қосалқы нұсқа орнында қалады. Бірде-бір шарты қалмаған ереже «шарт жоқ» деп белгіленеді және оның қосқышы қосылмайды: әйтпесе ол кез келген қоңырауды ұстап алар еді. Оған жаңа шарт қойыңыз (нөмір, провайдер, сағаттар немесе қоңырау шалушы префиксі) — және қосыңыз, немесе ережені жойыңыз.

Топ қоңыраулары («Қызметкерлер мен топтардағы» жолдар, «Топ» белгісімен) — ішкі нөмір (700-ден бастап беріледі) және өз бөлуімен: шахматка, қарапайым «барлығына бірден / кезекпен» қоңырау шалу немесе күту музыкасы, орын хабарламасы және уақыт шегі бар кезектер. Қатысушының «Қоңырау шалады» қосқышы, жеке жұмыс сағаттары, кідірту (қызметкер оны аппараттан өзі қояды: *71 — кетемін, *72 — қайттым) және өз ұстап тұру әуені бар; «Алдымен қонақ бұрын сөйлескен адамға қоңырау шалу» қосқышы бірнеше секунд таныс қызметкерді байқап көреді. Топқа үш есік апарады: телефоннан оның нөмірін теру, маршруттау ережесі және AI хатшысының қоңырауды аударуы. Cenaly Phone қолданбасында осындай қоңыраудың кіріс экранында шахматка көрінеді: кімге қазір қоңырау шалып жатыр, кім бірнеше секундтан кейін қосылады және кім бос емес. Ол жүктелгенше, оның орнында «Қоңырау шалу…» тұрады. Егер сізге тікелей өз қосымша нөміріңізге қоңырау шалса, шахматка жоқ: тек сізде қоңырау шалады. Қоңырауды әріптес алғанда, кіріс терезесі тағы бірнеше секунд кім алғанын көрсетеді. Алған адамды қалай атау — аты бойынша, қосымша нөмірімен аты бойынша, тек қосымша нөмірі бойынша немесе жай «Әріптес алды» — әкімші таңдайды: «Барлық қызметкерлерге арналған ережелер» терезесі, «Өз телефондары» блогы, «Қоңырауды кім алды — әріптестер не көреді». Қасында — конференц-бөлмелер («Конференциялар» қойындысы): PIN және бейне бар 600–649 қосымша нөмірлері, кез келген тіркелген құрылғыдан нөмірді тердіңіз — ортақ әңгімеге қосылдыңыз.

5-қадам. Шығыс қоңыраулар#

Шығыс қоңыраулар әдепкі бойынша өшірулі, және қосу ақша туралы мәтінмен расталады: сыртқа сіздің транкіңіз қоңырау шалады, шот-фактура сіздің байланыс операторыңыздан келеді. «Шығыс» қойындысы қызметкер өз телефонынан терген қоңыраудың қай желіден кететінін шешеді — талдау тәртібімен үш деңгей:

1. Ақылды ережелер «терілген нөмір үлгісі → желі»: цифрлар және X (кез келген), N (2–9), Z (1–9), соңғы нүкте «қанша цифр болса да». Ережені нақты қызметкерлерге тарылтуға, байланыс операторына жібермес бұрын цифрларды кесіп тастауға немесе қосуға және анықталатын нөмірді ауыстыруға болады;
2. қызметкердің жеке желісі — «әркімге өзінікі»;
3. әдепкі жалпы желі.

Анти-фрод әрқашан жұмыс істейді: филиалға және қызметкерге бір мезгілдегі шығыс қоңыраулар лимиті, теру ұзындығының шектері, премиум және спутниктік бағыттарға сөзсіз тыйым (баптаумен алынбайды) және әңгімелесу минуттарының тәуліктік шегі (әдепкі бойынша шек жоқ). Шектің 80 %-ында, ол таусылғанда және күдікті түнгі трафикте PBX жұмыс чатына пушпен дабыл жазады — ұрланған тіркелгіні айдың соңындағы байланыс операторының шот-фактурасынан емес, түнде құйылған минуттардан таниды.

6-қадам. Сөйлесуді жазу және «Қоңыраулар»#

«Жазба» қойындысы: қосу, аймақты таңдау (барлық қоңыраулар / тек кіріс / тек операторлық) және N күннен ескі жазбаларды жою керектігін шешу. Әдепкі бойынша жазбалар шектеусіз сақталады — мерзімді сіз белгілейсіз, жоғарыдан шек жоқ.

Жазылған әңгіме телефония плееріне ғана емес, «Қоңыраулар» бөліміне де (admin.cenaly.com/calls) түседі — жазбалармен жұмыс орталығы: файлдарды жүктеу және қабылдау, сүзгілері және сақталған көріністері бар кесте, сөйлеуді тану, әңгімені AI талдауы, тегтер, метрикалар, ережелер мен автоматтандырулар, іздеу және тапсырысқа байлау. Жазбалар қоймасының және «Қоңыраулар» бөлімінің сақтау мерзімдері бөлек бапталады. «Қоңыраулар» туралы толық мақала дайындалуда.

AI хатшысы, қоңырау жаттықтырушысы және кеңесші#

Телефония — үш AI беті жұмыс істейтін инфрақұрылым. Олар өз бөлімдерінде бапталады, ал PBX тек «қоңырауға кім жауап береді» дегенді шешеді. Хатшы мен қоңырау жаттықтырушысы туралы толық мақалалар дайындалып жатыр.

Сайттан қоңырау#

Екі тегін виджет сол PBX-те жұмыс істейді және кіріс қоңыраулардың сол ережелерімен келеді: сайттан қоңырау — тұтқа түймесі, қонақ тікелей браузерден сөйлейді, нөмір теру қажет емес және қолданба орнату қажет емес; кері қоңырау — қонақ нөмір қалдырады, PBX оны өзі тереді және мекемемен қосады, жауап берілмеген жағдайда қайталаулар және таңғы прозвонмен түнгі кезектер бар. Тек өз телефонияңыз үшін төлеу керек — виджеттердің өзі тегін.

«Телефония» бөлімінің қойындылары#

Қойындылар олардың үстіндегі төрт кіреберіске топтастырылған: Бүгін (Шолу), Жұмыс (Пульт, Қоңыраулар журналы, Дауыстық пошта, Конференциялар), Баптау (Желілер, Байланыс провайдерлері, Кіріс қоңырау жолы, Қызметкерлер мен топтар, Шығыс, Жазба) және Диагностика (Сервер). Бұл — тек топтастыру: қойындылардың мекенжайлары мен бүйір панеліндегі бекітулер бұрынғыша қалады. «Барлық мүмкіндіктер» түймесі барлық қойындыны бірден көрсетеді, ал «Функцияны табу» өрісі баптауды ескі сөздермен де табады («транк», «қосымша нөмір», «шахматка», «IVR»). Бөлім рөлге қарай кіреберіспен ашылады: иесі — «Бүгін», оператор — «Жұмыс», баптаушы — «Баптау»; өз таңдауыңызды сол жерде бекітуге болады. Қойындылардың үстінде күй жолағы бар: өзгеріс сақталды ма, оны PBX қабылдады ма және қандай баптаулар оның жаңаруын күтіп тұр.

«SIP-тің нәзік баптаулары» өзін-өзі түсіндіреді. Протоколдың үш ондаған үйлесімділік параметрі бар, және «қосылмай тұрған» телефон әдетте дәл солардың біреуіне тіреледі. Сондықтан осы терезедегі әр баптаудың үш бөліктен тұратын «Баптау туралы толығырақ» ашатын жері бар: «Қашан қажет» — оны дәл сізге тиіп-қашпау керек пе («телефон роутердің артында тұрғанша қосулы қалдырыңыз», «тек провайдердің талабы бойынша»); «Не өзгереді» — қосқанда және өшіргенде не болады, соның ішінде бағасы («сөйлесуді жазу мен қоңырау жаттықтырушысының кеңестері жоғалады: PBX бұл дыбысты енді естімейді»); «Қалай тексеру керек» — нақты әрекет және оның күтілетін нәтижесі («аппараттан *43 теріңіз — эхо-тест сіздің дауысыңызды қайтаруы керек», «„Аппаратқа қоңырау шалу“ түймесін басыңыз — ол шырылдауы керек», «„PBX қосылу тарихын“ ашыңыз»). Бос өріс — бұл әдепкі мән, ол қасында жазылған; байланысты толығымен үзуге болатын баптаулар (дыбысты тікелей алмасу, протоколдар жиынтығы, қоңырау шалушыны тану, шифрлау) белгішемен белгіленген. Егер телефония жұмыс істеп тұрса — мұнда ештеңеге тиюдің қажеті жоқ.

Қоңыраулар журналы: тек жазылғандар емес, барлық қоңыраулар#

«Қоңыраулар журналы» қойындысы (?tab=log) өз PBX-іңіздің барлық қоңырауларының тарихын көрсетеді, соның ішінде жазбасы жоқтарын да: жауап берілген, өткізіп алынған, бос, тасталған, робот қабылдаған. Жолда — уақыты, кім шалған, қай желіге, кімнің телефоны шырылдаған (қосымша нөмірлердің чиптері), кім көтерген, мәртебесі сөзбен және ұзақтығы.

Басқанда «қоңырау қалай өтті» модалкасы ашылады: іске қосылған маршруттау ережесі, әр мақсаттың тағдырымен әр шалған әрекет («5 с кейін көтерді», «29 с шырылдады, жауап бермеді», «бос», «қабылдамады»), фолбэк және қорытынды сөйлем. Әріптеске қоңырауды аудару — сол қоңыраудың оқиғасы, жаңа жазба емес: ізде «аудару» қадамы пайда болады, ал сөйлесу кесінділерге бөлінеді («қонақ ↔ қос. 101 Анна — 0:16», «қонақ ↔ қос. 102 Борис — 0:20»). Аудио және AI талдауы — «Қоңыраулар» бөлімінің «Жазбалар» қойындысында: қоңырау карточкасындағы «Жазбаны ашу» түймесі дәл сонда апарады.

Журналдағы уақыт — сіз қарап отырған құрылғының сағаты бойынша емес, филиалдың уақыт белдеуі бойынша. Қоңырау карточкасында белдеу күні бар жолдың астында жазылған — «Уақыт — филиалдың уақыт белдеуі бойынша (Europe/Moscow · GMT+3)», — және қоңырау маршрутының барлық уақыттары сол бойынша жүреді: қадамдар, «…-де шырылдады», сөйлесу кесінділері. Егер филиалдың белдеуі көрсетілмесе, уақыт сіздің құрылғыңыздың сағаты бойынша жүреді, және бұл да айтылған. «Қолдау үшін көшіру» мәтіні уақытты белдеуімен бірге жазады.

Сымды диагностикалау (SIP-трейс)#

«Қоңырау өтпейді», ал параметрлер бойынша бәрі дұрыс болғанда, дауласудың пайдасы жоқ — біздің PBX пен байланыс операторы нақты немен алмасқанын қарау керек. Ол үшін «Сервер» қойындысында «Сымды диагностикалау (SIP-трейс)» блогы бар.

SIP — қоңырау туралы келісетін қызметтік хабарламалар: REGISTER (телефон немесе транк өзі туралы мәлімдейді), INVITE (біреу қоңырау шалып жатыр), жауап кодтары (200 OK, 401, 403, 488…) және ішіндегі SDP блогы, онда кодектер мен дыбысқа арналған мекенжайлар аталады. Трейс — осы алмасудың стенограммасы, сервер оны қалай көреді.

Қалай жазу керек:

1. Телефония → «Сервер» → «Сымды диагностикалау» блогы. «15 минут жазу» түймесі жазу терезесін ашады (қасында «… дейін ашық» деген жазу көрінеді; терезенің шегі — 2 сағат).
2. Терезе ашық тұрғанда, сол қоңырауды қайталаңыз — трейс тек терезе ашық кезде болған нәрсені ғана көрсетеді.
3. «Жаңарту» түймесі алмасудың жаңа құйрығын тартады; жолдар түймелердің астындағы қараңғы терезеде пайда болады. «PBX алмасуды әлі жариялаған жоқ» деген жазу «бір минут күте тұрыңыз» дегенді білдіреді — машина құйрықты өз циклімен жариялайды, бұл қате емес.
4. «Тоқтату» терезені мерзімінен бұрын жабады; ол өзі де кез келген жағдайда жабылады: алмасуда қоңырау шалғандардың нөмірлері, яғни дербес деректер бар, сондықтан мұнда «қосып қойып ұмыту» мүмкін емес — және бұл әдейі жасалған.

Мазмұны туралы білу керек нәрсе: авторизация тақырыптарының мәндері (Authorization, WWW-Authenticate) жолдардан қиылып тасталады — трейсте құпиясөз жоқ; алмасудың құйрығы көрсетіледі, ал егер басы сыймаса, бұл туралы мәтіннің дәл үстінде жазылған. Бөлінген PBX-те алмасу, сонымен қатар, үнемі жазылады және машинада тәулік бойы сақталады, сондықтан «бір сағат бұрын қоңырау дыбыссыз болды» деген шағымды кейін де талдауға болады — панельде аралықты таңдау әзірге жоқ, өткен сағаттағы кесіндіні қолдау қызметі алады.

Типтік көріністерді қалай оқу керек:

Қолдау қызметіне не беру керек. Панельде файлмен жүктеп алу жоқ: трейс терезесіндегі мәтінді белгілеп, оны қоңырау уақыты мен нөмірін атап, хатқа тіркеңіз (немесе скриншот) — талдауға осы жетеді. Ыңғайлы болса, параметрлерде «Қолдау қызметіне рұқсат» қосыңыз, сонда қызметкер алмасуды өзі қарайды; қолдау қызметіне қалай жазу керектігі — осында.

⚠️ Диагностика тек бөлінген PBX-те қолжетімді: Asterisk-тегі логгер командасы ғаламдық, ал ортақ серверде ол басқа жалдаушылардың алмасуын жазар еді. Ортақ деңгейде қосу қабылданбайды.

API және MCP: CRM, өз бағдарламаларыңыз және AI ассистенттер#

Өз PBX-іңізді тек панельден басқаруға болмайды. «Телефония» бөлімінің тақырыбындағы «API және MCP» түймесі (PBX қосылған кезде кабинет иесіне көрінеді) сыртқы бағдарламаларға кілттер береді: CRM, өз есеп скриптіңіз немесе Claude мен Cursor сияқты AI ассистент.

Кілтті қалай беру керек. «Кілт жасау» → атауы («CRM», «Claude») → құқықтар жинағы: «CRM» (қоңыраулар журналы, жазбалар, бір басумен қоңырау шалу, қосымша нөмірлер), «AI ассистент» (соларға қоса қайта бағыттау, «мазаламаңыз» және кім бос екені), «Тек оқу» немесе «Барлығы» — не болмаса өз белгілеріңіз. Үш құқық тек жеке белгімен беріледі және ешбір жинаққа, тіпті «Барлығына» да кірмейді: «Қоңырау ережелерін өзгерту», «Конфигурацияны жүктеп алу» және «Конфигурацияны кестелерден жүктеу». Одан кейін — филиалдар (барлығы немесе таңдалғандары) және мерзім (мерзімсіз, 30, 90 немесе 365 күн). cpx_… түріндегі кілт бір рет көрсетіледі: оны бірден көшіріп алыңыз, біз тек ізін сақтаймыз. Құқықтарды кез келген уақытта өзгертуге болады, «Қайтарып алу» кілтті келесі сұраныстан бастап өшіреді.

API не істей алады. Сүзгілері бар қоңыраулар журналы (өткізіп алғандар, қосымша нөмір бойынша, нөмір бойынша, кезең бойынша) және маршруты бар қоңырау карточкасы; жазбаға сілтеме және «Қоңыраулардан» қорытындысы бар стенограмма; қажетті қосымша нөмірдің телефонынан бір басумен қоңырау шалу (алдымен сол қоңырау шалады, содан кейін нөмір теріледі); қосымша нөмірлер мен топтар, жеке қайта бағыттау және «мазаламаңыз»; кім бос, кім сөйлесіп жатқаны; кіріс/шығыс нөмірлері мен ережелері өзгерістер тарихымен. «Қоңырау ережелерін өзгерту» құқығымен кілт кіріс және шығыс ережелерін бір-бірлеп жасайды, өзгертеді, жояды және орнын ауыстырады (тек берілген өрістер өзгереді — көрші ережелерге тимейді), шығыс қоңырауларды қосады және өшіреді және ережелерді алдыңғы нұсқасына қайтарады. Қоңырауды қызметкерлерге бөлу (шахматка, кезектер, «барлығына») панельде бапталады — API ережесі қоңырауды топқа оның нөмірімен жеткізеді; шығыс елдері мен алаяқтыққа қарсы шектеулер кілтпен өзгертілмейді. Конфигурация құқықтарымен — Excel/CSV файлындағы сол кестелерді жүктеп алу және жүктеу: алдымен «не қосылады / өзгереді / жойылады» деген алдын ала қарау, содан кейін қолдану. Құпия сөздер мен логиндер API арқылы ешқашан берілмейді — жаңа қосымша нөмірлердің құпия сөздері тек панельде көрінеді.

AI ассистентті қалай қосу керек. Сол кілтпен MCP-сервері https://api.cenaly.com/pbx-api/mcp (streamable HTTP) жұмыс істейді. «Қалай қосу керек» қойындысында Claude Code, Claude Desktop және Cursor үшін дайын конфигтер бар — кілтті қойыңыз, сонда ассистент «бүгін кім қоңырау шалып, хабарласа алмады», «осы қонаққа Аннаның телефонынан қайта қоңырау шал» немесе «маған ұялы телефонға қайта бағыттауды қос» деген сұрақтарға жауап бере алады. Ассистент тек кілт рұқсат еткен құралдарды көреді.

ChatGPT және claude.ai — кілтсіз. Бұлттық ассистенттер сол MCP-серверін OAuth арқылы қосады: https://api.cenaly.com/pbx-api/mcp мекенжайын коннектор ретінде қосыңыз, Cenaly тіркелгісіне кіріңіз және қолданбаға не рұқсат етілгенін белгілеңіз — терезе қай қолданба қолжетімділік сұрап жатқанын көрсетеді. Қосылым кілттер тізімінде OAuth белгісімен пайда болады, сол жерден қайтарып алуға болады. Толығырақ, мысалдармен және шектеулермен — «Өз PBX-іңіздің API және MCP» анықтамасында.

Әзірлеушілерге. REST — https://api.cenaly.com/pbx-api/v1, кілт Authorization: Bearer <кілт> тақырыбында; OpenAPI 3.1 сипаттамасы және құжаттама беті терезедегі сілтемелерде (/pbx-api/v1/openapi.json, /pbx-api/v1/docs). Кілтке шектеулер: минутына 120 сұраныс және тәулігіне 20 000, бір басумен қоңырау шалу — минутына 10 және тәулігіне 300. Қоңырау оқиғалары (стенограммасы мен талдауы бар әрбір жазылған қоңырау) вебхук арқылы келеді — «Қоңыраулар» бөліміндегі «Вебхук» көзі. Кілт арқылы жасалған әрбір өзгеріс кілт атауымен әрекеттер журналында көрінеді.

Шектеулер#

• Шлюз арқылы шығыс қоңыраулар әзірге жоқ. SIM-картасы немесе қалалық желісі бар шлюз қоңырауларды PBX-ке әкеледі; ол арқылы панельден сыртқа қоңырау шалу мүмкін емес — шығыс ережесі тек провайдердің желісіне немесе транкіне жеткізеді. Және шлюзден келетін қоңырауларға маршруттау ережелері қолданылмайды: мұндай қоңыраудың желісі жоқ, сондықтан шлюз баптауларында топтың немесе қызметкердің нөмірі бірден көрсетіледі.
• Провайдер транкін шифрлау (TLS + SRTP) — 2026 жылдың қазанынан бастап PBX жаңартуымен (қалай қосу керек); ол тірі провайдермен әлі тексерілмеген, клиенттік сертификатпен өзара TLS қолдау көрсетілмейді. Телефондар үшін шифрлау бөлінген машинаны нәзік баптау арқылы қосылады (сертификатты ол өзі шығарады) — бұл бөлік әзірге тірі аппараттар паркінде тексерілмеген.
• Кейбір мүмкіндіктер тек бөлінген машинада бар: қоңырау шалу топтары мен кезектер, конференц-бөлмелер, сөйлесуді жазу, қосарланған нөмірге екі жақтан жету, SIP алмасуды диагностикалау. Көпір арқылы өз компьютеріңізде көтерілген PBX және ортақ сервердің қалдықтары оларды орындамайды; шығыс қоңыраулар мен маршруттау ережелерін де транкілері бар адам жинайды.
• Кодектер — G.711 A-law, µ-law және G.722; G.729, Opus және AMR қолдау көрсетілмейді. Телефондарды MAC-мекенжайы бойынша авто баптау (provisioning) жоқ — аппараттар қосымша нөмір терезесіндегі өрістермен немесе сіздің провижининг серверіңізбен бапталады.
• PBX қолжетімсіз елдер (жергілікті лицензия қажет немесе санкциялар қолданылады): Түркия, Беларусь, Қытай, Мысыр, БАӘ, Катар, Оман, Кувейт, Иран, Солтүстік Корея, Куба, Сирия. Ресейде бөлінген PBX рұқсат етілген және тек Yandex Cloud-та жұмыс істейді — cenaly.ru мекенжайында, онда ортақ сервер жабық.
• Синтезатор дауысы бұлтқа тәуелді: cenaly.ru мекенжайында хабарландыру тілдерінің тізімінде жергілікті синтезатор білетін тілдер ғана (алтауы). Кезектегі орын орыс және ағылшын тілдерінде хабарланады — басқа тілдерде кезек жұмыс істейді, бірақ орнын атамайды.
• Конференциялар v1: бөлмеге тек ішінен кіруге болады (сырттан қоңырау оған аударылмайды), бейне белсенді спикерді көрсетеді және VP8 кодегін талап етеді; ростер, модерация және конференцияларды жазу жоқ.
• Біз нөмірлерді сатпаймыз. Транк пен нөмірді байланыс операторынан өзіңіз сатып аласыз — нөмірді платформаның «ішіне» көшіру мүмкін емес, ол провайдерде қалады.

Ақаулықтарды жою#

Симптомдар бойынша жалпы талдау — ақаулықтарды жою; егер ештеңе көмектеспесе, бізге жазыңыз — көмекті қалай алуға болады.

Жиі қойылатын сұрақтар#

Бастау үшін сыртқы нөмір қажет пе?#

Жоқ. Нөмірсіз PBX сайттан және қолданбадан қоңырауларды қабылдай береді, ал қызметкерлер ішкі нөмірлер арқылы бір-біріне қоңырау шалады. Нөмір қонақтар қарапайым телефоннан хабарласуы керек болғанда қажет.

Қызметкердің ұялы телефонына қоңырауларды қабылдауға бола ма?#

Иә, екі тәсілмен. Мұраланған нөмір — ішкі нөмір бізде, ал қоңырау таңдалған арна арқылы оның ұялы телефонына кетеді (бізде тіркелгі алмайды). Нөмірді толық қайталау — қызметкердің телефоны бізге тіркеледі, сонда ол топтарға, шахматкаға және ережелерге қалғандармен бірдей қатысады.

Телефония қанша тұрады?#

PBX-тің өзі — ақылы қызмет: арнайы сервер тіркелгі балансынан тәулік сайын есептен шығарылады (толық тәулік жұмыс — пакет бағасы, толық емес — уақытқа пропорционалды, тәулік UTC бойынша), және жасау алдындағы растау бұл туралы ескертеді. Қай тәуліктер үшін қанша есептен шығарылғаны сервер карточкасында («Тәуліктер бойынша есептен шығарулар») және «Жазылым» бөлімінде көрінеді. Сөйлесулер үшін байланыс операторыңызға оның тарифі бойынша төлейсіз — біз бұл тізбекте делдал емеспіз. «Сайттан қоңырау» және «Кері қоңырау» виджеттері тегін.

Қатысты бөлімдер#

• Провайдер нөмірін қосу — SIP-транк: тіркелу немесе IP бойынша авторизация
• GSM-шлюз, қалалық желі немесе ISDN — SIM-карта және аналогтық желі сіздің PBX-те
• SIP-телефондарды баптау — қосымша нөмірдің деректемелері, желі, *43 эхо-тесті, маркалар бойынша нұсқаулықтар
• Жабдық: не қосылады — телефондар, DECT-базалар және шлюздер филиал жабдығының жалпы көрінісінде
• Сайттан қоңырау және Кері қоңырау — нөмірсіз қонақтардың қоңыраулары
• Қызметкерлер және ауысымдар — қосымша нөмірлерді кімге беру керек
• Баптаулар — «Жеке SIP-тіркелгілер» қойындысы және тіркелгінің басқа баптаулары
• Назар аударуды қажет етеді — өткізіп алынған қоңыраулар мен телефония ақаулықтары жалпы істер тізімінде