К содержимому
Интеграции

Билайн и фоновые задачи

Обновлено

Как устроен обмен

Плагин обращается к https://cloudpbx.beeline.ru/apis/portal/ с токеном из поля «Токен API». Через API он получает абонентов, состояние записи разговоров, статистику, сведения о записях и MP3.

Действие Какие данные передаются Билайну
Подписка на события Идентификатор абонента, тип BASIC_CALL, запрашиваемый срок и полный «Адрес для событий» с секретом
Получение записи Идентификатор звонка Билайна и идентификатор абонента
Проверка статистики Идентификатор абонента и интервал времени
Звонок по клику Идентификатор абонента и номер клиента в формате E.164
Перевод Идентификаторы абонента и активного звонка, телефон назначения из 10 цифр

Билайн отправляет XML-события на «Адрес для событий». Плагин проверяет секрет URL; при неверном секрете возвращает 404. Для верного секрета ответ OK сам по себе не подтверждает успешное создание звонка: ошибки разбора и обработки записываются в журнал.

Подписки создаются для абонентов, привязанных к сотрудникам CRM. Когда привязка удалена, при синхронизации плагин удаляет соответствующую подписку. Существующие подписки продлеваются перед окончанием срока; при событии об обрыве канала или подписки плагин дополнительно проверяет их состояние.

Настройте cron

В настройках плагина в блоке «Состояние» при предупреждении показана строка с фактическим корнем установки. Добавьте её в crontab пользователя сайта, не root. Шаблон команды:

*/5 * * * * php <корень установки>/cli.php crm ewcrmbeelinePluginCron

Замените <корень установки> абсолютным путём Webasyst. Если CLI PHP выбирается отдельным путём на вашем сервере, используйте подходящий исполняемый файл PHP с необходимыми расширениями.

Один прогон:

  • синхронизирует подписки;
  • проверяет очередь записей и скачивает MP3 в автоматическом режиме;
  • получает премиум-расшифровки, если они включены и настроены;
  • проверяет зависшие звонки по статистике и очищает дубли;
  • удаляет локальные записи по сроку хранения.

Для ручного запуска разработчиком:

php <корень установки>/cli.php crm ewcrmbeelinePluginCron

Команда выводит JSON с результатами этапов либо skipped, если запуск пропущен: например, не задан токен или действует блокировка другого прогона. Поле errors содержит ошибки отдельных этапов.

Как проверить фоновые задачи

Откройте CRM → Плагины → Билайн → Состояние. После запуска CLI поле «Фоновые задачи» должно показывать источник cli. Предупреждение появляется, если системный запуск ещё не выполнялся или его не было больше 15 минут.

Резервный запуск из открытой CRM имеет источник backend и ограничен интервалом в 10 минут. Он зависит от работы механизма фоновой очистки CRM и не обеспечивает ночную работу при закрытом бэкенде.

Дата последнего запуска подтверждает выполнение прогона, но не успех каждого этапа. Дополнительно проверяйте ошибки в «Подписки», состояние очередей и журнал wa-log/crm/plugins/ewcrmbeeline.log.