Help Center Вибер поруке

Вибер поруке

СМСБАТ АПИ подржава више типова Вибер порука за различите случајеве употребе, од промотивних кампања до обавештења о трансакцијама.

Преглед типова порука

Тип	Сврха	Рицх Медиа	Интерацтиве
`вибер_промо`	Маркетиншке кампање	✅ Слике, видео снимци	✅ Дугмад
`вибер_транс`	Обавештења о трансакцијама	✅ ПДФ-ови	❌
`вибер_цароусел`	Витрине производа	✅ Слике	✅ Више дугмади
`вибер_сурвеи`	Анкете и повратне информације	❌	✅ Више опција
`вибер_отп`	Једнократне лозинке	❌	❌

Вибер Промо

Промотивне поруке са богатом медијском подршком за маркетиншке кампање.

Подржани садржај

Само слика
Само текст
Текст + дугме
Слика + текст + дугме
Видео + текст
Видео + текст + дугме
Само видео

Параметерс

Параметар	Тип	Обавезно	Опис
`имг`	стринг	Не	УРЛ слике
`видео`	стринг	Не	УРЛ видео датотеке
`сличица`	стринг	Не	Видео преглед слике
`буттонТект`	стринг	Не	Ознака дугмета са позивом на акцију
`буттонАцтион`	стринг	Не	УРЛ одредиште за клик на дугме
`филеСизе`	цео број	Не	Величина видео датотеке у бајтовима
`трајање`	цео број	Не	Дужина видеа у секундама

Примери

Текст + Слика + Дугме

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Summer Sale! Up to 50% off on selected items.",
  "messageData": {
    "img": "https://example.com/summer-sale.jpg",
    "buttonText": "Shop Now",
    "buttonAction": "https://example.com/sale"
  }
}

Видео + Текст + Дугме

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new product demo!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30,
    "buttonText": "Learn More",
    "buttonAction": "https://example.com/product"
  }
}

Само слика

Само пример слике

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "img": "https://example.com/banner.jpg"
  }
}

Само текст

Пример само текста

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Your promo text message"
}

Само видео

Само пример видеа

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Видео + Текст

Видео + Текст Пример

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new video!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Вибер Трансацтионал

Обавештења о трансакцијама за временско осетљиве информације као што су потврде поруџбина и признанице.

Подржани садржај

Само текст
ПДФ датотека + текст
Само ПДФ датотека

Параметерс

Параметар	Тип	Обавезно	Опис
`филеУрл`	стринг	Не	УРЛ ПДФ документа
`филеНаме`	стринг	Не	Име за приказ за прилог
`филеТипе`	стринг	Не	Тип датотеке (користите “пдф”)

Примери

Само текст

Пример само текста

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed and will be delivered tomorrow.",
  "ttl": 86400
}

Текст + ПДФ

Текст + ПДФ пример

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Thank you for your purchase! Please find your invoice attached.",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Само ПДФ

Само ПДФ пример

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Вибер карусел

Витрина са више ставки за преглед производа или садржаја.

Структура

Низ ставки вртешке, од којих свака садржи:

Наслов
Слика
Примарно дугме (главна радња)
Секундарни тастер (алтернативна радња)

Параметерс

Параметар	Тип	Обавезно	Опис
`вртуљак`	низ	Да	Низ ставки вртешке
`предмети`	низ	Да	Појединачни објекти картице

Пример

Пример Вибер вртешке

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_carousel",
  "text": "Check out our featured products",
  "messageData": {
    "carousel": {
      "items": [
        {
          "title": "Product A",
          "imageUrl": "https://example.com/product-a.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-a"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-a/details"
          }
        },
        {
          "title": "Product B",
          "imageUrl": "https://example.com/product-b.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-b"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-b/details"
          }
        }
      ]
    }
  }
}

Вибер анкета

Интерактивне анкете и прикупљање повратних информација са опцијама вишеструког избора.

Параметерс

Параметар	Тип	Обавезно	Опис
`анкета`	објекат	Да	Прегледни контејнер
`опције`	низ	Да	Низ од 1-5 одговора

Ограничења

Подржано је највише 5 опција одговора
Свака опција треба да буде сажета (препоручено: испод 30 карактера)

Пример

Пример Вибер анкете

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_survey",
  "text": "How satisfied are you with our service?",
  "messageData": {
    "survey": {
      "options": [
        "Very Satisfied",
        "Satisfied",
        "Neutral",
        "Dissatisfied",
        "Very Dissatisfied"
      ]
    }
  }
}

Вибер ОТП

Испорука једнократне лозинке са унапред дефинисаним шаблонима.

Кључне карактеристике

9 унапред дефинисаних шаблона – Валидација параметара (ТЕКСТ, НУМБЕР типова)
Подршка за више језика (19 језика)
Имена променљивих осетљивих на велика и мала слова

Подржани језици

Украјински, енглески, руски, пољски, румунски, шпански, немачки, француски, италијански, португалски, холандски, турски, арапски, хебрејски, хинди, кинески, јапански, корејски, вијетнамски

Параметерс

Параметар	Тип	Обавезно	Опис
`темплатеИд`	стринг (УУИД)	Да	Идентификатор шаблона
`темплатеЛанг`	стринг	Да	ИСО код језика
`темплатеПарамс`	објекат	Да	Променљиве које одговарају шаблону

Пример

Вибер ОТП пример

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "templateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "templateLang": "en",
    "templateParams": {
      "PIN": "123456",
      "TIME": "10"
    }
  },
  "ttl": 600
}

Пример шаблона: „Ваш код: 123456. Важи 10 минута. Никада не делите овај код.“

Подржани шаблони и валидације

Вибер нуди унапред дефинисане и строго контролисане шаблоне. Прослеђени параметри променљивих морају одговарати исправним типовима података.

Типови података:

БРОЈ: Само бројеви [0-9], +, - и .. Симболи попут / или размака нису подржани.
ТЕКСТ: Абецеда било којег језика, симболи (@#$%^&*().,<>;:!\"'+=-()[]{} \н итд.).
Уобичајено мапирање: Низ <слова> не може постојати поред низа <број>; захтевају раздвајање празнина. Двоструки размаци унутар шаблона су генерално забрањени. За везе избегавајте размаке ако прелазе ограничења.

Испод је 9 стандардних ИСО шаблона. Замените ИД-ове на основу захтева за регистрацију у одређеним земљама. Контактирајте подршку ако додајете додатне језике.

1. “САМО код (било који ПИН)”

Захтеви: Подржава ПИН-ове у бројевима и енглеским словима, симболима - или .. Шаблон захтева форматирање да би се ваш бренд правилно приказао поред ПИН-а за верификацију.

2. “Радња: Молимо користите овај код”

Параметри: {пин} (БРОЈ или ТЕКСТ) Пример формата: „Користите овај код {пин} за верификацију.“

3. “Регистрација бренда/приступ”

Параметри: {бусинесс_платформ_наме} (ТЕКСТ), {пин} (НУМБЕР или ТЕКСТ) Пример формата: „Ваш код за {бусинесс_платформ_наме} је {пин}.“

4. „Време за валидацију кода“

Параметри: {пин} (НУМБЕР/ТЕКСТ), {цоде_валидити_тиме} (НУМБЕР) Пример формата: „Ваш верификациони код је {пин}. Важи {цоде_валидити_тиме} минута.”

5. „Приступ бренду и валидација кода“

Параметри: {бусинесс_платформ_наме} (ТЕКСТ), {пин} (НУМБЕР/ТЕКСТ), {цоде_валидити_тиме} (НУМБЕР) Пример формата: „{бусинесс_платформ_наме} верификациони код је {пин} важећи {цоде_валидити_тиме} минута.“

(Напомена: Постоји до 9 унапред дефинисаних структурних блокова за Вибер стандардна ОТП правила заснована на комбинацијама употребе пин, бусинесс_платформ_наме и цоде_валидити_тиме).

Општи захтеви

Сви типови Вибер порука захтевају:

од: Алфанумерички ИД пошиљаоца
за: Број телефона у формату Е.164
тип: идентификатор типа поруке
ттл: време истека поруке у секундама (препоручено)

Повратак на СМС

Сви типови Вибер порука подржавају резервни СМС користећи блок низа фаллбацкс. Ако Вибер испорука не успе, порука се аутоматски враћа на алтернативне конфигурисане канале.

Вибер Промо -> СМС Фаллбацк

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_promo",
      "text": "Your Viber promo message",
      "ttl": 300,
      "messageData": {
        "img": "https://cdn.example.com/image.png",
        "buttonText": "View Offer",
        "buttonAction": "https://example.com"
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "Order #111 is waiting for you in our store",
          "ttl": 5600
        }
      ]
    }
  ]
}

Вибер анкета -> СМС Фаллбацк

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_survey",
      "text": "Please share your feedback",
      "ttl": 30,
      "messageData": {
        "survey": {
          "options": [
            "Very Good",
            "Good",
            "Bad"
          ]
        }
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for the survey"
        }
      ]
    }
  ]
}

Вибер Транс -> СМС Фаллбацк

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_trans",
      "text": "Your account details",
      "ttl": 300,
      "messageData": {},
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for trans message text",
          "ttl": 5600
        }
      ]
    }
  ]
}

Најбоље праксе

Слике

Користите ЈПГ или ПНГ формат
Препоручена величина: 800к600 пиксела
Задржите величину датотеке испод 1МБ
Користите ХТТПС УРЛ адресе

Видеос

Користите МП4 формат
Задржите величину датотеке испод 10 МБ
Укључите сличицу
Одредите трајање и величину датотеке

Дугмад

Нека текст дугмета буде кратак (2-3 речи) – Користите јасне фразе позива на акцију – Увек користите ХТТПС УРЛ адресе
Тестирајте УРЛ-ове пре слања

ТТЛ (време за живот)

Промотивне поруке: 24-72 сата
Трансакционе поруке: 24 сата
ОТП поруке: 5-10 минута
Анкете: 7-30 дана

Следећи кораци

СМС поруке - Сазнајте више о резервном СМС-у
РЦС поруке - Богате комуникационе услуге
Провери статус - Пратите статус испоруке

Search Results

Вибер поруке

Преглед типова порука

Вибер Промо

Подржани садржај

Параметерс

Примери

Текст + Слика + Дугме

Видео + Текст + Дугме

Само слика

Само текст

Само видео

Видео + Текст

Вибер Трансацтионал

Подржани садржај

Параметерс

Примери

Само текст

Текст + ПДФ

Само ПДФ

Вибер карусел

Структура

Параметерс

Пример

Вибер анкета

Параметерс

Ограничења

Пример

Вибер ОТП

Кључне карактеристике

Подржани језици

Параметерс

Пример

Подржани шаблони и валидације

1. “САМО код (било који ПИН)”

2. “Радња: Молимо користите овај код”

3. “Регистрација бренда/приступ”

4. „Време за валидацију кода“

5. „Приступ бренду и валидација кода“

Општи захтеви

Повратак на СМС

Вибер Промо -> СМС Фаллбацк

Вибер анкета -> СМС Фаллбацк

Вибер Транс -> СМС Фаллбацк

Најбоље праксе

Слике

Видеос

Дугмад

ТТЛ (време за живот)

Следећи кораци