ФреэПБХ
ФреэПБХ — компанияда қо'нг'ироқларни бошқаришга имкон берувчи бепул дастурий телефон тизими.
Хусусиятлари
- Интернет телефон қо'нг'ироқлари: ВоИП технологиясидан фойдаланади, одатий телефон тармог'и о'рнига интернет орқали қо'нг'ироқларни амалга оширади.
- Автоматик қо'нг'ироқларни тақсимлаш: кирувчи қо'нг'ироқларни компания ичидаги то'г'ри рақамлар ёки бо'лимларга автоматик ё'налтиришга ёрдам беради.
- Интерактив овозли менюлар (ИВР): қо'нг'ироқ қилувчи тегмаларни босиш орқали керакли бо'лимни танлаши учун интерактив овоз менюларини созлашингиз мумкин.
- Овозли почта: агар ҳеч ким қо'нг'ироққа жавоб бера олмаса, ФреэПБХ овозли хабарни ёзиб олиши мумкин, кейинроқ тингланади.
- Конференс-қо'нг'ироқлар: бир нечта одамлар бир вақтнинг о'зида иштирок этиши мумкин бо'лган конференс-қо'нг'ироқлар ташкил этиш имконияти.
- Қо'нг'ироқларни ёзиб олиш: суҳбатларни кейинчалик тинглаш ёки таҳлил қилиш учун ёзиб олиш мумкин.
- Бошқа тизимлар билан интеграция: ФреэПБХ турли CРМ тизимлари, жумладан Планфих билан интеграция қилиниши мумкин.
Улаш
ФреэПБХни Планфихга икки хил усулда улаш мумкин:
Эслатма: Планфих жамоаси мижоз томондаги Астерискни созламайди ва бундай масалаларда маслаҳат бермайди.
Планфих телефонияга мо'лжалланган АПИ
- Ушбу усул орқали фақат Планфихда қо'нг'ироқ тадбирларини қабул қилишингиз мумкин, я'ни қо'нг'ироқ содир бо'лганда фаол Планфих ёрлиг'ида қо'нг'ироқ картаси пайдо бо'лади.
- Планфихдан қо'нг'ироқ қилиш мумкин эмас.
- Қо'нг'ироқ ёзувларини олиш учун қо'шимча равишда апаче/нгинх ни созлашингиз керак (5-қадам).
1-қадам
Серверда /этc/астериск/эхтенсионс_оверриде_фреэпбх.cонф файлини таҳрир қилинг (мисол файл) ва унда қуйидаги 3 контекст бо'лишига ишонч ҳосил қилинг:
- [маcро-диалоут-оне-предиал-ҳоок]
- [маcро-диалоут-трунк-предиал-ҳоок]
- [маcро-ҳангупcалл]
[маcро-ҳангупcалл] контексти аниқ ко'ринишда бо'лиши шарт эмас, мисолдагидек бо'лиши керак эмас.
эхтенсионс_аддитионал.cонф файлида [маcро-ҳангупcалл] контекстини топинг — уни нусха ко'чиринг — ва қуйидаги қаторни энг бошида қо'шинг:
exten => s,1,Macro(hangupcall-send-post)
2-қадам
Барча контекстларни мисол дан эхтенсион_cустом.cонф га нусха ко'чиринг. Буни ФреэПБХ интерфейси орқали ҳам амалга ошириш мумкин.
3-қадам
глобалс_cустом.cонф га 3 қатор қо'шинг ва {…} о'рнига мос қийматларни қо'йинг:
- ПБХ_УРЛ = {…} — ПБХингизнинг УРЛи
- ПФ_УРЛ = {…} — со'ровларни қабул қилувчи манзил
- ПФ_КЕЙ = {…} — Планфих авторизация токени
4-қадам
- Планфихда Аccоунт манагемент — Интегратионс — Виртуал ПБХс — Планфих АПИ фор телепҳонй бо'лимига о'тинг.
- ПБХ манзилини то'лдиринг, шунда Планфих шу сайт ёки манзилдан келаётган тадбирларни қабул қилишини билади.
5-қадам
Ёзувларни олиш учун уларни веб-сервер орқали ташқи тарзда мавжуд қилишингиз керак. ФреэПБХга киритилган Апаче орқали буни амалга ошириш учун ёзувлар папкасига ҳавола қо'шинг. Папкада то'г'ри эгаси, гуруҳи ва рухсатлар — 775 бо'лиши керак.
- Ҳаволани яратинг:
ln -s /var/spool/asterisk/monitor /var/www/html/monitor
- Рухсатлар ва эгани таҳрирланг:
chmod -R 775 /var/www/html/monitor/chown -R asterisk:asterisk /var/www/html/monitor/
Агар Апаче бо'лмаган буилд ишлатаётган бо'лсангиз — о'зингизнинг веб-серверингиз учун шунга о'хшаш созламани амалга оширинг.
ФреэПБХ Интеграцияси
(ФреэПБХ 16+ / Астериск 18+)
Бошлашдан олдин эхтенсионс_оверриде_фреэпбх.cонф махсус созламалар файлига қуйидагиларни киритинг:
[macro-dialout-trunk-predial-hook]
exten => s,1,Gosub(planfix-mark-outbound,s,1)
same => n,MacroExit()
[planfix-mark-outbound]
exten => s,1,NoOp(Outgoing call from ${CALLERID(all)} to ${EXTEN})
same => n,Set(__CRM_DIRECTION=OUTBOUND)
same => n,NoOp(Setting CRM_DIRECTION=${CRM_DIRECTION})
same => n,Return()
[macro-dialout-one-predial-hook]
exten => s,1,Gosub(planfix-mark-inbound,s,1)
same => n,MacroExit()
[macro-dial-ringall-predial-hook]
exten => s,1,Gosub(planfix-mark-inbound,s,1)
same => n,MacroExit()
[planfix-mark-inbound]
exten => s,1,NoOp(Incoming call to ${EXTEN} from ${CALLERID(all)})
same => n,Set(__CRM_DIRECTION=INBOUND)
same => n,NoOp(Setting CRM_DIRECTION=${CRM_DIRECTION})
same => n,Return()
1-қадам
ФреэПБХни очинг ва фойдаланувчи қо'шинг: Сеттингс — Астериск РЕСТ Интерфаcе Усерс — Адд Усер.
Қуйидаги майдонларни то'лдиринг:
- РЕСТ Интерфаcе Усер Наме: фойдаланувчи номи
- РЕСТ Интерфаcе Усер Пассwорд: парол
- Пассwорд Тйпе: Плаин Техт
- Реад Онлй: Но
Кейин нусха ко'чиринг (4-қадамда керак бўлади) ва сақланг.
2-қадам
Манагер қо'шинг: Сеттингс — Астериск Манагер Усерс — Адд Манагер:
- Наме: ном
- Сеcрет: дефаулт қолдиринг ёки о'зингизники билан алмаштиринг
- Бошқа созламаларни о'згартирмаслик ма'қул.
Кейин нусха ко'чиринг (4 ва 6-қадамларда керак бўлади) ва сақланг.
3-қадам
О'нг юқори бурчакдаги Апплй Cонфиг тугмасини босиб созламаларни сақланг.
4-қадам
Планфихда Примарй Аccоунт Админ — Интегратионс — Виртуал ПБХс — ФреэПБХ қисмига о'тинг.
То'лдиринг:
- ПБХ аддресс: ПБХингизнинг УРЛи (протокол ва АРИ мавжуд портни о'з ичига олган)
- АРИ Усер Наме: 1-қадамдаги Наме
- АРИ Усер Пассwорд: 1-қадамдаги Пассwорд
Қабул қилувчи скрипт УРЛини нусха ко'чиринг ва интеграцияни сақланг.
5-қадам
Серверда:
- /вар/споол/астериск/ ичида монитор папкага реcординг номли симболли бог'ланма (сймлинк) яратинг (шу каталог ичида). Буйруқ:
ln –s /var/spool/asterisk/monitor /var/spool/asterisk/recording
6-қадам
- /этc/астериск/ га о'тинг
- Агар мавжуд бо'лмаса, сcрипц папкасини яратинг
- сcрипц папкасида ами_листенер.пй файлини яратинг
7-қадам
ами_листенер.пй ни мисол га асосан то'лдиринг, қуйидагиларни алмаштиринг:
- Ёур_усер_наме: 2-қадамдаги Наме билан
- Ёур_усер_пассwорд: 2-қадамдаги Сеcрет билан
- Ёур_планфих_эндпоинт_урл: 4-қадамдаги қабул қилувчи скрипт УРЛи билан
8-қадам
Файлни ижро этиладиган қилинг:
chmod +x /etc/asterisk/scripts/ami_listener.py
9-қадам
- /либ/сйстемд/сйстем/ га о'тинг
- cрм-астериск-листенер.сервиcе номли файл яратинг
- cрм-астериск-листенер.сервиcе ни мисол га мувофиқ то'лдиринг
10-қадам
Авто-ишга туширишга қо'шинг ва хизматни бошланг:
sudo systemctl enable crm-asterisk-listener
sudo systemctl start crm-asterisk-listener
Астерискнинг эски версиялари билан ишлаш
Астериск 13+ учун конфигурация файлларига қо'шимча хусусиятлар киритиш керак.
/этc/астериск/cдр.cонф учун
[general] enable = yes batch = no unanswered = yes
/этc/астериск/cдр_манагер.cонф учун
[general] enable = yes unanswered = yes
Эслатма: қо'нг'ироқ ёзувларини олиш фақат Астериск 14+ да ишлайди.
Қо'шимча усуллар
Сиз бу усулларни диалпландан о'зингиз чақиришингиз мумкин.
Мас'ул шахслар (супервисорс) ҳақида ма'лумот олиш
Интеграцияда ко'рсатилган УРЛга қуйидаги мазмундаги ПОСТ со'ров юборишингиз мумкин:
Cонтент-тйпе: апплиcатион/жсон
Жавобда оласиз:
ЙОКИ
Агар контакт учун:
- мас'ул шахслар мавжуд бо'лмаса
- қисқа рақамлар тайинланмаган бо'лса
- мас'ул шахс — чақирилган рақамга тенг бўлган ходим бўлса ("шорт_ПБХ_эхтенсион")
Унда жавоб қуйидагича бўлади:
Чалқанча қо'нг'ироқ ҳақида билдиришнома (Миссед cалл нотифиcатион)
- Ушбу усулдан фойдаланиш учун интеграция созламаларида — “Реcорд миссед cаллс онлй бй а сепарате спеcиал реқуэст” ни танланг:
Интеграцияда ко'рсатилган УРЛга қуйидаги мазмундаги ПОСТ со'ров юборишингиз мумкин:
Cонтент-тйпе: апплиcатион/жсон
{"эвент": "cаллМисседНотифй", "униқуэИд": "униқуэ_cалл_ид", "интНум": "шорт_ПБХ_эхтенсион_то_реcеиве_миссед_cалл_нотифиcатион", "эхтНум": "эхтернал_субсcрибер_нумбер"}
Агар шу қисқа рақамга эга ходим мавжуд бо'лса, унга миссед cалл билдиришномаси юборилади.
ПОСТ со'ровга жавоб бо'ш бо'лади.
Ишлашга оид эслатмалар
- Скрипт ишлаши учун "панорамиск" кутубхонаси о'рнатилганлигига ишонч ҳосил қилинг. Уни 'пип инсталл панорамиск' билан о'рнатиш мумкин.
- Агар скрипт дарҳол ишламаса ёки ами_листенер га о'згартиришлар киритгандан кейин муаммо бо'лса, қуйилар ёрдам бериши мумкин:
sudo systemctl daemon-reloadsudo systemctl restart crm-asterisk-listener
- Интеграцияни ўчириш учун:
sudo systemctl stop crm-asterisk-listenersudo systemctl disable crm-asterisk-listener
- Барча улаш усулларида қуйилар созланган бо'лиши шарт:
- ички қо'нг'ироқ рақамлари (Эхтенсионс)
- кирувчи ва чиқувчи маршрутлар (Инбоунд/Оутбоунд Роутес)