Shkerka.ruзаметки админа
Asterisk и IP-АТС

Бесплатный автообзвон должников на Asterisk

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

Asterisk умеет не только принимать, но и сам совершать вызовы по списку. Разбираем, как устроен автообзвон на call-файлах: скрипт берёт номера из CSV, ограничивает число одновременных звонков, а диалплан зачитывает абоненту его данные.

Как Asterisk звонит сам

Для исходящего обзвона не нужны платные модули. В Asterisk есть механизм call-файлов: модуль pbx_spool следит за каталогом /var/spool/asterisk/outgoing и для каждого появившегося файла создаёт вызов. Когда абонент отвечает, вызов передаётся в контекст диалплана, а там можно проиграть сообщение, зачитать сумму долга, предложить соединиться с оператором.

Типовой автообзвон состоит из трёх частей:

  • список номеров с данными для каждого абонента (CSV или таблица в базе);
  • скрипт, который превращает строки списка в call-файлы и не перегружает транк;
  • диалплан, который ведёт разговор после ответа.

На этой схеме можно сделать напоминание о задолженности, оповещение о записи к врачу, проверку существования номеров или опрос клиентов.

Формат call-файла

Channel: PJSIP/89001234567@provider
CallerID: "Company" <4951234567>
MaxRetries: 2
RetryTime: 300
WaitTime: 45
Context: autodial-out
Extension: s
Priority: 1
Archive: yes
Setvar: CONTRACT=987
Setvar: DEBT=1906
  • Channel — куда звонить. Здесь вызов уходит через транк provider, настроенный в pjsip.conf.
  • MaxRetries и RetryTime — число повторов и пауза между ними в секундах, если абонент не ответил или занят.
  • WaitTime — сколько секунд ждать ответа.
  • Context, Extension, Priority — куда передать вызов после ответа.
  • Setvar — переменные канала, доступные в диалплане. Через них передаются номер договора, сумма и любые другие данные.
  • Archive: yes — сохранить файл после обработки в outgoing_done с итоговым статусом.

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

Список абонентов

Входные данные — CSV с заголовком, разделитель точка с запятой:

phone;contract;debt
89001234567;987;1906
89007654321;1024;15400

Скрипт обзвона

Скрипт читает список, ждёт, пока в спуле освободится место, и подкладывает следующий call-файл. Пока вызов обрабатывается, включая повторы, его файл остаётся в каталоге outgoing, поэтому число файлов в спуле примерно равно числу активных вызовов.

#!/bin/bash
# autodial.sh — обзвон по списку из CSV
CSV=/opt/autodial/debtors.csv
SPOOL=/var/spool/asterisk/outgoing
TMP=/var/spool/asterisk/autodial-tmp
CHANNELS=4          # одновременных вызовов
CALLERID=4951234567

mkdir -p "$TMP"

tail -n +2 "$CSV" | while IFS=';' read -r phone contract debt; do
  [ -z "$phone" ] && continue

  # ждём, пока в спуле меньше CHANNELS файлов
  while [ "$(find "$SPOOL" -maxdepth 1 -name '*.call' | wc -l)" -ge "$CHANNELS" ]; do
    sleep 5
  done

  f="$TMP/${phone}-$(date +%s).call"
  cat > "$f" <<EOF
Channel: PJSIP/${phone}@provider
CallerID: <${CALLERID}>
MaxRetries: 2
RetryTime: 600
WaitTime: 40
Context: autodial-out
Extension: s
Priority: 1
Archive: yes
Setvar: CONTRACT=${contract}
Setvar: DEBT=${debt}
EOF
  chown asterisk:asterisk "$f"
  mv "$f" "$SPOOL/"
  sleep 2
done

Запускайте скрипт от root или от пользователя, который может писать в спул. Для регулярных обзвонов его удобно ставить в cron, но с учётом допустимого времени звонков.

Диалплан разговора

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

[autodial-out]
exten => s,1,Answer()
 same => n,Wait(1)
 same => n,Set(CHANNEL(language)=ru)
 same => n,Playback(autodial/po-dogovoru)
 same => n,SayDigits(${CONTRACT})
 same => n,Playback(autodial/summa-dolga)
 same => n,SayNumber(${DEBT})
 same => n,Playback(autodial/rubley)
 same => n,Read(CHOICE,autodial/najmite-1,1,,2,5)
 same => n,GotoIf($["${CHOICE}" = "1"]?operator)
 same => n,Playback(autodial/do-svidaniya)
 same => n,Hangup()
 same => n(operator),Dial(PJSIP/101&PJSIP/102,30)
 same => n,Hangup()

Фразы po-dogovoru, summa-dolga, najmite-1 записываются заранее и кладутся в /var/lib/asterisk/sounds/ru/autodial/ в формате 8 кГц моно. Склонение слова «рубль» зависит от последних цифр суммы: для аккуратной речи запишите три файла (рубль, рубля, рублей) и выбирайте нужный по ${DEBT:-1} и ${DEBT:-2}.

Чтобы сохранять разговоры для разбора спорных случаев, добавьте после Answer() строку MixMonitor(autodial/${STRFTIME(${EPOCH},,%Y%m%d-%H%M%S)}-${CALLERID(num)}.wav). Записи окажутся в /var/spool/asterisk/monitor/autodial/.

Отчёт по результатам

Простейший отчёт получается из архива call-файлов:

grep -H '^Status:' /var/spool/asterisk/outgoing_done/*.call

Completed — абонент ответил, Expired — исчерпаны повторы, Failed — вызов не удалось создать. Длительность разговоров и причины отбоя смотрите в CDR (/var/log/asterisk/cdr-csv/Master.csv или база, если CDR пишется в SQL).

Тот же подход для других задач

  • Проверка номеров. Если не нужен разговор, передавайте вызов в контекст, который сразу кладёт трубку, а результат берите из статуса и причины отбоя (HANGUPCAUSE).
  • Данные из базы. Вместо CSV скрипт может читать выборку из MySQL или PostgreSQL — меняется только источник строк.
  • Повтор на другой номер. Если основной номер не ответил, скрипт по статусу Expired формирует новый call-файл на резервный номер абонента.

Готовый набор скриптов с этими режимами описан на странице автообзвон на Asterisk.

Правовые ограничения

Технически обзвон собирается за вечер, но юридически он ограничен. Взаимодействие с должниками — физическими лицами в России регулирует закон 230-ФЗ: он задаёт допустимое время звонков, предельную частоту контактов и требования к тому, что можно сообщать. Рекламные обзвоны требуют предварительного согласия абонента по закону о рекламе. Кроме того, операторы связи всё активнее маркируют и блокируют массовые вызовы. Перед запуском согласуйте сценарий, расписание и частоту с юристом и оператором.

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

Что такое call-файл в Asterisk?

Это текстовый файл с параметрами вызова: канал, номер, контекст, переменные. Как только файл появляется в /var/spool/asterisk/outgoing, Asterisk сам набирает номер и при ответе передаёт вызов в указанный контекст.

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

Столько, сколько позволяет транк оператора и ресурсы сервера. Скрипт в статье держит в спуле не больше заданного числа call-файлов, обычно начинают с 2–4 каналов и смотрят на нагрузку и ответы оператора.

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

Звонки по просроченной задолженности физлиц в России регулирует закон 230-ФЗ: он ограничивает время и частоту контактов. Для рекламных обзвонов нужно предварительное согласие абонента. Сценарий и частоту лучше согласовать с юристом.

Как узнать, кто ответил, а кто нет?

Включите в call-файле Archive: yes. После обработки файл переносится в /var/spool/asterisk/outgoing_done с полем Status: Completed, Expired или Failed. Подробности по каждому звонку есть в CDR.