Алина Леонова
31.05.2020
3693

Отправка уведомлений из Asterisk в ВКонтакте через API ВК

На текущий момент ВКонтакте – одна из самых популярных социальных сетей. Ежедневно большинство людей проводят в ней своё свободное время: время тратится на музыку, видео, общение и многое другое. Однако в ВКонтакте также хорошо процветает и бизнес. Различные компании имеют в данной социальной сети сообщества, на которое подписано множество людей. Из этих сообществ пользователям рассылаются […]

Уведомления из Asterisk в ВКонтакте

На текущий момент ВКонтакте – одна из самых популярных социальных сетей. Ежедневно большинство людей проводят в ней своё свободное время: время тратится на музыку, видео, общение и многое другое. Однако в ВКонтакте также хорошо процветает и бизнес. Различные компании имеют в данной социальной сети сообщества, на которое подписано множество людей. Из этих сообществ пользователям рассылаются различные уведомления об акциях компаний. Но, зная ID сотрудников компании, им можно также отсылать различные уведомления, касающиеся работы.

В данной статье рассмотрим возможность отправки уведомлений из Asterisk в ВКонтакте на примере API ВКонтакте.

Подготовка на стороне ВКонтакте

Интегрировать ВК с Asterisk можно с помощью Standalone-приложения и сообщества.

Для интеграции первым способом приложение нужно отправить на проверку.

Подробнее об этом можно посмотреть в документации по API ВК «Ограничение Messages API».

В примере же интеграция будет происходить через сообщество.

Для этого у сообщества должны быть включены сообщения, а также должен иметься ключ доступа с разрешёнными сообщениями.

Для начала включим сообщения сообщества:

  1. В сообществе переходим в Управление -> Сообщения;
  2. Сообщения сообщества: включены (выбираем из списка).
Включение сообщений сообщества

Затем нужно создать ключ доступа:

  1. В сообществе переходим в Управление -> Работа с API;
  2. На вкладке Ключи доступа нажимаем кнопку Создать ключ;
  3. Разрешаем приложению доступ к сообщениям сообщества.
Создание ключа доступа

На этом подготовка на стороне ВКонтакте завершена.

Проверить отправку сообщений можно ссылкой:

https://api.vk.com/method/messages.send?v=5.37&access_token=XXX&message=TEXT&user_id=YYY 

            — XXX – ключ доступа;

            — TEXT – текст сообщения;

            — YYY – ID получателя.

Чтобы получателю пришло сообщение, нужно соответствующее разрешение. Например, получателю для начала нужно написать в сообщество

Если получили вывод такой, как написано ниже, всё сделано верно, и сообщение от сообщества пришло на нужный ID.

{"response":N}

                — N – число сообщений в диалоге с получателем.

Перейдём к следующему шагу.

Подготовка на стороне сервера телефонии

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

Подробнее о том, как реализовать отправку уведомлений о пропущенных из очереди, можно прочитать в статье «FreePBX. Настройка Астериск для уведомлений о пропущенных входящих вызовах».

Уведомления должны приходить всем операторам данной очереди.

Затем напишем скрипт, с помощью которого будем интегрироваться с ВКонтакте. Для этого в директории /var/www/html создадим папку vkapi. В ней будет храниться наш скрипт vkmess.php.

<?php
        $cid = $argv[1];
        $key = 'XXX';
        $text = "Пропущен вызов от $cid. Пожалуйста, перезвоните клиенту не более, чем через 1 час.";
        $url = 'https://api.vk.com/method/messages.send';
        $id = array('YYY1', 'YYY2');
        $to = is_array($id) ? $id : [$id];
        $data = array(
                'v' => '5.37',
                'access_token' => $key,
                'message' => $text,
                'user_ids' => implode(',', $to),
        );
        SendVKMessages($data, $url);
        function SendVKMessages($data, $url){
                $ch = curl_init();
                $par = http_build_query($data, '', '&');
                curl_setopt($ch, CURLOPT_URL, $url . "?$par");
                curl_setopt($ch, CURLOPT_HEADER, false);
                curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
                $res = curl_exec($ch);
        }
?>

Подробно рассмотрим, что делает скрипт. В начале скрипта объявляем необходимые переменные: номер звонящего, время поступления вызова, ключ доступа к сообществу, текст сообщения и ссылку для отправки сообщений.

Далее прописываем первый массив — $id. В нём будут храниться все нужные нам ID получателей. В переменной $to делаем проверку на то, является ли массивом $id.

Максимально можно указать до 100 получателей. ID получателей обязательно должны быть разделены символом ‘<strong><em>,</em></strong>’.

Затем прописываем второй массив — $data. Здесь указаны необходимые параметры, которые нужно передать в запросе: версия API, ключ доступа, текст сообщения, а также ID всех получателей, перечисленные через запятую.

Объявляем функцию для отправки сообщений, и передаём в неё массив с параметрами и URL. В самой функции формируем GET-запрос нужного вида, в котором все параметры указаны через ‘&’, и выполняем его.

На этом шаге можно проверить наш скрипт. Для этого в консоли введём команду. Также для наглядности введём свой ID для получения сообщения:

php -f vkmess.php 89998887766 

Если на текущем шаге всё сделано правильно, получим сообщение в ВКонтакте.

Теперь перейдём к диалплану. Для FreePBX понадобится файл extensions_override_freepbx.conf.

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

В нужном контексте прописываем следующий диалплан:

[from-queue-exten-only]
exten => h,1,NoOp(No Answer for queues)
same => n,ExecIf($["${FORWARD_CONTEXT}"!="from-internal"]?System(/usr/bin/php -f /var/www/html/vkapi/vkmess.php ${CALLERID(num)}))
same => n,Macro(hangupcall,)

Применим правки и совершим вызов. Как видно из лога, скрипт был вызван.

Лог вызова

Теперь перейдём в ВКонтакте и посмотрим результат тестирования нашего функционала. Из скриншота ниже видно, что сообщение пришло. Также оно пришло и другим получателям, указанным в скрипте.

Сообщение в ВКонтакте

На этом шаге статья по отправке уведомлений из Asterisk в ВКонтакте завершена.

Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

Остались вопросы?

Я - Першин Артём, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

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

Надежен в эксплуатации.

Время работы серверов некоторых наших клиентов исчисляется годами. Это значит, что Asterisk работает несколько лет, ему не требуются никакие перезагрузки или принудительные отключения. А еще это говорит о том, что в районе отличная ситуация с электроэнергией, но это уже не заслуга Asterisk.

Гибкий в настройке.

Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

Повышает управляемость бизнеса.

Asterisk дает не просто набор полезных функций, он повышает управляемость организации, качества и комфортности управления, а также увеличивает прозрачность бизнеса для руководства. Достичь этого можно, например, за счет автоматизации отчетов, подключения бота в Telegram, санкционированного доступа к станции из любой точки мира.

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.