Дерево сторінок
UA | EN

Перейти в кінець метадати
Перейти на старт метадати

Властивість
Тип
Опис
Властивість
Тип
Опис
twoWayViberboolTwoWayViber service activation attribute, possible values – true, false.
hiddenTextboolАтрибут екранування тексту на стороні сервера, можливі значення – true, false
promoboolАтрибут рекламних повідомлень, можливі значення - true, false.
typeenumМоже бути одне з наступних значень: `` SMS``, `` OTT``, `` OTTSMS``, використовується стратегія надсилання повідомлень»
ottValiditytimeПеріод дії повідомлення в альтернативному каналі може бути не заданий.
ottImageUriuriПосилання для користувача на зображення може бути не задано, для BiP, VIBER. Необхідна схема запиту (http, https)
ottActionUriuriПосилання для користувача, для переходу при натисканні кнопки в повідомленні, може бути не задане, для BiP, VIBER. Необхідна схема запиту(http, https). Для здійснення дзвінка через Viber необхідно задати даний атрибут як viber://keypad?Number=380ХХХХХХХХХ, де 380ХХХХХХХХХ - номер, на який буде здійснено дзвінок.
ottenumПроцедура надсилання повідомлень в альтернативні канали, можливі значення – BiP, VIBER
ottSourcestringСписок ідентифікаторів послуг в альтернативних каналах, порядок має відповідати порядку каналів в атрибуті ott. Якщо клієнт має лише один активний ідентифікатор для конкретного каналу, він буде використовуватися автоматично без зазначення джерела в запиті. Якщо аліас вказано в запиті - він буде використаний, якщо явно вказаний ідентифікатор служби відсутній.
ottActionTitlestringТекст на кнопці в повідомленні може бути не заданий, для BiP, VIBER.
Властивість
Тип 
Опис
idenumМоже бути одним із таких значень: singlebulkindividual
sourcestringAlphaname клієнта використовується для надсилання текстового повідомлення
tonumericНомер мобільного телефону абонента для відправки SMS-повідомлення (msisdn)
validitytimeТермін дії повідомлення, після закінчення цього терміну, повідомлення буде в статусі „expired“ (напр.: +10 min, +1 hour)
starttimeПовідомлення буде відкладено на час в "start"(напр.: +10 min, Mon,  02  Apr  2007  11:58:24  +0300)

Приклад нотифікації (XML)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<status date="Thu, 18 Feb 2021 14:51:52 +0200">
<detail date="Thu, 18 Feb 2021 14:51:51 +0200">
<id>1002995297</id>
<state>Delivered</state>
<deliveryChannel>SMS</deliveryChannel>
<direction>life</direction>
</detail>
</status>
Приклад нотифікації(JSON)
{
"date":"Thu, 18 Feb 2021 14:49:38 +0200",
"detail":[
{
"id":1002995292,
"state":{
"value":"Delivered"
},
"date":"2021-02-18T12:49:36.397+00:00",
"deliveryChannel":"SMS",
"direction":"life"
},
{
"id":1002995294,
"state":{
"value":"Delivered"
},
"date":"2021-02-18T12:49:36.398+00:00",
"deliveryChannel":"SMS",
"direction":"life"
},
{
"id":1002995289,
"state":{
"value":"Delivered"
},
"date":"2021-02-18T12:49:36.398+00:00",
"deliveryChannel":"SMS",
"direction":"life"
},
{
"id":1002995287,
"state":{
"value":"Delivered"
},
"date":"2021-02-18T12:49:36.399+00:00",
"deliveryChannel":"SMS",
"direction":"life"
}
]
}

Поля для налаштування API (Профіль):

  • URI для IP2SMS
  • URI for "Two-way Viber"
  • URI для інтерактивної нотифікації

Вимоги до URI:

  1. Якщо поле клієнта недоступне (наприклад, якщо відключений Viber), воно дізейблиться;
  2. При будь-яких змінах URI валідуються;
  3. Валідація URI: схема HTTP/HTTPS без портів;
  4. При збереженні змін URI перевіряється на доступність (статус код 200). Якщо URI не доступний, система не дозволяє зберегти його і показує помилку;

Якщо клієнтський сервіс відповідає помилкою (статус код не 200), система повторно відправляє нотифікації через 5, 30 і 60 хв відповідно.



  • No labels