Перейти до змісту

Повідомлення Viber

SMSBAT API підтримує кілька типів повідомлень Viber для різних випадків використання, від рекламних кампаній до сповіщень про трансакції.

Огляд типів повідомлень

Тип Призначення Мультимедіа Інтерактивний
viber_promo Маркетингові кампанії ✅ Зображення, відео ✅ Кнопки
viber_trans Повідомлення про транзакції ✅ PDF ❌
viber_carousel Вітрини продукції ✅ Зображення ✅ Кілька кнопок
viber_опитування Опитування та відгуки ❌ ✅ Кілька варіантів
viber_otp Одноразові паролі ❌ ❌

Viber Promo

Рекламні повідомлення з мультимедійною підтримкою для маркетингових кампаній.

Підтримуваний вміст

  • Лише зображення
  • Лише текст
  • кнопка «Текст +».
  • Зображення + текст + кнопка
  • Відео + текст
  • Відео + текст + кнопка
  • Лише відео

Параметри

Параметр Тип Необхідно Опис
img рядок Ні URL зображення
відео рядок Ні URL-адреса відеофайлу
мініатюра рядок Ні Попередній перегляд відео
кнопкаТекст рядок Ні Мітка кнопки із закликом до дії
buttonAction рядок Ні Цільова URL-адреса натискання кнопки
розмір файлу ціле Ні Розмір відеофайлу в байтах
тривалість ціле Ні Тривалість відео в секундах

Приклади

Текст + зображення + кнопка

Текст + зображення + приклад кнопки

{
  "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
  }
}

Транзакції Viber

Сповіщення про транзакції для чутливої до часу інформації, як-от підтвердження замовлень і квитанції.

Підтримуваний вміст

  • Лише текст
  • файл PDF + текст
  • Лише файл PDF

Параметри

Параметр Тип Необхідно Опис
fileUrl рядок Ні URL документа PDF
назва файлу рядок Ні Відображуване ім'я для вкладення
тип файлу рядок Ні Тип файлу (використовуйте "pdf")

Приклади

Лише текст

Тільки текстовий приклад

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

Текст + PDF

Текст + приклад PDF

{
  "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
}

Тільки PDF

Приклад лише PDF

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

Viber Карусель

Вітрина продуктів або вмісту з кількома елементами, яку можна переглядати.

Структура

Масив елементів каруселі, кожен з яких містить:

  • Назва
  • Імідж
  • Основна кнопка (основна дія)
  • Додаткова кнопка (альтернативна дія)

Параметри

Параметр Тип Необхідно Опис
карусель масив Так Масив елементів каруселі
предмети масив Так Індивідуальна картка об'єктів

Приклад

Приклад каруселі Viber

{
  "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"
          }
        }
      ]
    }
  }
}

Опитування Viber

Інтерактивні опитування та збір відгуків із кількома варіантами вибору.

Параметри

Параметр Тип Необхідно Опис
опитування об'єкт Так Оглядовий контейнер
параметри масив Так Масив з 1-5 варіантів відповіді

Обмеження

  • Підтримується максимум 5 варіантів відповіді
  • Кожен варіант має бути лаконічним (рекомендовано: до 30 символів)

Приклад

Приклад опитування Viber

{
  "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"
      ]
    }
  }
}

Viber OTP

Доставка одноразових паролів із попередньо визначеними шаблонами.

Ключові характеристики

  • 9 попередньо визначених шаблонів
  • Перевірка параметрів (TEXT, NUMBER типів)
  • Багатомовна підтримка (19 мов)
  • Імена змінних з урахуванням регістру

Підтримувані мови

українська, англійська, російська, польська, румунська, іспанська, німецька, французька, італійська, португальська, голландська, турецька, арабська, іврит, гінді, китайська, японська, корейська, в’єтнамська

Параметри

Параметр Тип Необхідно Опис
templateId рядок (UUID) Так Ідентифікатор шаблону
templateLang рядок Так Код мови ISO
templateParams об'єкт Так Шаблон відповідності змінних

Приклад

Приклад Viber OTP

{
  "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 хвилин. Ніколи не повідомляйте цей код».

Підтримувані шаблони та перевірки

Viber пропонує заздалегідь визначені та суворо контрольовані шаблони. Передані параметри змінних мають відповідати правильним типам даних.

Типи даних: - ЧИСЛО: лише цифри [0-9], +, - і .. Такі символи, як «/» або пробіли, не підтримуються. - ТЕКСТ: алфавіт будь-якої мови, символи (@#$%^&*().,<>;:!\"'+=-()[]{} \n тощо). - Регулярне відображення: послідовність <букв> не може існувати поруч із послідовністю <число>; вони вимагають розділення пробілами. Подвійні пробіли всередині шаблонів зазвичай заборонені. Для посилань уникайте пробілів, якщо вони перевищують обмеження.

Нижче наведено 9 стандартних шаблонів ISO. Замінюйте ідентифікатори відповідно до ваших реєстраційних вимог у певних країнах. Зверніться до служби підтримки, якщо додаєте додаткові мови.

1. "ЛИШЕ код (будь-який PIN-код)"

Вимоги: підтримує PIN-коди цифрами та англійськими літерами, символами - або .. Шаблон потребує форматування, щоб правильно відображати ваш бренд разом із PIN-кодом підтвердження.

2. «Дія: Будь ласка, використовуйте цей код»

Параметри: {pin} (ЧИСЛО або ТЕКСТ) Приклад формату: «Будь ласка, використовуйте цей код {pin} для підтвердження».

3. «Реєстрація бренду/доступ»

Параметри: {business_platform_name} (ТЕКСТ), {pin} (ЧИСЛО або ТЕКСТ) Приклад формату: "Ваш код для {business_platform_name} – {pin}".

4. "Час перевірки коду"

Параметри: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Приклад формату: «Ваш код підтвердження – {pin}. Він дійсний протягом {code_validity_time} хвилин."

5. «Доступ до бренду та перевірка коду»

Параметри: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Приклад формату: "{business_platform_name} код підтвердження {pin} дійсний {code_validity_time} хвилин."

(Примітка: існує до 9 попередньо визначених структурних блоків для стандартних правил OTP Viber на основі комбінацій використання pin, business_platform_name і code_validity_time).

Загальні вимоги

Усі типи повідомлень Viber вимагають:

  • від: буквено-цифровий ідентифікатор відправника
  • to: номер телефону у форматі E.164
  • type: ідентифікатор типу повідомлення
  • ttl: час закінчення терміну дії повідомлення в секундах (рекомендовано)

Повернення до SMS

Усі типи повідомлень Viber підтримують резервні SMS-повідомлення з використанням блоку масиву «резервні варіанти». Якщо доставка Viber не вдається, повідомлення автоматично повертається до альтернативних налаштованих каналів.

Viber Promo -> SMS Fallback

{
  "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
        }
      ]
    }
  ]
}

Viber Survey -> SMS Fallback

{
  "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"
        }
      ]
    }
  ]
}

Viber Trans -> SMS Fallback

{
  "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
        }
      ]
    }
  ]
}

Найкращі практики

Зображення

  • Використовуйте формат JPG або PNG
  • Рекомендований розмір: 800x600 пікселів
  • Зберігайте розмір файлу менше 1 Мб
  • Використовуйте URL-адреси HTTPS

Відео

  • Використовуйте формат MP4
  • Зберігайте розмір файлу менше 10 МБ
  • Додайте ескіз зображення
  • Вкажіть тривалість і розмір файлу

Кнопки

  • Текст кнопки повинен бути коротким (2-3 слова)
  • Використовуйте чіткі заклики до дії
  • Завжди використовуйте URL-адреси HTTPS
  • Перевірте URL-адреси перед надсиланням

TTL (Time-to-Live)

  • Рекламні повідомлення: 24-72 години
  • Повідомлення про транзакції: 24 години
  • OTP-повідомлення: 5-10 хвилин
  • Опитування: 7-30 днів

Наступні кроки