Viber съобщения

SMSBAT API поддържа множество типове Viber съобщения за различни случаи на употреба, от промоционални кампании до известия за транзакции.

Общ преглед на типовете съобщения

Тип	Цел	Мултимедия	Интерактивен
`viber_promo`	Маркетингови кампании	✅ Изображения, видеоклипове	✅ Бутони
`viber_trans`	Известия за транзакции	✅ PDF файлове	❌
`viber_carousel`	Продуктови витрини	✅ Изображения	✅ Множество бутони
`viber_анкета`	Анкети и отзиви	❌	✅ Няколко опции
`viber_otp`	Еднократни пароли	❌	❌

Промоция на Viber

Промоционални съобщения с богата медийна поддръжка за маркетингови кампании.

Поддържано съдържание

Само изображение
Само текст
Текст + бутон
Изображение + текст + бутон
Видео + текст
Видео + текст + бутон
Само видео

Параметри

Параметър	Тип	Задължително	Описание
`img`	низ	Не	URL адрес на изображение
`видео`	низ	Не	URL адрес на видео файл
`миниатюра`	низ	Не	Изображение за преглед на видео
`бутонТекст`	низ	Не	Етикет на бутона с призив за действие
`бутонДействие`	низ	Не	Щракване върху 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 Transactional

Известия за транзакции за чувствителна към времето информация като потвърждения на поръчки и разписки.

Поддържано съдържание

Само текст
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 Carousel

Витрина с множество артикули за продукти или съдържание.

Структура

Масив от елементи на въртележка, всеки от които съдържа:

Заглавие
Изображение
Основен бутон (основно действие)
Вторичен бутон (алтернативно действие)

Параметри

Параметър	Тип	Задължително	Описание
`въртележка`	масив	Да	Масив от елементи на въртележка
`елементи`	масив	Да	Обекти на индивидуална карта

Пример

Пример за въртележка на 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 предварително дефинирани шаблона
Валидиране на параметър (ТЕКСТ, 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 шаблона. Заменете ID въз основа на вашите изисквания за регистрация в конкретни държави. Свържете се с поддръжката, ако добавяте допълнителни езици.

1. „САМО код (всеки PIN)“

Изисквания: Поддържа PIN кодове с цифри и английски букви, символи - или .. Шаблонът изисква форматиране, за да показва вашата марка правилно заедно с ПИН кода за потвърждение.

2. „Действие: Моля, използвайте този код“

Параметри: {pin} (ЧИСЛО или ТЕКСТ) Примерен формат: „Моля, използвайте този код {pin} за потвърждение.“

3. „Регистрация на марката/достъп“

Параметри: {business_platform_name} (TEXT), {pin} (NUMBER или TEXT) Примерен формат: „Вашият код за {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 изискват:

от: Буквено-цифров идентификатор на изпращача
до: Телефонен номер във формат E.164
type: Идентификатор на типа съобщение
ttl: Време за изтичане на съобщението в секунди (препоръчително)

Резервен към SMS

Всички типове съобщения във Viber поддържат резервен SMS чрез използване на блока масив „резервни“. Ако доставката на Viber е неуспешна, съобщението автоматично се връща към алтернативни конфигурирани канали.

Промоция на Viber -> Резервен SMS

{
  "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 -> Резервен SMS

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

{
  "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 MB
Използвайте HTTPS URL адреси

Видеоклипове

Използвайте MP4 формат
Поддържайте размера на файла под 10 MB
Включете миниатюрно изображение
Посочете продължителност и размер на файла

Бутони

Поддържайте кратък текст на бутона (2-3 думи)
Използвайте ясни фрази, подканващи към действие
Винаги използвайте HTTPS URL адреси
Тествайте URL адресите преди изпращане

TTL (Time-to-Live)

Промоционални съобщения: 24-72 часа
Транзакционни съобщения: 24 часа
OTP съобщения: 5-10 минути
Анкети: 7-30 дни

Следващи стъпки

SMS съобщения - Научете за резервния SMS
RCS съобщения - Богати комуникационни услуги
Проверете състоянието - Проследете състоянието на доставката