Системные требования

Сервер

PHP расширения (обязательные)

Сеть

• Порт 8080 должен быть открыт и доступен из интернета — для Click-to-Call
• Сервер должен иметь выход в интернет — для OAuth и проверки лицензии

Установка

Ubuntu / Debian (FreePBX, PJSIP)

Подключитесь к серверу по SSH от пользователя root и выполните команды по порядку:

Копироватьapt update
apt install -y php-cli php-curl php-sqlite3 php-mbstring

Копироватьphp -v

Копироватьcd /tmp
wget https://asterconnector.uz/download/AsterConnector-v2.0-stable.zip

Копироватьcp /tmp/asterconnector.php /opt/asterconnector.php
chmod 644 /opt/asterconnector.php
mkdir -p /etc/asterconnector
mkdir -p /var/log/asterconnector

Копироватьcat > /etc/systemd/system/asterconnector.service << 'EOF'
[Unit]
Description=AsterConnector v2.0
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/php /opt/asterconnector.php
Restart=always
RestartSec=5
StandardOutput=null
StandardError=null

[Install]
WantedBy=multi-user.target
EOF

Копироватьsystemctl daemon-reload
systemctl enable asterconnector
systemctl start asterconnector

Копироватьsystemctl status asterconnector

Копироватьcurl -s http://127.0.0.1:8080/health

Issabel / CentOS 7 (chan_sip)

Копироватьyum install -y epel-release
yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
yum install -y php81 php81-php-cli php81-php-curl php81-php-pdo php81-php-mbstring php81-php-pcntl

Копироватьphp81 -v

Копироватьcd /tmp
wget https://asterconnector.uz/download/asterconnector.php
cp asterconnector.php /opt/asterconnector.php
chmod 644 /opt/asterconnector.php
mkdir -p /etc/asterconnector /var/log/asterconnector

Копироватьcat > /etc/systemd/system/asterconnector.service << 'EOF'
[Unit]
Description=AsterConnector v2.0
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/php81 /opt/asterconnector.php
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable asterconnector
systemctl start asterconnector
systemctl status asterconnector

Управление сервисом

Обновление

Копироватьsystemctl stop asterconnector
cp /tmp/asterconnector_new.php /opt/asterconnector.php
systemctl start asterconnector

Копироватьcurl -s http://127.0.0.1:8080/health

Удаление

Копироватьsystemctl stop asterconnector
systemctl disable asterconnector
rm -f /etc/systemd/system/asterconnector.service
systemctl daemon-reload
rm -f /opt/asterconnector.php
rm -rf /etc/asterconnector/
rm -rf /var/log/asterconnector/

Настройка AMI (Asterisk)

AMI — интерфейс управления Asterisk. Модуль подключается к AMI для отслеживания звонков в реальном времени.

Шаг 1 — Настройка manager.conf

Откройте файл конфигурации:

Копироватьnano /etc/asterisk/manager.conf

Убедитесь что секция [general] выглядит так:

Копировать[general]
enabled = yes
port = 5038
bindaddr = 127.0.0.1

Добавьте пользователя для модуля в конец файла:

Копировать[asterconnector]
secret = ВАШ_ПАРОЛЬ_ЗДЕСЬ
deny = 0.0.0.0/0.0.0.0
permit = 127.0.0.1/255.255.255.0
read = all
write = all

Применяем изменения без перезагрузки Asterisk:

Копироватьasterisk -rx "manager reload"

Проверяем что AMI работает:

Копироватьasterisk -rx "manager show settings"

Шаг 2 — Настройка в панели модуля

Панель → раздел AMI → заполните поля и нажмите Проверить:

Нажмите Сохранить. Проверяем подключение в логе:

Копироватьtail -5 /var/log/asterconnector/asterconnector.log | grep AMI

Подключение к Битрикс24

Настройка сотрудников

Модуль сопоставляет сотрудников Битрикс24 с внутренними номерами Asterisk. Без этого невозможно определить кто совершил или принял звонок.

Шаг 1 — Заполнить внутренние номера в Битрикс24

Для каждого сотрудника в Битрикс24 должен быть заполнен внутренний номер:

Битрикс24 → Сотрудники → открыть профиль → Изменить → поле «Внутренний телефон»

Номер должен совпадать с номером в Asterisk (например: 101, 102).

Шаг 2 — Синхронизировать

Панель → Сотрудники → кнопка «↻ Синхронизировать»

Синхронизация также происходит автоматически раз в час.

Шаг 3 — Проверить

В таблице сотрудников должна быть заполнена колонка Внутренний. Если пусто — заполните номер в Битрикс24 и синхронизируйте снова.

Копироватьsqlite3 /etc/asterconnector/asterconnector.db \
  "SELECT user_id_b24, name, inner_number FROM employees WHERE active=1"

Настройки звонков

Контексты Asterisk

Нормализация номеров

Автоматически добавляет код страны. Пример для Узбекистана: 901234567 → +998901234567

Номера компании (DID)

Укажите все номера вашей АТС. Для каждого DID можно настроить отдельную воронку продаж. Добавляйте в панели → Настройки звонков → «Номера компании (DID)».

Создание CRM объектов

Ответственный за пропущенный

• Первый агент — первый сотрудник которому позвонило
• Последний агент — последний кому звонило
• Все агенты — уведомляются все
• Ответственный за сделку — ищется в CRM по номеру телефона

Дополнительно укажите пользователя по умолчанию — будет ответственным если клиент новый и в CRM не найден.

Маршрутизация на ответственного

Автоматически направляет входящий звонок на менеджера ответственного за клиента в Битрикс24.

Как работает

1. Входящий звонок поступает на АТС
2. Диалплан Asterisk делает HTTP запрос: http://127.0.0.1:8080/forward?phone=НОМЕР
3. Модуль ищет ответственного в Битрикс24 по номеру
4. Возвращает внутренний номер сотрудника (например 101)
5. Диалплан переводит звонок на этого сотрудника
6. Если ответственный не найден — звонок идёт в очередь

Шаг 1 — Настройка диалплана FreePBX (PJSIP)

Копироватьnano /etc/asterisk/extensions_custom.conf

Добавьте в конец файла:

Копировать[ac-transfer]
exten => _.,1,NoOp(AsterConnector: ${CALLERID(num)})
 same => n,Set(AC_EXT=)
 same => n,Set(CURLOPT(httptimeout)=3)
 same => n,Set(CURLOPT(conntimeout)=3)
 same => n,Set(AC_EXT=${CURL(http://127.0.0.1:8080/forward?phone=${CALLERID(num)})})
 same => n,GotoIf($["${AC_EXT}"=""]?queue)
 same => n,Set(AC_RESPONSIBLE=${AC_EXT})
 same => n,Dial(PJSIP/${AC_EXT},20,tTg)
 same => n,GotoIf($["${DIALSTATUS}"="ANSWER"]?done)
 same => n(queue),Goto(ext-queues,1000,1)
 same => n(done),NoOp(Answered: ${AC_EXT})

Замените ext-queues,1000,1 на ваш контекст и номер очереди.

Копироватьasterisk -rx "dialplan reload"

Шаг 1 — Настройка диалплана Issabel (chan_sip)

То же самое, но используем SIP/ вместо PJSIP/:

Копировать[ac-transfer]
exten => _.,1,NoOp(AsterConnector: ${CALLERID(num)})
 same => n,Set(AC_EXT=)
 same => n,Set(CURLOPT(httptimeout)=3)
 same => n,Set(CURLOPT(conntimeout)=3)
 same => n,Set(AC_EXT=${CURL(http://127.0.0.1:8080/forward?phone=${CALLERID(num)})})
 same => n,GotoIf($["${AC_EXT}"=""]?queue)
 same => n,Set(AC_RESPONSIBLE=${AC_EXT})
 same => n,Dial(SIP/${AC_EXT},20,tTg)
 same => n,GotoIf($["${DIALSTATUS}"="ANSWER"]?done)
 same => n(queue),Goto(ext-queues,1000,1)
 same => n(done),NoOp(Answered: ${AC_EXT})

Шаг 2 — Подключить маршрут во FreePBX

FreePBX → Connectivity → Inbound Routes → выберите маршрут → Set Destination → Custom Destinations → введите: ac-transfer,s,1 → Save

Шаг 3 — Включить в панели модуля

Панель → Настройки звонков → включите «Использовать автораспределение» → выберите метод → Сохранить.

Шаг 4 — Проверить работу

Копироватьcurl -s "http://127.0.0.1:8080/forward?phone=998901234567"

Если ответственный найден — вернётся его внутренний номер. Если нет — пустой ответ.

Запись разговоров

Модуль автоматически загружает записи разговоров в карточку звонка в Битрикс24 каждые 30 секунд.

Автоочистка старых файлов (cron)

Для удаления файлов старше 7 дней добавьте задание в cron:

Копироватьecho "0 3 * * * find /var/spool/asterisk/monitor/ -name '*.wav' -mtime +7 -delete" | crontab -

Мониторинг

Копироватьtail -f /var/log/asterconnector/asterconnector.log | grep RECORD

Click-to-Call (C2C)

Звонок клиенту прямо из карточки Битрикс24 одним кликом.

Как работает

1. Менеджер нажимает на номер в Битрикс24
2. Битрикс24 отправляет событие ONEXTERNALCALLSTART на сервер модуля
3. Модуль через AMI звонит на внутренний номер менеджера
4. Менеджер поднимает трубку
5. Asterisk звонит клиенту
6. Звонок фиксируется в карточке клиента

Требования

• Порт 8080 доступен из интернета
• В Битрикс24 → Телефония выбрано приложение AsterConnector
• У сотрудника заполнен внутренний номер в Битрикс24
• Сотрудник синхронизирован в модуле

Ручная регистрация обработчика

Если C2C не работает — переподключите Битрикс24 или зарегистрируйте вручную:

КопироватьTOKEN=$(python3 -c "import json; print(json.load(open('/etc/asterconnector/tokens.json'))['access_token'])")

# Удаляем старый обработчик
curl -s "https://ДОМЕН.bitrix24.ru/rest/event.unbind.json" \
  -d "auth=$TOKEN" -d "event=ONEXTERNALCALLSTART" -d "handler=http://ВАШ_IP:8080/c2c"

# Регистрируем новый
curl -s "https://ДОМЕН.bitrix24.ru/rest/event.bind.json" \
  -d "auth=$TOKEN" -d "event=ONEXTERNALCALLSTART" -d "handler=http://ВАШ_IP:8080/c2c"

Задачи при пропущенных звонках

При пропущенном создаётся задача «Перезвонить: НОМЕР» с привязкой к контакту и сделке.

Сделки и контакты

Повторные сделки

1. Ищем контакт по номеру телефона
2. Проверяем есть ли открытые сделки у контакта
3. Если нет — создаём новую сделку в настроенной воронке
4. Если есть — новую не создаём

Несколько DID с разными воронками

Каждый DID номер можно привязать к отдельной воронке и этапу. Например:

• Звонки на +998712026262 → воронка «Продажи», этап «Новый»
• Звонки на +998712026200 → воронка «Поддержка», этап «В работе»

Настраивается: панель → Настройки звонков → Номера компании (DID).

Лицензия

Активация

Приобрести или продлить: asterconnector.uz

Ошибки и решения

asterisk -rx "manager show settings"

yum install -y asterisk16-curl
asterisk -rx "module load res_curl.so"
asterisk -rx "module load func_curl.so"

load => res_curl.so
load => func_curl.so

curl -s "http://127.0.0.1:8080/forward?phone=998901234567"

tail -20 /var/log/asterconnector/asterconnector.log | grep "getDeal\|FORWARD"

rm -f /etc/asterconnector/license.json
systemctl restart asterconnector

Общая диагностика

Копировать# Статус сервиса
systemctl status asterconnector

# Последние ошибки
tail -50 /var/log/asterconnector/asterconnector.log | grep ERROR

# Проверка панели
curl -s http://127.0.0.1:8080/health | python3 -m json.tool

# Проверка AMI
asterisk -rx "manager show connected" | grep asterconnector

Часто задаваемые вопросы

Работает ли с Битрикс24 Коробка?

Да. Работает как с Облако так и с Коробкой на своём сервере.

Можно использовать с несколькими DID?

Да. Панель → Настройки звонков → Номера компании. Каждый DID можно привязать к своей воронке.

Звонок регистрируется дважды

Укажите DID номера компании в настройках. Без них входящий звонок может обрабатываться как входящий и как исходящий одновременно.

Как посмотреть историю звонков?

Панель → История звонков. Или напрямую в базе:

Копироватьsqlite3 /etc/asterconnector/asterconnector.db \
  "SELECT datetime(started_at,'unixepoch','localtime'), direction, status, phone_number, duration FROM calls ORDER BY id DESC LIMIT 20"

Как изменить порт панели?

Панель → Система → Порт панели → Сохранить. Не забудьте открыть новый порт: ufw allow НОВЫЙ_ПОРТ/tcp

Как сменить пароль панели?

Панель → Система → Новый пароль → Сохранить.

Как сохранить настройки при переустановке?

Панель → Система → кнопка «↓ Бэкап». Скачается JSON с настройками.

Проверка что записи загружаются

Копироватьsqlite3 /etc/asterconnector/asterconnector.db \
  "SELECT record_file, record_uploaded FROM calls WHERE record_file IS NOT NULL ORDER BY id DESC LIMIT 10"

Значение record_uploaded=1 — успешно загружено.

История изменений

v2.0.0 Текущая

• Встроенный HTTP сервер и веб-панель управления на порту 8080
• Поддержка PJSIP (FreePBX) и chan_sip (Issabel)
• OAuth2 авторизация в Битрикс24
• Регистрация входящих и исходящих звонков
• Click-to-Call
• Умная маршрутизация на ответственного менеджера
• Загрузка записей разговоров в карточку звонка
• Автосоздание задач «Перезвонить» при пропущенных
• Автозакрытие задач при успешном перезвоне
• Повторные сделки через crm.item.update
• Несколько DID с отдельными воронками
• Два метода поиска ответственного: по лиду и по контакту
• Нормализация номеров телефонов
• Работа с Битрикс24 Облако и Коробка
• Пометка неотвеченных исходящих: «Не дозвонились»
• Совместимость с Issabel / CentOS 7 через PHP 8.1 Remi