Ни один пропущенный не потеряется: Asterisk пишет в Telegram и на почту
Пропущенный звонок в Asterisk — это упущенная сделка, если нет мгновенного оповещения. Я покажу, как заставить АТС отправлять данные о пропущенных звонках в Telegram и на почту напрямую из dialplan, используя стандартные механизмы DIALSTATUS, QUEUESTATUS и внешние вызовы, без лишних денег на сложные CRM. Внутри: реальный кейс автосервиса, готовый код, разбор ошибок новичков и подводные камни безопасности.
Почему стандартная голосовая почта не спасает бизнес
В классической схеме Asterisk, если абонент не отвечает, вызов попадает в голосовую почту. Да, там есть механизм отправки уведомлений на e-mail, но это работает только если клиент оставил сообщение. А что, если он просто положил трубку, услышав гудки, или сбросил соединение, не дождавшись ответа? В таких случаях событие в системе есть, но уведомление на почту не приходит, потому что файл сообщения не создан. Для малого бизнеса, где каждый звонок — потенциальный заказ, это критическая дыра в процессе. Тут даже нечего обсуждать: молчание системы — это убыток. Голосовая почта в Asterisk — это сервис для хранения записей, а не инструмент мониторинга пропущенных вызовов в реальном времени.
Многие пытаются решить проблему покупкой CRM с коллтрекингом. Да, это красиво, но цена вопроса часто начинается с нескольких тысяч рублей в месяц. Для автосервиса с одним городским номером и парой менеджеров это избыточно. Нам нужно простое решение: фиксация факта того, что звонок был, никто не ответил, и мгновенное сообщение ответственному лицу. Именно это мы и реализуем, используя встроенные возможности АТС, не прибегая к сторонним сервисам. Зачем платить за коробку, если внутри уже есть нужный инструмент? Asterisk — это телекоммуникационный движок, который умеет всё, если знать, куда нажать.
Проблема усугубляется тем, что стандартные логи Asterisk (cdr, queue_log) пишутся в текстовые файлы. Они требуют регулярного чтения и анализа. Никто не будет каждые пять минут сканировать логи через ssh, чтобы узнать, кто звонил. Нужен активный механизм, который сам придет к вам в мессенджер или на почту в момент события. Это меняет парадигму с реактивной на проактивную. Ждать, пока что-то сломается, — путь в никуда. Мы должны ловить момент разрыва соединения и действовать немедленно, пока клиент еще держит трубку или только что положил её.
Анатомия пропущенного звонка: DIALSTATUS и h-extensions
Чтобы поймать момент пропущенного звонка, нам нужно понимать, как Asterisk видит завершение соединения. Ключевой параметр здесь — DIALSTATUS. Когда вызов завершается, переменная ${DIALSTATUS} принимает значение, описывающее причину. Для нас интересны значения NOANSWER (абонент не ответил) и BUSY (занято). Если вызов был сброшен в очереди или на прямом канале без ответа, статус будет именно таким. Важно помнить, что этот статус сохраняется в канале и доступен до завершения вызова, включая h-extension. Ошибиться тут легко, если не читать документацию и думать, что переменная исчезает вместе с сигналом разрыва.
Для обработки этого события идеально подходит механизм h-extension. Это специальный экстеншен, который вызывается автоматически при разрыве соединения. Мы можем указать ему выполнять действия в зависимости от причины разрыва. В нашем случае логика проста: если DIALSTATUS равен NOANSWER или BUSY, запускаем процедуру отправки уведомления. Это делается через определение расширения с меткой 'h' в контексте dialplan или через приложение Hangup() в коде вызова. Такой подход гарантирует, что мы не пропустим ни одного события, даже если основной поток вызова уже завершил свою работу. Забудьте про «директивы hangup handler» в конфиге — их нет, есть только логика в dialplan.
Однако есть нюанс. Hangup handler выполняется в контексте завершения вызова, и время на выполнение внешних скриптов ограничено. Если ваш скрипт отправки уведомления в Telegram будет работать медленно, это может повлиять на производительность АТС, особенно при большом потоке звонков. Поэтому важно оптимизировать вызов внешних команд, использовать асинхронность там, где это возможно, или делегировать задачу легковесному процессу, который не будет держать канал занятым. Не тормозите сервер ради одной картинки в чате. Используйте быстрые утилиты вроде curl с флагом -s и избегайте тяжелых интерпретаторов в критическом пути.
- Значение NOANSWER означает, что вызов не был принят абонентом.
- Значение BUSY означает, что линия занята или абонент недоступен.
- Hangup handler реализуется через расширение 'h' в dialplan или приложение Hangup().
Практика: автосервис «Карбюратор» и их потерянные клиенты
Возьмем для примера автосервис «Карбюратор». У них 14 рабочих мест, один городской номер и два менеджера, которые принимают звонки. Проблема была острая: звонки в обеденное время или когда оба менеджера заняты, просто терялись. Клиенты звонили, слышали гудки, ждали пару минут и сбрасывали. Перезванивали через день, но тогда уже требовали скидку или уходили к конкурентам. У них стояла простая Asterisk без сложной интеграции, только базовая голосовая почта, которая работала только если клиент оставлял сообщение. Это случалось редко. Типичная картина «мы всё сделали, а клиент ушел».
Мы провели аудит и увидели, что в логах queue_log есть сотни событий типа ABANDON. Это значит, что вызовы были в очереди, но клиенты не дождались ответа и сбросили. Система фиксировала это, но никто об этом не знал. Менеджеры узнавали о звонках только случайно, просматривая CDR вечером. Решение было очевидным: нужно было настроить автоматическую отправку уведомления в момент сброса. Мы решили использовать Telegram, так как это самый быстрый способ связаться с руководством в рабочее время. Проще и быстрее не придумаешь.
Настройка заняла у нас меньше часа. Мы изменили dialplan, добавив обработку статуса NOANSWER и вызов внешнего скрипта. Этот скрипт формировал сообщение с номером звонившего, временем и датой, и отправлял его через API бота Telegram. Результат: теперь, как только клиент сбрасывает звонок, директор получает уведомление на телефон. Он может сразу перезвонить или поставить задачу менеджеру. Количество потерянных клиентов сократилось практически до нуля, а затраты на внедрение составили лишь время специалиста. Никаких подписок, никаких ежемесячных платежей.
Реализация: вызов внешних команд через System() и curl
Для реализации отправки в Telegram мы будем использовать встроенную функцию System() в dialplan. Она позволяет исполнять внешние команды на сервере. В нашем случае команда будет использовать утилиту curl для отправки HTTP-запроса к API Telegram Bot. Это стандартный и надежный способ, который работает на любой Linux-системе с Asterisk. Главное — правильно сформировать URL и параметры запроса, чтобы бот получил нужные данные. Никакой магии, только чистый код. Параметр 'text' обязателен для метода sendMessage.
Пример команды, которую мы размещаем в экстеншене h: System(curl -s -X POST "https://api.telegram.org/bot<token>/sendMessage" -d "chat_id=<id>&text=Пропущенный звонок: \${CALLERID(num)} в \${STRFTIME(%H:%M)}"). Обратите внимание на экранирование: переменные STRFTIME должны быть корректно обернуты, а двойные кавычки внутри строки экранированы. Переменные ${CALLERID(num)} и ${STRFTIME(...)} берутся из контекста звонка и подставляются в текст сообщения. Команда должна выполняться быстро, поэтому мы используем флаг -s для тихого режима curl, чтобы не выводить лишнюю информацию в логи. Без параметра -d "text=..." запрос не пройдет валидацию API.
Безопасность здесь играет ключевую роль. Токен бота Telegram должен храниться в защищенном месте, лучше всего в отдельном конфигуционном файле с ограниченными правами доступа, а не в открытом виде в dialplan. Также стоит убедиться, что пользователь, от имени которого работает Asterisk, имеет права на запуск curl и доступ к интернету. Если сервер находится за фаерволом, нужно открыть исходящий порт 443 для домена api.telegram.org. Иначе команды будут падать с ошибкой подключения. Не оставляйте ключи в открытом доступе.
- Используйте System() для выполнения внешних команд в dialplan.
- Curl требует параметр -d "text=..." для отправки сообщения в Telegram.
- Токен бота и ID чата обязательны для работы API Telegram.
- Экранируйте переменные STRFTIME и кавычки в строке команды.
- Проверьте права доступа пользователя Asterisk к сети и исполнению команд.
Уведомления на почту: встроенный механизм Asterisk
Помимо Telegram, многие предпочитают получать дублирование уведомлений на электронную почту. В Asterisk это можно реализовать через стандартный механизм голосовой почты, даже если вы не хотите хранить сами записи. В конфигурации почтового ящика (voicemail.conf) можно указать параметр email для отправки уведомлений. Но, как я уже говорил, это работает только при наличии голосового сообщения. Чтобы обойти это ограничение, нельзя использовать «трюк» с созданием пустого сообщения — он не сработает, так как пустое сообщение не генерирует событие email-уведомления. Это миф, который тратит ваше время.
Более правильный способ — использовать ту же функцию System() для вызова утилиты sendmail или mail. В этом случае мы формируем письмо вручную, указывая тему, тело сообщения и получателя. Это дает больше гибкости: можно добавить в письмо дополнительные данные, такие как длительность ожидания в очереди или ID оператора. Пример команды: System(sendmail -t <recipient> <<EOF\nSubject: Пропущенный звонок\nFrom: Asterisk <asterisk@domain.com>\nTo: <recipient>\n\nНомер: \${CALLERID(num)}\nВремя: \${NOW()}\nEOF). Здесь важно правильно сформировать строку без использования here-document операторов bash, которые не поддерживаются в контексте System(). Вместо этого передавайте полностью сформированную строку или используйте переменные окружения.
Если у вас настроен SMTP-сервер локально (например, Postfix), то sendmail будет работать быстро и надежно. Если же вы используете внешний почтовый шлюз, убедитесь, что у вас есть доступ к нему и настроены необходимые учетные данные. В противном случае письма могут уходить в черновики или просто не доставляться. Также стоит проверить, не блокирует ли спам-фильтр вашего почтового провайдера письма от имени Asterisk, так как они могут выглядеть подозрительно из-за отсутствия стандартных заголовков. Не ждите, что почта сама себя настроит.
- Не пытайтесь создать пустое голосовое сообщение для триггера email — это не работает.
- Используйте System() с утилитой sendmail для ручной отправки писем.
- Избегайте bash-операторов here-document (<<<) в команде System().
Очереди и потерянные звонки: событие ABANDON
Отдельный случай — звонки в очереди (Queues). Здесь ситуация сложнее, так как вызов может быть передан нескольким операторам, и статус NOANSWER может не сработать ожидаемым образом. В этом случае нам нужно отслеживать событие ABANDON, которое фиксируется в логе queue_log. Это событие означает, что клиент сбросил звонок, находясь в очереди, не дождавшись ответа оператора. Стандартный hangup handler может не сработать корректно для таких случаев, если не настроен правильно. Очередь — это минное поле для новичков.
Для обработки событий очереди лучше использовать переменную ${QUEUESTATUS} или опцию 'h' в приложении Queue(). Переменная ${QUEUESTATUS} содержит статус выхода из очереди, включая ABANDON. Это позволяет проверить статус прямо в dialplan без необходимости парсить логи. Пример: if [ "${QUEUESTATUS}" = "ABANDON" ]; then ... fi. Это надежнее и быстрее, чем внешний скрипт, читающий queue_log. Также можно использовать приложение Queue() с опцией 'h', которая вызовет h-extension при выходе из очереди, где можно проверить ${QUEUESTATUS}.
Также стоит учесть возможность использования AMI (Asterisk Manager Interface). Через AMI можно подписаться на события QueueMemberStatus и получать уведомления о сбросах в реальном времени. Это требует написания небольшого приложения на Python или другом языке, которое будет слушать события и отправлять уведомления. Такой подход наиболее гибкий и масштабируемый, но и более сложный в реализации. Для малого бизнеса, как правило, достаточно простого парсинга логов или настройки dialplan с использованием ${QUEUESTATUS}. Не усложняйте, если не нужно.
- Событие ABANDON фиксируется в queue_log при сбросе в очереди.
- Используйте переменную ${QUEUESTATUS} для проверки статуса выхода из очереди.
- Опция 'h' в приложении Queue() позволяет вызвать h-extension при выходе.
- AMI дает гибкость, но требует написания дополнительного кода.
- Для малого бизнеса достаточно dialplan и ${QUEUESTATUS}.
Частые вопросы
Нужен ли платный тариф Telegram для бота?
Нет, создание бота и его работа через API полностью бесплатны. Платить нужно только за хостинг сервера с Asterisk.
Можно ли отправлять уведомления в WhatsApp?
Официально — нет, WhatsApp Business API платный и сложен. Telegram — оптимальное бесплатное решение для уведомлений.
Что делать, если звонит скрытый номер?
В этом случае переменная CALLERID будет пустой. В скрипте нужно предусмотреть проверку и замену на текст 'Скрытый номер'.
Будут ли уведомления дублироваться?
Если правильно настроить логику в dialplan и очереди, дублирования не будет. Главное — отслеживать статус вызова в единственной точке завершения.
Можно ли настроить уведомления для конкретных операторов?
Да, через переменные в dialplan можно определить, какой оператор был назначен на звонок, и отправлять уведомление конкретно ему.
Источники
- Asterisk Documentation — Описание функции System() и работы с внешними командами в dialplan. URL: https://wiki.asterisk.org/wiki/display/AST/System
- Asterisk Documentation — Работа с переменными DIALSTATUS и механизмом hangup handler. URL: https://wiki.asterisk.org/wiki/display/AST/Dial+Status
- Asterisk Documentation — Конфигурация очередей (queues.conf) и события ABANDON. URL: https://wiki.asterisk.org/wiki/display/AST/Queues
- Telegram Bot API — Официальная документация по созданию ботов и отправке сообщений. URL: https://core.telegram.org/bots/api



