Документация

Возможности платформы kupon.mobi

API

Описание протоколов интеграции с внешними приложениями.

API

Каскадные рассылки по API

Для организации каскадных рассылок через API необходимо учесть, что в настоящий момент такая возможность присутствует только при работе по протоколу HTTP

Процесс запуска каскадной рассылки очень прост. Для этого Вам необходимо создать рассылку с типом "Рассылка по сценарию"

type_bulk.png

Для формирования каскада рассылки необходимо передать через API СМС сообщение с типом bulk и в качестве подписи отправителя указать цифровой код "Рассылки по сценарию". Тем самым будет запущен каскад для заданного СМС.

API

Типы сообщений при отправке через API

При отправке сообщений в платформу Kupon.mobi вы можете отправлять типы сообщений указанных в списке ниже:

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

* Виртуальный тип сообщения bulk, который можно применить для формирования каскадной рассылки по API.

API

HTTP API

Отправка сообщений из платформы осуществляется посредством отправки специальным образом сформированных GET/POST запросов к сервису
В случае возникновения вопросов обращайтесь в службу технической поддержки по телефону 8­ 800 ­100 ­6003 Звонок по России бесплатный.
Наши специалисты могут помочь Вам связать Ваш сайт, интернет магазин или ваше программное обеспечение с нашим сервисом абсолютно бесплатно.

Техническая часть

Адрес сервиса: https://1-pulse.kupon.mobi/api/v1/bulk/send-message

Параметры

* - для сообщений типа bulk игнорируется, если параметр задан в настройках рассылки;

Ответы сервиса

В ответ на отправку POST/GET запроса формируется объект JSON. Если сообщение было отправлено формируется JSON структура содержащая поле type=success, поле id=<id>Идентификатора сообщения присвоенный системой<id>. В случае ошибки поле type=error, поле msg=описание ошибки. При получении статуса сообщения происходит вызов callback.

Адрес сервиса: https://1-pulse.kupon.mobi/api/v1/bulk/send-list-messages

API

Возможные статусы сообщений

При отправке сообщений процесс доставки контролируется промежуточными и конечными статусами. Возможные типы статусов и их цифровое обозначение в списке ниже:

Формирование рассылок

Возможности платформы KUPON.MOBI по созданию каскадных рассылок

Формирование рассылок

Инструкция по формированию рассылок

В данном разделе описаны  возможности платформы KUPON.MOBI по формированию  рассылок

Платформа  позволяет создавать следующие виды рассылок:

  1. SMS-информирования;
  2. Вайбер;
  3. Email-сообщения;
  4. Push-уведомления;
  5. Создание голосовых сообщений. 
  6. Отправка сообщений в социальные сети Вконтакте/Одноклассники!;
  7. WhatsApp.!

Данные виды рассылки включаются по желанию пользователя.

На платформе реализовано два способа по формированию  рассылок:

  1.  через вкладку "Клиенты"/"Рассылки"

Для этого необходимо на рабочем столе платформы  перейти на  вкладку "Клиенты" и из раскрывающего списка выбрать "рассылки" и осуществить  переход в диалоговое окно "Рассылки".

Рисунок 11.png

В правом верхнем углу диалогового окна "рассылки" нажимаем кнопку "Создать рассылку" и переходим в раздел "Рассылки"\"Настройки рассылки" .

Рисунок 2

Рассылка-5.png

По умолчанию в запланированную рассылку добавляются все клиенты, занесенные в во вкладке "Клиенты".

Для изменения данной настройки нажимаем на кнопку "Всего в рассылке".

Рисунок 3

Рисунок-1.png

Осуществляем переход во вкладку "Клиенты", где с помощью вкладок - "Фильтры", "Поле" и "Настроить диапазон" настраиваем базу для отправки  и нажимаем кнопку "Выбрать".

Рисунок 4

Рисунок-2.png

Рассылка будет проходит только для клиентов из настроенного списка. 

На платформе Kupon.Mobi реализована функция определения сценария рассылки, с использованием различных каналов отправки сообщений, что позволяет  повысить процент доставки сообщений  и сократить расходы на рассылку. 

 

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

Рисунок 5

55Cрисунок-6.png

Далее  происходит переход к настройке  "каналов отправления", исходя из выбранной очередности рассылки.

В диалоговом окне  "Push/Вайбер канал" заполняем поля "текст сообщения",  "заголовок PUSH сообщения", из раскрывающего списка поля "срок жизни сообщения" настраиваем время жизни сообщения.

Если рассылка "Push/Вайбер канал" требует "изображения",  на платформе имеется возможность его вставки  в рассылку. Для этого в поле "изображение"  нажимаем активную кнопку и прикрепляем нужное изображение.

Платформа так же предоставляет возможность создания "активной кнопки" в рассылке. 

 В поле  "надпись кнопки" указываем название  и в поле "ссылка на кнопку" вставляем активную ссылку.!

Без указания активной ссылки в поле "ссылка на кнопку" дальнейшая настройка рассылки невозможна.

Рисунок 6

Рисунок-4.png

 

В диалоговом окне "SMS канал"  заполняем поле "текст", в поле "срок жизни сообщения" из раскрывающего списка выбираем срок его жизни. 

Рисунок 7

Рисунок-3.png

В диалоговом окне  "Email канал" заполняем поля "тема", текст сообщения!,  определяем имя и название рассылки отправителя, в поле  "срок жизни сообщения" из раскрывающего списка настраиваем время. 

В Email канал реализован выбор создания  сообщений - простое текстовое или оформленное!

Рисунок 8

Рисчунок-6.png

В диалоговом окне "канал Звонок" заполняем  поле "текст сообщения", в поле  "срок жизни сообщения"из раскрывающего списка выбираем нужное нам время,  далее настраиваем поле "количество попыток дозвона",  для этого из раскрывающегося списка выбираем нужное  количество попыток, в поле  "голос" настраиваем звуковое сопровождение. 

Рисунок 9

Рисунок-7.png

 

Далее происходит переход к настройкам самой рассылки.

В диалогом окне заполняем поле "название рассылки", настраиваем "запуск рассылки" (время/дата),  из раскрывающего списка выбираем плавность и ограничение рассылки, а так же определяем вид рассылки - обычная рассылка/ рассылка по сценарию.!

Рассылка по сценарию возможна только при созданной ранее "Кампании"!

 

Рисунок 10

Рисунок-8.png

Рисунок 11

Рисунок-9.png

Все поля, выделенные красным, обязательны для заполнения!

 

Рассылка будет проходит по заданному Вами сценарию! 

Переход от одного канала к другому происходит  после окончания определенного Вами срока жизни сообщения!

 

2. через вкладку "Клиенты"/"Клиенты"

Для этого необходимо на рабочем столе платформы  перейти на  вкладку "Клиенты" и из раскрывающего списка выбрать "Клиенты" и осуществить  переход в диалоговое окно "Клиенты".

В правом углу диалогового окна находим кнопку "самолет" и нажатием левой кнопки мыши осуществляем переход в "Рассылки"/"Настройки рассылки".

Рисунок 1

Рисунок-10.png

Формирование и настройка самой рассылка аналогична описанной в разделе "Клиенты"/"Рассылки"

 

3. При формировании Рассылок можно использовать  "Шаблоны", "Макросы", "Ссылки" и "Эмоции" для облегчения формирования текста сообщения.

Рисунок 1

Рисунок-1.png

1. Для вставки ссылки в сообщение нажимаем на кнопку "Ссылки" и из раскрывающегося списка выбираем нужную "Ссылку" и нажимаем кнопку "Вставить".

Рисунок 2 

Рисунок-2.png

Рисунок 3