Бесплатный автообзвон должников на Asterisk
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.