Различия

Здесь показаны различия между двумя версиями данной страницы.

--- configure_freepbx_for_cloud_version [2018/07/27 08:46]
Евгений Романенко
+++ configure_freepbx_for_cloud_version [2023/10/31 12:26] (текущий)
Denis Babak
@@ Строка 1: / Строка 1: @@
-===== Инструкция по подключению FreePBX к облачному сервису системы статистики ViStep.RU =====
+===== Инструкция по подключению FreePBX к облачному сервису системы статистики FETG.UZ =====
 ==== Вводная ====
-  * Данная инструкция написана используя FreePBX версии 13.0.191.11 с Asterisk 13.14.0 на борту. \\ При возникновении каких-либо сложностей/вопросов с более ранними/поздними версиями системы, просьба написать нам на <support@vistep.ru>.
+  * Данная инструкция написана, используя FreePBX версии 13.0.191.11 с Asterisk 13.14.0 на борту. \\ При возникновении каких-либо сложностей/вопросов с более ранними/поздними версиями системы, просьба написать нам на <support@fetg.uz>.
   * Для выполнения описанных ниже действий понадобится: \\ - умение подключиться к серверу по ssh \\ - умение редактировать файлы в текстовом редакторе (nano/vim/emacs/etc) \\ - ясная голова и хорошее настроение ;-)
 ==== Настройка ====
-В поставке по умолчанию (что называется "из коробки") FreePBX ведет БД asteriskcdrdb, а точнее табличку cdr, не совсем так, как это нужно для правильной работы системы статистики ViStep.RU. Также она совсем не пишет в таблицу queue_log, что является необходимым. \\ Поэтому нам потребуется выполнить несколько шагов настройки, для достижения нужного поведения FreePBX.
+В поставке по умолчанию (что называется "из коробки") FreePBX ведет БД asteriskcdrdb, а точнее табличку cdr, не совсем так, как это нужно для правильной работы системы статистики FETG.UZ. Также она совсем не пишет в таблицу queue_log, что является необходимым. \\ Поэтому нам потребуется выполнить несколько шагов настройки, для достижения нужного поведения FreePBX.
   - Начнем с таблицы cdr. \\ Подключимся к серверу по ssh, а затем к консоли MySQL-сервера <code bash>[root@localhost ~]# mysql asteriskcdrdb
 Welcome to the MySQL monitor.  Commands end with ; or \g.
@@ Строка 28: / Строка 28: @@
 END $$
 DELIMITER ;
- </code> При успешном выполнении запросов все должно выглядеть примерно вот так: {{https://i.your-admin.pro/i/db8d2543734bb135bdf8c97348a6.png}} {{https://i.your-admin.pro/i/3e7f9092a8223081d718eeff6453.png}}
+ </code> При успешном выполнении запросов все должно выглядеть примерно вот так: {{https://img.fetg.uz/i/db8d2543734bb135bdf8c97348a6.png}} {{https://img.fetg.uz/i/3e7f9092a8223081d718eeff6453.png}}
-  - Совершим вызов и проверим, что поле filename заполняется {{https://i.your-admin.pro/i/e2659473414c0af4ae19163751fd.png}}
+  - Совершим вызов и проверим, что поле filename заполняется {{https://fetg.uz/i/e2659473414c0af4ae19163751fd.png}}
-  - Теперь нам необходимо изменить логику заполнения полей dst и src в таблице cdr так, чтобы в них всегда попадали те номера, на которые/с которых поступил вызов (например, не номер оператора очереди, а наш городской номер, на который пришел вызов извне для dst или не номер транка, а номер внутреннего абонента для src). \\ Для этого отредактируем файл cdr_adaptive_odbc.conf (FreePBX не перетрет его после рестарта, поэтому можно смело его редактировать), добавив в самом низу строку <code bash>alias realdst => dst
+  - Теперь нам необходимо добавить два новых поля в таблицу cdr - realdst и realsrc, в которые будут записываться номера звонящего и назначения (например, не номер оператора очереди, а наш городской номер, на который пришел вызов извне для realdst или не номер транка, а номер внутреннего абонента для realsrc). \\ Для этого выполним sql-запросы <code sql>ALTER TABLE `cdr` ADD `realsrc` VARCHAR(80) NOT NULL DEFAULT '';
-alias realsrc => src</code> В итоге он примет вид: {{https://i.your-admin.pro/i/23eeef966abc49cb214bd5795912.png}}
+ALTER TABLE `cdr` ADD `realdst` VARCHAR(80) NOT NULL DEFAULT '';
-  - Дабы наши действия возымели силу, модулю cdr_adaptive_mysql.so нужно подсказать, что его конфиг изменился. Подключаемся к консоли asterisk и релоадим модуль вот так: <code bash>[root@localhost asterisk]# asterisk -r
+UPDATE cdr SET realsrc=src;
-localhost*CLI> module reload cdr_adaptive_odbc.so
+UPDATE cdr SET realdst=dst;</code>
-Module 'cdr_adaptive_odbc.so' reloaded successfully.
+  - Пришло время последнего, но отнюдь не маловажного шага в разрезе конфигурирования таблицы cdr - научим АТС записывать данные во вновь созданные поля. \\ \\ Отредактируйте /etc/asterisk/extensions_override_freepbx.conf, внеся в него <code>[ext-did-catchall]
-localhost*CLI>  </code>
+include => ext-did-catchall-custom
-  - Пришло время последнего, но отнюдь не маловажного шага в разрезе конфигурирования таблицы cdr. \\ Есть два варианта внесения нужных данных в поля src и dst: \\ **Первый.** \\В web-интерфейсе FreePBX отправимся по пути "Admin-> Config Edit", где в extensions_custom.conf внесем: <code bash>[from-internal]
+exten => _.,1,Noop(Catch-All DID Match - Found ${EXTEN} - You probably want a DID for this.)
-exten => _X.,1,GoSub(set_right_src_dst_from-internal,start,1(${EXTEN},${CALLERID(num)}))
+exten => _.,n,Set(__FROM_DID=${EXTEN})
+exten => _.,n,Set(_FETGUZREALDST=${FROM_DID})
+exten => _.,n,Set(_FETGUZREALSRC=${CALLERID(num)})
+exten => _.,n,Set(CDR(realsrc)=${FETGUZREALSRC})
+exten => _.,n,Set(CDR(realdst)=${FETGUZREALDST})
+exten => _.,n,Goto(ext-did,s,1)
-[from-pstn-custom]
-exten => _X.,1,GoSub(set_right_src_dst_from-pstn,start,1(${EXTEN},${CALLERID(num)}))
-[set_right_src_dst_from-pstn]
+[sub-record-check]
-exten => start,1,Set(__FROMPSTNCALL=1)
- same => n,Set(CDR(realdst)=${ARG1})
- same => n,Set(CDR(realsrc)=${ARG2})
- same => n,Return()
-[set_right_src_dst_from-internal]
-exten => start,1,ExecIF(${FROMPSTNCALL}?Set(CDR_PROP(disable)=true):Set(CDR(realdst)=${ARG1}))
- same => n,Set(CDR(realsrc)=${ARG2})
- same => n,Return()
-</code> А вот и скрин, для наглядности {{:screen_shot_2017-09-14_at_09.34.12.png|}}  В завершении кликнем Save, затем Apply Config, позвоним на АТС, с АТС вовне и проверим корректность заполнения полей dst и src. \\**Второй.** \\Скопируйте содержимое диалплана из /etc/asterisk/extensions_additional.conf со строки <code>[sub-record-check]</code> до строки <code>;--== end of [sub-record-check] ==--;</code> включительно, вставьте скопированный код в /etc/asterisk/extensions_override_freepbx.conf и отредактируйте, добавив установку полей src и dst, например, так: <code>[sub-record-check]
 include => sub-record-check-custom
 exten => s,1,GotoIf($[${LEN(${FROMEXTEN})}]?initialized)
@@ Строка 93: / Строка 85: @@
 exten => recordcheck,n(startrec),Noop(Starting recording: ${ARG2}, ${ARG3})
 exten => recordcheck,n,Set(AUDIOHOOK_INHERIT(MixMonitor)=yes)
+exten => recordcheck,n,ExecIF($[${LEN(${FETGUZREALDST})}]?NoOP():Set(CDR(realdst)=${ARG3}))
+exten => recordcheck,n,ExecIF($[${LEN(${FETGUZREALSRC})}]?NoOP():Set(CDR(realsrc)=${FROMEXTEN}))
 exten => recordcheck,n,Set(__CALLFILENAME=${ARG2}-${ARG3}-${FROMEXTEN}-${TIMESTR}-${UNIQUEID})
+exten => recordcheck,n,Gosub(sub-check_recordfiles,s,1(${ARG2}))
 exten => recordcheck,n,MixMonitor(${MIXMON_DIR}${YEAR}/${MONTH}/${DAY}/${CALLFILENAME}.${MON_FMT},abi(LOCAL_MIXMON_ID)${MIXMON_BEEP},${MIXMON_POST})
 exten => recordcheck,n,Set(__MIXMON_ID=${LOCAL_MIXMON_ID})
@@ Строка 106: / Строка 101: @@
 exten => out,1,Noop(Outbound Recording Check from ${FROMEXTEN} to ${ARG2})
+exten => out,n,Set(CDR(realsrc)=${FROMEXTEN})
+exten => out,n,Set(CDR(realdst)=${ARG2})
+exten => out,n,Set(CUTTEDCHANNEL=${CUT(CHANNEL,,1)})
+exten => out,n,Set(CUTTEDCHANNEL=${CUT(CUTTEDCHANNEL,/,2)})
+exten => out,n,ExecIf($["${FROMEXTEN}" = "${ARG2}"]?Set(CDR(realsrc)=${CUTTEDCHANNEL}))
 exten => out,n,Set(RECMODE=${DB(AMPUSER/${FROMEXTEN}/recording/out/external)})
 exten => out,n,ExecIf($[!${LEN(${RECMODE})} | "${RECMODE}" = "dontcare"]?Goto(routewins))
@@ Строка 117: / Строка 117: @@
 exten => in,n,Set(FROMEXTEN=unknown)
 exten => in,n,ExecIf($[${LEN(${CALLERID(num)})}]?Set(FROMEXTEN=${CALLERID(num)}))
+exten => in,n,Set(_FETGUZREALDST=${ARG2})
+exten => in,n,Set(_FETGUZREALSRC=${FROMEXTEN})
+exten => in,n,Set(CDR(realsrc)=${FETGUZREALSRC})
+exten => in,n,Set(CDR(realdst)=${FETGUZREALDST})
 exten => in,n,Gosub(recordcheck,1(${ARG3},in,${ARG2}))
 exten => in,n,Return()
 exten => exten,1,Noop(Exten Recording Check between ${FROMEXTEN} and ${ARG2})
-exten => exten,n,ExecIF(${FROMPSTNCALL}?Set(CDR_PROP(disable)=true):Set(CDR(realdst)=${ARG2}))
+exten => exten,n,ExecIF($[${LEN(${FETGUZREALDST})}]?NoOP():Set(CDR(realdst)=${ARG2}))
-exten => exten,n,Set(CDR(realsrc)=${FROMEXTEN})
+exten => exten,n,ExecIF($[${LEN(${FETGUZREALSRC})}]?NoOP():Set(CDR(realsrc)=${FROMEXTEN}))
 exten => exten,n,Set(CDR(cnum)=${FROMEXTEN})
 exten => exten,n,Set(CALLTYPE=${IF($[${LEN(${FROM_DID})}]?external:internal)})
@@ Строка 175: / Строка 179: @@
 exten => parking,n,ExecIf($[!${LEN(${RECMODE})}]?Set(RECMODE=dontcare))
 exten => parking,n,Gosub(recordcheck,1(${RECMODE},parked,${USER}))
-exten => parking,n,Return()
+exten => parking,n,Return()</code> \\ после чего выполните команду <code>dialplan reload</code> в консоли Asterisk \\ **Код проверен на FreePBX 13.0.191.11 и 14.0.2.10** \\ Если мажорная (13 в данном примере) версия FreePBX  у вас отличается, то контекст [sub-record-check] может быть немного другим. Напишите нам на <support@fetg.uz> и мы поможем с написанием диалплана данного контекста.
-;--== end of [sub-record-check] ==--;</code> \\после чего выполните команду <code>core reload</code> в консоли Asterisk* \\*
   - С cdr разобрались, дело за queue_log. Эта таблица нужна нам для того, чтобы понимать какие события происходили в очередях Asterisk. Перво-наперво создадим ее <code sql>CREATE TABLE `queue_log` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
@@ Строка 193: / Строка 195: @@
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;</code>
   - Научим FreePBX(читай Asterisk) писать туда все то, что нам нужно. \\ Отправляемся в web-интерфейс по знакомой дорожке и создаем новый файл под именем **extconfig.conf**, кликнув Add New File. \\ Внести в него нужно лишь одну строчку <code bash>[settings]
-queue_log => odbc,asteriskcdrdb</code> Скрин: {{https://i.your-admin.pro/i/5347bc8b8a5a1f66dd9c87a7c980.png}} *не забываем про Save и Apply Configs \\ После выполнения данных действий и совершения звонков в очереди, запрос из консоли mysql <code sql>select * from queue_log;</code> должен вернуть вам нечто подобное {{https://i.your-admin.pro/i/7d2a89142a30ddd7ea0c36e2443b.png}} *на запрос в скрине не ориентируйтесь, там я специально добавил условие, чтобы сократить выхлоп
+queue_log => odbc,asteriskcdrdb</code> Скрин: {{https://img.fetg.uz/i/5347bc8b8a5a1f66dd9c87a7c980.png}} *не забываем про Save и Apply Configs \\ После выполнения данных действий и совершения звонков в очереди, запрос из консоли mysql <code sql>select * from queue_log;</code> должен вернуть вам нечто подобное {{https://img.fetg.uz/i/7d2a89142a30ddd7ea0c36e2443b.png}} *на запрос в скрине не ориентируйтесь, там я специально добавил условие, чтобы сократить выхлоп
-  - С препарированием нашей АТС по части БД закончили! \\ Переходим к настройке синхронизации БД и файлов записей разговоров в облако ViStep.RU. Для этого воспользуйтесь инструкцией - https://wiki.vistep.ru/doku.php?id=cloud_daemon_sync
+  - С препарированием нашей АТС по части БД закончили! \\ Переходим к настройке синхронизации БД и файлов записей разговоров в облако FETG.UZ. Для этого воспользуйтесь инструкцией - https://wiki.fetg.uz/doku.php?id=cloud_daemon_sync
-  - Для входа в систему статистики используйте данные авторизации (Email-адрес/Пароль для авторизации) из регистрационного письма.
+  - Для входа в систему статистики используйте данные авторизации (Email-адрес/Пароль) из регистрационного письма.
-На этом все настройки завершены. \\ Если вы все сделали правильно, то через какое-то время (зависит от размера БД) сможете воспользоваться всеми отчетами системы статистики ViStep.RU в своем личном кабинете. \\ Повторюсь, если у вас остались вопросы и/или есть предложения/замечания, пишите нам на <support@vistep.ru>.
+На этом все настройки завершены. \\ Если вы все сделали правильно, то через какое-то время (зависит от размера БД) сможете воспользоваться всеми отчетами системы статистики FETG.UZ в своем личном кабинете. \\ Повторюсь, если у вас остались вопросы и/или есть предложения/замечания, пишите нам на <support@fetg.uz>.

Система статистики call центров на IP-АТС Asterisk (FreePBX)

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы