Shkerka.ruзаметки админа
Полезные программы

Бесплатный автообзвон на Asterisk

Опубликовано: Обновлено: 3 мин чтенияАвтор: Редакция Shkerka.ru

Автоматический обзвон списка номеров можно сделать средствами самого Asterisk, без покупки отдельного дайлера. Рассказываем, как устроен такой скрипт, из каких частей он состоит и как собрать аналог на современной версии АТС.

Что умеет скрипт

Скрипт автоматизирует обзвон списка номеров (так называемую «точку Б») средствами Asterisk. Основные возможности:

  • источник номеров — текстовый файл, CSV или таблица MySQL;
  • раздельные диалпланы для исходящей части (что слышит абонент) и для входящей (куда переводится вызов, если абонент нажал кнопку);
  • запись каждого разговора;
  • динамический АОН: номер звонящего подставляется из списка или по правилу;
  • два вида отчётов: стандартный CDR и доработанный, с результатом каждого звонка.

Подробное описание логики, каталогов и сценария обзвона должников — в статье о бесплатном автообзвоне должников на Asterisk.

Как это устроено

В основе — механизм call-файлов. Скрипт для каждого номера создаёт текстовый файл с описанием вызова и переносит его в каталог /var/spool/asterisk/outgoing. Asterisk сразу подхватывает файл, звонит абоненту и после ответа передаёт вызов в указанный контекст диалплана.

Пример call-файла:

Channel: PJSIP/79001234567@operator
CallerID: "Company" <74951234567>
MaxRetries: 2
RetryTime: 300
WaitTime: 40
Context: autodial-out
Extension: s
Priority: 1
Set: CLIENT_ID=1045

Файл нужно сначала создать во временном каталоге и только потом переместить командой mv в outgoing: если Asterisk прочитает недописанный файл, вызов не состоится.

Установка

Типовая структура такого скрипта:

  1. Каталог со скриптами и шаблонами — в произвольном месте, например /opt/autodial.
  2. Контексты обзвона (autodial.conf, autodialtransfer.conf) подключаются в extensions.conf через #include.
  3. Каталог очереди заданий создаётся вручную: mkdir -p /var/spool/autodial, владелец — пользователь, от которого работает Asterisk.
  4. Для тестов без реальных вызовов скрипт может складывать готовые call-файлы во временный каталог, например /tmp/out, — так удобно проверить, что из списка формируются правильные задания.

Пример контекста, который проигрывает сообщение и по нажатию 1 соединяет с оператором:

[autodial-out]
exten => s,1,Answer()
 same => n,MixMonitor(autodial-${UNIQUEID}.wav)
 same => n,Background(custom/reminder)
 same => n,WaitExten(5)

exten => 1,1,Goto(autodial-transfer,s,1)
exten => t,1,Hangup()

[autodial-transfer]
exten => s,1,Dial(PJSIP/101,30)
 same => n,Hangup()

Минимальный генератор заданий из CSV-файла с колонками «номер;идентификатор клиента» может выглядеть так. Он ограничивает число одновременных вызовов и ждёт, пока в очереди освободится место:

#!/bin/bash
LIST=/opt/autodial/list.csv
OUT=/var/spool/asterisk/outgoing
TMP=/var/spool/autodial
MAX=5

while IFS=';' read -r phone client; do
  while [ "$(ls -1 "$OUT" | wc -l)" -ge "$MAX" ]; do sleep 5; done
  f="$TMP/$phone.call"
  cat > "$f" <<EOF
Channel: PJSIP/$phone@operator
CallerID: "Company" <74951234567>
MaxRetries: 1
RetryTime: 300
WaitTime: 40
Context: autodial-out
Extension: s
Priority: 1
Set: CLIENT_ID=$client
EOF
  chown asterisk:asterisk "$f"
  mv "$f" "$OUT/"
done < "$LIST"

Результат каждого звонка удобно брать из CDR: поле disposition показывает, ответил ли абонент, а чтобы связать запись с клиентом, скопируйте переменную в диалплане в пользовательское поле: Set(CDR(userfield)=${CLIENT_ID}).

Что учесть сегодня

  • В Asterisk 21 удалён chan_sip, поэтому в call-файлах и диалплане используйте каналы PJSIP/....
  • Для сложных сценариев (контроль числа одновременных вызовов, повторы, статистика в базе) удобнее управлять вызовами через AMI (команда Originate) или ARI, а не через call-файлы.
  • Если нужен полноценный колл-центр с предиктивным набором и операторскими местами, посмотрите на открытый проект VICIdial, который тоже работает поверх Asterisk.

Пример простого голосового оповещения без перевода на оператора разобран в статье об автоинформаторе на Asterisk.

Частые вопросы

Нужна ли отдельная программа для автообзвона на Asterisk?

Нет. Asterisk сам выполняет вызовы по call-файлам или командам AMI и ARI, а скрипт лишь готовит эти задания из списка номеров и следит за количеством одновременных вызовов.

Сколько номеров можно обзванивать одновременно?

Столько, сколько позволяет транк оператора и лицензия на линии, если она есть. Скрипт должен ограничивать число call-файлов в каталоге outgoing, иначе Asterisk начнёт все вызовы разом и оператор отклонит лишние.

Законен ли автообзвон клиентов?

Обзвон собственных клиентов с их согласия и информирование должников в рамках закона допустимы, а массовые рекламные звонки без согласия запрещены. Перед запуском уточните требования законодательства и условия договора с оператором связи.