Перейти к содержанию

PUSH WALLET

Отправка сообщения

Для отправки PUSH-сообщений необходимо вызвать POST метод, передавая в теле параметры сообщения с указанием данных авторизации в заголовке.

Информация

Для получения доступа к Push WALLET API обратитесь на адрес support@devinotele.com. Вам будет предоставлен Идентификатор отправителя, необходимый для использования API.

Параметры запроса

Тело запроса (bulk)

Параметр Тип данных Описание и допустимые значения
from string Идентификатор отправителя
to string Номер телефона получателя
Проверка на валидность номера телефона и обрезка
callbackUrl string Адрес отправителя колбека
Максимально 1000 символов
callbackData string Данные колбека
scheduledTime string Время отправки сообщения в формате LocalDateTime
mergeKey string (optional) Ключ для объединения ответа и запроса
payload PushPayload Настройки контента сообщения

Объект PushPayload

Содержит сведения о передаваемом сообщении

Параметр Тип данных Описание и допустимые значения
title string Заголовок сообщения
Максимально 50 символов
message string Текст сообщения
Максимально 2048 символов
image string Адрес изображения
Максимально 512 символов
deeplink Deeplink Параметры перехода в маркетинговое приложение

Содержит сведения о внутренней ссылке в приложении

Параметр Тип данных Описание и допустимые значения
target string Определяет экран Кошелька, к которому должен быть осуществлен переход при нажатии на сообщение:
card - к экрану выпущенной карты ритейлера
campaign - к конкретной акции по выпущенной карте ритейлера
campaigns - к полному списку всех акций по выпущенной карте ритейлера
campaignId string Идентификатор промо-акции ритейлера для перехода
Обязателен, если target = campaign
Максимально 512 символов

Пример запроса

curl
-X POST
-H "Authorization: Key QWxhZGRpbjpvcGVuIHNlc2=="
-H "Content-Type: application/json"
-d '{
        "from": "Company",
        "payload": {
            "deeplink": {
                "campaignId": "q123456",
                "target": "campaign"
            },
            "image": "http://ya.ru/kek.jpg",
            "message": "Покупайте у нас всё!!!",
            "title": "Новая невиданная ранее акция"
        },
        "to": "7926035511"
    }' "https://api.devino.online/wallet/message"

Пример ответа (отправка успешная)

{
  "result": [
    {
      "code": "OK",
      "result": 3670367897656669056
    }
  ]
}

Пример ответа (ошибка при отправке)

{
  "result": [
    {
      "code": "REJECTED",
      "result": null,
      "reasons": [
        {
          "key": "invalid.image.url"
        }
      ]
    }
  ]
}

Параметры ответа

Параметр Тип данных Описание и допустимые значения
result string Идентификационный номер, если сообщение успешно обработано
Null, если произошла ошибка при обработке сообщения
code string Код ответа:
OK, если сообщение успешно обработано
REJECTED, если сообщение не прошло валидацию
ERROR, если произошла ошибка сервера
reasons object Причины, сопровождающие ответ