Download the PHP package druidvav/badapush-client without Composer
On this page you can find all versions of the php package druidvav/badapush-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package badapush-client
Клиент BadaPush
Использование клиента
Клиент используется для отправки push-уведомлений, sms и постановки задач на обзвон, а также получения результатов отправки и обзвона.
Установка стандартная:
Для каждого из действий нужно создать сервис на сайте badapush.ru и получить API-ключ.
Для работы используются два основных класса
Druidvav\BadapushClient\BadapushQueueClient
— Используется для отправки сообщений через очередь (только push и sms)Druidvav\BadapushClient\BadapushClient
— Используется для отправки сообщений сразу
Инициализация клиента
Для симфони выглядит так:
Либо напрямую:
Отправка SMS
Отправку SMS рекоммендуем делать через очередь.
Push-уведомления (APNS, FCM)
Отправка уведомлений
Отправку push-уведомлений рекоммендуем делать через очередь.
Сбор информации об ошибках
Если вы отправляли уведомления через очередь, то ошибки доставки можно получить с помощью специального метода. Фактически, требует обработки только ошибка с неправильным идентификатором устройства:
Задачи на обзвон «Badapush Caller»
Отправка задач на обзвон
Отправка задач на обзвон работает только без очереди.
Отмена задач на обзвон
Допустим, вы поставили задачу на уведомление клиента о том, что он не забрал посылку, а он посылку уже забрал. Или на сбор информации, которую вы уже получили. Чтобы обзвонщики не звонили просто так — желательно отменить задачу. Задачи отменяются по externalID
, если с переданным externalId
нет задач — ничего страшного. Следить за тем, что задача реально была создана, необязательно.
Сбор результатов выполнения задач
Привожу пример кода по сбору информации о выполненных задачах на обзвон.
Настройка сервисов в badapush
Сервис «Badapush Caller»
Сервис для обзвонов — готов к использованию сразу после создания. Если вы хотите добавить дополнительные поля в интерфейс обзвона или добавить ссылку на вашу админку — потребуется настроить поле «Конфигурация полей». Поле должно содержать правильный JSON определенного формата.
Пример:
Как видим, здесь указывается массив объектов с определенными полями:
field
— значениеkey
из примера вызоваsetDataFields
вышe.title
— название поля отображаемое обзвонщику в интерфейсеurl_field
— значениеkey
в котором указывается ссылка, которая будет отображена на значении отображаемом в этом поле. Внимание! Первая переданная в задаче ссылка будет отображаться как iframe на странице обзвонщика, чтобы он мог увидеть необходимую информацию из проекта не уходя со страницы обзвона.
Полей может быть сколько угодно, но лучше ограничиться разумным количеством и передать ссылку на админку проекта.
Сервис Apple Push Notification Service
Для работы нужно указать Bundle ID вашего приложения, а также приложить сертификат, либо (что проще) приложить файл p12.
Сгенерировать файл можно, например, по этой инструкции. Если вы указали при экспорте пароль — укажите его при загрузке файла в badapush. Обратите внимание, что сертификат должен быть обязательно Production.
Для работы мы используем протокол http/2.
Сервис Google Cloud Messaging
Он же Firebase Cloud Messaging. Для работы требуется ключ «Firebase Server Key», который можно получить в админке Firebase вашего проекта.
Инструкция: https://firebase.google.com/docs/cloud-messaging/auth-server#authorize-legacy-protocol-send-requests
На данном этапе мы используем Legacy-протокол.
Сервис SmsTraffic
Для работы нужно обязательно указать логин и пароль от учетной записи SmsTraffic, а также название отправителя, которое должно быть согласовано в сервисе smstraffic.
All versions of badapush-client with dependencies
ext-curl Version *
ext-json Version *