Comment on page
Обработка звонков за период
Если по каким-то причинам модуль Itgrix был отключен, или если при первой установке есть желание обработать уже прошедшие звонки, то можно воспользоваться специальным запросом
/pbx/read_call
в API модуля Itgrix. С его помощью можно запустить обработку определённых звонков.Запрос
/pbx/read_call
поддерживается начиная с версий Itgrix_bx 3.3.3 (Битрикс24) и Itgrix_amo 2.5.2 (amoCRM).Например, можно сделать запрос с помощью
curl
(здесь <Asterisk IP>
- это адрес сервера, на котором установлен модуль Itgrix):curl "<Asterisk IP>:8077/pbx/read_call?<параметры>"
У метода есть два варианта использования параметров:
- указать один или несколько идентификаторов звонка
id
; - указать дату начала периода
start_date
и (опционально) дату окончанияend_date
(в этом случае модуль находит все записи CEL в указанных датах, берёт из нихlinkedid
и обрабатывает звонки уже по ID).
Запрос
/pbx/read_call
с указанием периода поддерживается начиная с версий Itgrix_bx 3.4.0 (Битрикс24) и Itgrix_amo 2.6.0 (amoCRM).В предыдущих версиях запрос поддерживает только параметр
id
. Для таких версий поддерживается специальный скрипт (см. раздел ниже).Если требуется обработать один звонок, то проще всего сделать GET-запрос с параметром
id
:curl "<Asterisk IP>:8077/pbx/read_call?id=1234567890.1"
Если требуется обработать несколько звонков, то можно через POST-запрос передать JSON-объект с массивом
id
:curl "<Asterisk IP>:8077/pbx/read_call" \
-H "Content-Type: application/json" \
-d '{"id":["1111111111.1", "2222222222.2"]}'
Границы периода определяются параметрами
start_date
и end_date
. При этом параметр end_date
опциональный, т.е. его можно не указывать, и в таком случае модуль обработает все звонки, начиная с start_date
.Параметры могут быть указаны в трёх видах:
- Дата-время в формате
ГГГГ-ММ-ДД чч:мм:сс
. При отправке GET-запроса с таким параметром нужно заменить пробел на специальную последовательность%20
, при отправке POST-запроса с параметрами в формате JSON это не требуется. Например, обработаем звонки за 25 мая 2021 с 10:30 до 22:00:curl "<Asterisk IP>:8077/pbx/read_call?\start_date=2021-05-25%2010:30:00&\end_date=2021-05-25%2022:00:00" - Метка времени в формате UNIX-time (можно получить из ID звонка, - это число до точки; например, в звонке 1267568856.11 число 1267568856 является меткой времени). Например, обработаем звонки с 27 мая 2021 06:01:59 GMT, т.е. UNIX-time 1622138519:curl "<Asterisk IP>:8077/pbx/read_call?start_date=1622138519"
- Количество дней назад (отрицательное целое число). Например, обработать звонки за позавчера:curl "<Asterisk IP>:8077/pbx/read_call?start_date=-2&end_date=-1"Пример обработки звонков за неделю:curl "<Asterisk IP>:8077/pbx/read_call?start_date=-7"Также есть специальный вариант
start_date=-0
- обработка звонков за сегодня (с полуночи по местному времени):curl "<Asterisk IP>:8077/pbx/read_call?start_date=-0"
Скрипт использует запрос API модуля Itgrix
/pbx/read_call
с параметром id
, который поддерживается, начиная с версий Itgrix_bx 3.3.3 (Битрикс24) и Itgrix_amo 2.5.2 (amoCRM).Нужно войти в систему (сервер), на которой установлен модуль Itgrix, скачать и запустить скрипт.
Скачать скрипт для Битрикс24:
curl -OJ "https://bx24asterisk.ru/download/get_read_calls_script.php?crm=bx"
Скачать скрипт для amoCRM:
curl -OJ "https://bx24asterisk.ru/download/get_read_calls_script.php?crm=amo"
Использование:
Рассмотрим запуск на примере скрипта
read_calls_bx.php
для Битрикс24.
Для amoCRM всё то же самое, но скрипт называется read_calls_amo.php
.php read_calls_bx.php <дата-время начала> <дата-время конца>
- обычное использование; по умолчанию URL модуля Itgrix будет получен из конфигурационного файла;php read_calls_bx.php <дата-время начала> <дата-время конца> <URL модуля>
- если нужно указать нестандартный URL модуля Itgrix; ОБЯЗАТЕЛЬНО задавать со схемой (http:// илиhttps://
);php read_calls_bx.php --help
- для вывода справки.
Примеры:
php read_calls_bx.php '2021-04-12 16:07:00' '2021-04-20 16:09:00'
php read_calls_bx.php '2021-04-12 16:07:00' '2021-04-20 16:09:00' \
'http://<Asterisk IP>:8077'
По умолчанию скрипт использует php-mysqli для запроса в БД. Если по каким-то причинам php-mysqli недоступен, то можно воспользоваться CLC-версией (MySQL Command-Line Client) скрипта.
Скачать CLC-скрипт для Битрикс24:
curl -OJ "https://bx24asterisk.ru/download/get_read_calls_script.php?crm=bx&type=clc"
Скачать CLC-скрипт для amoCRM:
curl -OJ "https://bx24asterisk.ru/download/get_read_calls_script.php?crm=amo&type=clc"
Запуск такой же, как и для обычной (mysqli) версии скрипта кроме названия файла:
read_calls_bx_clc.php
для Битрикс24;read_calls_amo_clc.php
для amoCRM.