ФрееПБХ

ФрееПБХ — компанияда қоңырауларды басқаруға мүмкіндік беретін тегін бағдарламалық қамтамасыз ету телепһоне сyстем.

Ерекшеліктер

Интернет арқылы телефон қоңыраулары: ВоЫП технологиясын қолданады, дәстүрлі телефон желісі орнына интернет арқылы қоңырау шалу мүмкіндігі.
Автоматты қоңырауларды тарату: кіріс қоңырауларды дұрыс нөмірлерге немесе бөлімшелерге автоматты түрде бағыттауға көмектеседі.
Интерактивті дауыстық мәзірлер (ЫВР): қоңырау шалушы тиісті бөлімшені таңдау үшін пернелерді басу арқылы мәзірден өтуіне мүмкіндік береді.
Дауыстық пошта: қоңырауға жауап берілмесе, ФрееПБХ хабарды жазып алып кейін тыңдауға болады.
Конференция қоңыраулары: бірнеше адамның бір уақытта қатысуына мүмкіндік беретін конференцияларды ұйымдастыру.
Қоңырауларды жазу: телефон әңгімелерін кейінгі тыңдау немесе талдау үшін жазып алуға болады.
Басқа жүйелермен интеграция: ФрееПБХ әртүрлі ЦРМ жүйелерімен, оның ішінде Планфіх-пен интеграциялануы мүмкін.

Байланыс

ФрееПБХ-ты Планфіх-пен екі тәсілмен қосуға болады:

Планфіх Телепһонy АПЫ
ФрееПБХ Ынтегратіон

Ескерту: Планфіх командасы клиенттің жағында Астеріск-ті конфигурацияламайды және осыған қатысты консультация бермейді.

Планфіх телефония үшін АПЫ

Осы әдісті қолдана отырып, сіз тек Планфіх-те қоңырау оқиғаларын ала аласыз, яғни қоңырау болғанда белсенді Планфіх қойындысында қоңырау картасы пайда болады.
Планфіх-тен қоңырау жасау мүмкіндігі жоқ.
Қоңырау жазбаларын алу үшін қосымша апацһе/нгінх баптауларын жасауыңыз қажет (5-қадам).

1-қадам

Серверде /етц/астеріск/ехтенсіонс_оверріде_фреепбх.цонф файлын өңдеп, оның ішінде келесі 3 контексттің болуын қамтамасыз етіңіз (мысал файл):

[мацро-діалоұт-оне-предіал-һоок]
[мацро-діалоұт-трұнк-предіал-һоок]
[мацро-һангұпцалл]

[мацро-һангұпцалл] үшін дәл дәлме-дәл үлгі бірдей болуы міндетті емес.

ехтенсіонс_аддітіонал.цонф файлын ашып, оның ішінен [мацро-һангұпцалл] контекстін тауып — көшіріп — өте басына келесі жолды қосыңыз:

exten => s,1,Macro(hangupcall-send-post)

2-қадам

Барлық контексттерді мысалынан ехтенсіон_цұстом.цонф-ке көшіріңіз. Бұл әрекетті ФрееПБХ интерфейсі арқылы да орындауға болады.

3-қадам

глобалс_цұстом.цонф файлына 3 жол қосып, {…} орнына сәйкес мәндерді қойыңыз:

ПБХ_ҰРЛ = {…} — сіздің ПБХ-тің ҰРЛ-ы
ПФ_ҰРЛ = {…} — сұрауларды қабылдайтын адрес
ПФ_КЕY = {…} — Планфіх авторизация токені

4-қадам

Планфіх-та Аццоұнт манагемент — Ынтегратіонс — Віртұал ПБХс — Планфіх АПЫ фор телепһонy бөліміне өтіңіз.
ПБХ мекенжайын толтырыңыз, сол арқылы Планфіх сол сайттан/адрестен келетін оқиғаларды қабылдай алатынын біледі.

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+)

Бастамас бұрын ехтенсіонс_оверріде_фреепбх.цонф файлында келесі енгізбені жасаңыз:

[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-қадам

ФрееПБХ-те пайдаланушы қосыңыз: Сеттінгс — Астеріск РЕСТ Ынтерфаце Ұсерс — Адд Ұсер.

Келесі өрістерді толтырыңыз:

РЕСТ Ынтерфаце Ұсер Наме: пайдаланушы аты
РЕСТ Ынтерфаце Ұсер Пассуорд: пароль
Пассуорд Тyпе: Плаін Техт
Реад Онлy: Но

Көшіріп алыңыз (4-қадамда қажет) және сақтаңыз.

2-қадам

Манагер қосыңыз: Сеттінгс — Астеріск Манагер Ұсерс — Адд Манагер:

Наме: атауы
Сецрет: әдепкі қалдырыңыз немесе өзіңіз орнатыңыз
Қалған баптауларды өзгерткен ұтымды емес.

Көшіріп алыңыз (4 және 6-қадамдарда қажет) және сақтаңыз.

3-қадам

Оң жақ жоғарғы бұрыштағы Апплy Цонфіг батырмасын басып баптауларды сақтаңыз.

4-қадам

Планфіх-та Прімарy Аццоұнт Адмін — Ынтегратіонс — Віртұал ПБХс — ФрееПБХ бөліміне өтіңіз.

Төмендегілерді толтырыңыз:

ПБХ аддресс: сіздің ПБХ-тің ҰРЛ-ы (АРЫ қолжетімді протокол мен портты қоса)
АРЫ Ұсер Наме: 1-қадамдағы Наме
АРЫ Ұсер Пассуорд: 1-қадамдағы Пассуорд

Қабылдаушы скрипт ҰРЛ-ын көшіріп, интеграцияны сақтаңыз.

5-қадам

Серверде:

/вар/споол/астеріск/ ішінде монітор қалтасына рецордінг атты символдық сілтеме жасаңыз (сол каталогта). Команда:

ln –s /var/spool/asterisk/monitor /var/spool/asterisk/recording

6-қадам

/етц/астеріск/ қалтасына өтіңіз
Егер сцріптс қалтасы болмаса, оны жасаңыз
сцріптс қалтасының ішінде амі_лістенер.пy файлын жасаңыз

7-қадам

амі_лістенер.пy файлын мысалына сәйкес толтырыңыз, мыналарды ауыстырыңыз:

Ёұр_ұсер_наме: 2-қадамдағы Наме-пен
Ёұр_ұсер_пассуорд: 2-қадамдағы Сецрет-пен
Ёұр_планфіх_ендпоінт_ұрл: 4-қадамнан алынған қабылдаушы скрипт ҰРЛ-пен

8-қадам

Файлға орындалатын құқық беріңіз:

chmod +x /etc/asterisk/scripts/ami_listener.py

9-қадам

/ліб/сyстемд/сyстем/ қалтасына өтіңіз
црм-астеріск-лістенер.сервіце атты файл жасаңыз
црм-астеріск-лістенер.сервіце файлын мысалына сәйкес толтырыңыз

10-қадам

Файлды автожүктелуге қосып, сервисті іске қосыңыз:

sudo systemctl enable crm-asterisk-listener

sudo systemctl start crm-asterisk-listener

Астеріск-тің ескі нұсқаларымен жұмыс

Астеріск 13+ үшін конфигурация файлдарына қосымша қасиеттер қосу қажет.

/етц/астеріск/цдр.цонф үшін

[general]
enable = yes
batch = no
unanswered = yes

/етц/астеріск/цдр_манагер.цонф үшін

[general]
enable = yes
unanswered = yes

Ескерту: қоңыраулар жазбаларын алу тек Астеріск 14+ үшін жұмыс істейтінін ескеріңіз.

Қосымша әдістер

Сіз осы әдістерді өзіңіз діалплан-нан шақыра аласыз.

Бақылаушылар туралы ақпарат алу

Интеграцияда көрсетілген ҰРЛ-ға ПОСТ сұрауын жіберіп, келесі мәліметтерді ұсына аласыз:

Цонтент-тyпе: аппліцатіон/жсон

{"евент": "цаллЫнфоРеспНұм", "ұніқұеЫд": "ұніқұе_цалл_ід", "інтНұм": "сһорт_ПБХ_ехтенсіон", "ехтНұм": "ехтернал_сұбсцрібер_нұмбер"}

Сіз жауап ретінде аласыз:

{"респонсіблеНұмберс":["сһорт_нұмбер_оф_респонсібле","сһорт_нұмбер_оф_сецонд_респонсібле(іф_анy)"]}

НЕМЕСЕ

Егер контактіге қатысты:

бақылаушылар жоқ болса
қысқа нөмірлер тағайындалмаған болса
бақылаушы ретінде шақырылған нөмірге қоңырау шалған қызметкер ("сһорт_ПБХ_ехтенсіон")

болса, жауапта келесі болады:

{"еррор":"но персонс респонсібле"}

Жоғалтылған қоңырау туралы хабарлама

Осы әдісті пайдалану үшін интеграция баптауларында — “Рецорд міссед цаллс онлy бy а сепарате спеціал реқұест” опциясын таңдаңыз:

7ТУеҺФ.пнг

Интеграцияда көрсетілген ҰРЛ-ға ПОСТ сұрауын жіберіп, келесі мәліметтерді ұсына аласыз:

Цонтент-тyпе: аппліцатіон/жсон
{"евент": "цаллМісседНотіфy", "ұніқұеЫд": "ұніқұе_цалл_ід", "інтНұм": "сһорт_ПБХ_ехтенсіон_то_рецеіве_міссед_цалл_нотіфіцатіон", "ехтНұм": "ехтернал_сұбсцрібер_нұмбер"}

Егер сол қысқа нөмірге ие қызметкер бар болса, ол жоғалтылған қоңырау туралы хабарлама алады.

ПОСТ сұрауына қайтарылатын жауап бос болады.

Жұмыс істеу туралы ескертулер

Скрипт жұмыс істеуі үшін "панораміск" кітапханасы орнатылғанына көз жеткізіңіз. Оны 'піп інсталл панораміск' көмегімен орнатуға болады.

Егер скрипт дереу басталмаса немесе амі_лістенер-ге өзгерістер енгізгеннен кейін командаларды орындасаңыз, келесі командалар көмектесуі мүмкін:

sudo systemctl daemon-reload

sudo systemctl restart crm-asterisk-listener

Интеграцияны өшіру үшін орындаңыз:

sudo systemctl stop crm-asterisk-listener

sudo systemctl disable crm-asterisk-listener

Барлық қосылу әдістерінде сіз баптаған болуыңыз керек:
- ішкі қалталар (Ехтенсіонс)
- кіріс және шығыс бағыттау (Ынбоұнд/Оұтбоұнд Роұтес)