Help Center Wiadomości Vibera

Wiadomości Vibera

SMSBAT API obsługuje wiele typów wiadomości Viber do różnych zastosowań, od kampanii promocyjnych po powiadomienia o transakcjach.

Przegląd typów wiadomości

WpiszCelBogate multimediaInteraktywny
viber_promoKampanie marketingowe✅ Zdjęcia, filmy✅Przyciski
viber_transPowiadomienia transakcyjne✅Pliki PDF❌
viber_karuzelaPrezentacje produktów✅ Obrazy✅ Wiele przycisków
viber_ankietaAnkiety i opinie❌✅ Wiele opcji
viber_otpHasła jednorazowe❌❌

Promocja Vibera

Przekazy promocyjne z bogatą obsługą medialną kampanii marketingowych.

Obsługiwana treść

  • Tylko obraz
  • Tylko tekst
  • Tekst + przycisk
  • Obraz + tekst + przycisk
  • Wideo + tekst
  • Wideo + tekst + przycisk
  • Tylko wideo

Parametry

ParametrWpiszWymaganeOpis
imgciągNieAdres URL obrazu
wideociągNieAdres URL pliku wideo
miniaturaciągNieObraz podglądu wideo
Tekst przyciskuciągNieEtykieta przycisku wezwania do działania
przyciskAkcjaciągNieKliknij przycisk Docelowy adres URL
Rozmiar plikuliczba całkowitaNieRozmiar pliku wideo w bajtach
czas trwanialiczba całkowitaNieDługość filmu w sekundach

Przykłady

Tekst + Obraz + Przycisk

Tekst + obraz + przykład przycisku

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

Wideo + tekst + przycisk

Przykład wideo + tekst + przycisk

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

Tylko obraz

Przykład tylko obrazu

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

Tylko tekst

Przykład tylko tekstowy

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

Tylko wideo

Przykład tylko wideo

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

Wideo + tekst

Przykład filmu i tekstu

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

Transakcje Vibera

Powiadomienia o transakcjach dotyczące informacji wrażliwych na czas, takich jak potwierdzenia zamówień i rachunki.

Obsługiwana treść

  • Tylko tekst
  • Plik PDF + tekst
  • Tylko plik PDF

Parametry

ParametrWpiszWymaganeOpis
UrlplikuciągNieAdres URL dokumentu PDF
Nazwa plikuciągNieNazwa wyświetlana załącznika
typ plikuciągNieTyp pliku (użyj „pdf”)

Przykłady

Tylko tekst

Przykład tylko tekstowy

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

Tekst + PDF

Tekst + przykład 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
}

Tylko PDF

Przykład tylko w formacie PDF

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

Karuzela Vibera

Prezentacja produktów lub treści z wieloma elementami, którą można przeglądać.

Struktura

Zestaw elementów karuzelowych, z których każdy zawiera:

  • Tytuł
  • Obraz
  • Przycisk główny (akcja główna)
  • Przycisk dodatkowy (akcja alternatywna)

Parametry

ParametrWpiszWymaganeOpis
karuzelatablicaTakTablica elementów karuzeli
przedmiotytablicaTakPoszczególne obiekty kart

Przykład

Przykład karuzeli 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"
          }
        }
      ]
    }
  }
}

Ankieta Vibera

Interaktywne ankiety i zbieranie opinii z możliwością wielokrotnego wyboru.

Parametry

ParametrWpiszWymaganeOpis
„ankieta”obiektTakKontener ankietowy
opcjetablicaTakTablica 1-5 odpowiedzi do wyboru

Ograniczenia

  • Obsługiwanych jest maksymalnie 5 opcji odpowiedzi
  • Każda opcja powinna być zwięzła (zalecane: poniżej 30 znaków)

Przykład

Przykład ankiety 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

Jednorazowe dostarczenie hasła z predefiniowanymi szablonami.

Kluczowe funkcje

  • 9 predefiniowanych szablonów
  • Walidacja parametrów (typy TEXT, NUMBER)
  • Obsługa wielu języków (19 języków)
  • W nazwach zmiennych rozróżniana jest wielkość liter

Obsługiwane języki

Ukraiński, angielski, rosyjski, polski, rumuński, hiszpański, niemiecki, francuski, włoski, portugalski, holenderski, turecki, arabski, hebrajski, hindi, chiński, japoński, koreański, wietnamski

Parametry

ParametrWpiszWymaganeOpis
Identyfikator szablonuciąg znaków (UUID)TakIdentyfikator szablonu
język szablonuciągTakKod języka ISO
Param szablonuobiektTakZmienne pasujące do szablonu

Przykład

Przykład hasła jednorazowego Viber

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

Przykład szablonu: „Twój kod: 123456. Ważny przez 10 minut. Nigdy nie udostępniaj tego kodu”.

Obsługiwane szablony i walidacje

Viber oferuje predefiniowane i ściśle kontrolowane szablony. Przekazane parametry zmiennych muszą odpowiadać właściwym typom danych.

Typy danych:

  • NUMER: Tylko cyfry [0-9], +, - i .. Symbole takie jak / lub białe znaki nie są obsługiwane.
  • TEKST: Alfabet dowolnego języka, symbole (@#$%^&*().,<>;:!\"'+=-()[]{} \n itp.).
  • Regularne mapowanie: Sekwencja <liter> nie może sąsiadować z sekwencją <liczba>; wymagają oddzielenia białymi znakami. Podwójne białe znaki “ wewnątrz szablonów są generalnie zabronione. W przypadku linków unikaj spacji, jeśli przekraczają limity.

Poniżej znajduje się 9 standardowych szablonów ISO. Wymień identyfikatory w oparciu o wymagania rejestracyjne w określonych krajach. Skontaktuj się z pomocą techniczną, jeśli dodasz dodatkowe języki.

1. „TYLKO kod (dowolny PIN)”

Wymagania: Obsługuje kody PIN zawierające cyfry i litery angielskie oraz symbole - lub .. Szablon wymaga sformatowania, aby prawidłowo wyświetlać Twoją markę obok weryfikacyjnego kodu PIN.

2. „Akcja: Użyj tego kodu”

Parametry: {pin} (NUMER lub TEKST) Przykładowy format: „W celu weryfikacji użyj tego kodu {pin}.”

3. „Rejestracja marki/dostęp”

Parametry: {business_platform_name} (TEKST), {pin} (NUMER lub TEKST) Przykładowy format: „Twój kod dla {business_platform_name} to {pin}”.

4. „Termin sprawdzania poprawności kodu”

Parametry: {pin} (NUMBER/TEKST), {code_validity_time} (NUMBER) Przykładowy format: „Twój kod weryfikacyjny to {pin}. Jest ważny przez {code_validity_time} minut.”

5. „Dostęp do marki i weryfikacja kodu”

Parametry: {business_platform_name} (TEKST), {pin} (NUMBER/TEKST), {code_validity_time} (NUMBER) Przykładowy format: „Kod weryfikacyjny {business_platform_name} jest {pin} ważny przez {code_validity_time} minut”.

(Uwaga: istnieje do 9 predefiniowanych bloków strukturalnych dla standardowych reguł OTP Viber opartych na kombinacjach użycia „pin”, „nazwa_platformy_biznesowej” i „czas_ważności_kodu”).

Wymagania ogólne

Wszystkie typy wiadomości Viber wymagają:

  • od: Alfanumeryczny identyfikator nadawcy
  • do: Numer telefonu w formacie E.164
  • type: Identyfikator typu wiadomości
  • ttl: Czas ważności wiadomości w sekundach (zalecane)

Powrót do SMS-ów

Wszystkie typy wiadomości Viber obsługują zastępcze wiadomości SMS wykorzystujące blok tablicy „rezerwy”. Jeśli dostarczenie Vibera nie powiedzie się, wiadomość automatycznie powróci do alternatywnych skonfigurowanych kanałów.

Promocja Vibera -> Awaryjna wiadomość 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
        }
      ]
    }
  ]
}

Ankieta Vibera -> Awaryjna wiadomość 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 -> Awaryjna wiadomość 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
        }
      ]
    }
  ]
}

Najlepsze praktyki

Obrazy

  • Użyj formatu JPG lub PNG
  • Zalecany rozmiar: 800x600 pikseli
  • Utrzymuj rozmiar pliku poniżej 1MB
  • Używaj adresów URL HTTPS

Filmy

  • Użyj formatu MP4
  • Utrzymuj rozmiar pliku poniżej 10MB
  • Dołącz obraz miniatury
  • Określ czas trwania i rozmiar pliku

Przyciski

  • Zachowaj krótki tekst przycisku (2-3 słowa)
  • Używaj jasnych wezwań do działania
  • Zawsze używaj adresów URL HTTPS
  • Testuj adresy URL przed wysłaniem

TTL (czas życia)

  • Wiadomości promocyjne: 24-72 godziny
  • Wiadomości transakcyjne: 24 godziny
  • Wiadomości OTP: 5-10 minut
  • Ankiety: 7-30 dni

Następne kroki

– Wiadomości SMS – Dowiedz się o zastępczych wiadomościach SMS