Mesaje Viber

API-ul SMSBAT acceptă mai multe tipuri de mesaje Viber pentru diferite cazuri de utilizare, de la campanii promoționale la notificări ale tranzacțiilor.

Prezentare generală a tipurilor de mesaje

Tip	Scop	Rich Media	Interactiv
`viber_promo`	Campanii de marketing	✅ Imagini, Videoclipuri	✅ Butoane
`viber_trans`	Notificări tranzacționale	✅ PDF-uri	❌
`viber_carusel`	Vitrine de produse	✅ Imagini	✅ Butoane multiple
`viber_survey`	Sondaje și feedback	❌	✅ Opțiuni multiple
`viber_otp`	Parole unice	❌	❌

Promoție Viber

Mesaje promoționale cu suport media bogat pentru campanii de marketing.

Conținut acceptat

Doar imagine
Doar text
Buton text +
Imagine + text + buton
Video + text
Video + text + buton
Numai video

Parametri

Parametru	Tip	Necesar	Descriere
`img`	șir	Nu	Adresa URL a imaginii
`video`	șir	Nu	Adresa URL a fișierului video
`miniatură`	șir	Nu	Imagine de previzualizare video
`buttonText`	șir	Nu	Eticheta butonului îndemn la acțiune
`buttonAction`	șir	Nu	Faceți clic pe butonul URL destinație
`fileSize`	întreg	Nu	Dimensiunea fișierului video în octeți
`durata`	întreg	Nu	Durata videoclipului în secunde

Exemple

Text + Imagine + Buton

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

Video + Text + Buton

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

Numai imagine

Exemplu numai pentru imagine

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

Numai text

Exemplu numai text

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

Numai video

Exemplu doar video

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

Video + Text

Exemplu video + text

{
  "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 tranzacțional

Notificări de tranzacție pentru informații sensibile la timp, cum ar fi confirmările de comandă și chitanțele.

Conținut acceptat

Doar text
Fișier PDF + text
Numai fișier PDF

Parametri

Parametru	Tip	Necesar	Descriere
`fileUrl`	șir	Nu	URL document PDF
`fileName`	șir	Nu	Numele afișat pentru atașament
`fileType`	șir	Nu	Tip de fișier (utilizați „pdf”)

Exemple

Numai text

Exemplu numai text

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

Text + PDF

Text + Exemplu 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
}

Numai PDF

Exemplu numai 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 Carusel

Prezentare navigabilă cu mai multe articole pentru produse sau conținut.

Structura

Gamă de articole carusel, fiecare conținând:

Titlu
Imagine
Butonul principal (acțiunea principală)
Buton secundar (acțiune alternativă)

Parametri

Parametru	Tip	Necesar	Descriere
`carusel`	matrice	Da	Gamă de articole carusel
`articole`	matrice	Da	Obiecte card individuale

Exemplu

Exemplu de carusel 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"
          }
        }
      ]
    }
  }
}

Sondaj Viber

Sondaje interactive și colectare de feedback cu opțiuni multiple.

Parametri

Parametru	Tip	Necesar	Descriere
`sondaj`	obiect	Da	Container de sondaj
`opțiuni`	matrice	Da	Matrice de 1-5 variante de răspuns

Constrângeri

Maximum 5 opțiuni de răspuns acceptate
Fiecare opțiune trebuie să fie concisă (recomandat: sub 30 de caractere)

Exemplu

Exemplu de sondaj 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

Livrare unică a parolei cu șabloane predefinite.

Caracteristici cheie

9 șabloane predefinite
Validarea parametrilor (tipuri TEXT, NUMBER)
Suport în mai multe limbi (19 limbi)
Nume de variabile sensibile la majuscule și minuscule

Limbi acceptate

Ucraineană, engleză, rusă, poloneză, română, spaniolă, germană, franceză, italiană, portugheză, olandeză, turcă, arabă, ebraică, hindi, chineză, japoneză, coreeană, vietnameză

Parametri

Parametru	Tip	Necesar	Descriere
`templateId`	șir (UUID)	Da	Identificator șablon
`templateLang`	șir	Da	Cod de limbă ISO
`templateParams`	obiect	Da	Variabile care se potrivesc șablon

Exemplu

Exemplu 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
}

Exemplu de șablon: „Codul dvs.: 123456. Valabil timp de 10 minute. Nu distribuiți niciodată acest cod”.

Șabloane și validări acceptate

Viber oferă șabloane predefinite și strict controlate. Parametrii variabilelor trecuți trebuie să corespundă tipurilor de date corecte.

Tipuri de date: - NUMĂR: Numai cifrele [0-9], +, - și .. Simbolurile precum / sau spațiile albe nu sunt acceptate. - TEXT: alfabetul oricărei limbi, simboluri (@#$%^&*().,<>;:!\"'+=-()[]{} \n etc). - Mapare regulată: O secvență de <litere> nu poate exista adiacent unei secvențe <number>; necesită separarea spațiilor albe. Spațiile duble din interiorul șabloanelor sunt în general interzise. Pentru legături, evitați spațiile dacă depășesc limitele.

Mai jos sunt cele 9 șabloane ISO standard. Înlocuiți ID-urile în funcție de cerințele dvs. de înregistrare în anumite țări. Contactați asistența dacă adăugați limbi suplimentare.

1. „NUMAI Cod (Orice PIN)”

Cerințe: acceptă PIN-uri în cifre și litere englezești, simboluri - sau .. Șablonul necesită formatare pentru a vă afișa corect marca alături de PIN-ul de verificare.

2. „Acțiune: Vă rugăm să utilizați acest cod”

Parametri: {pin} (NUMĂR sau TEXT) Exemplu de format: „Vă rugăm să utilizați acest cod {pin} pentru verificare.”

3. „Înregistrarea mărcii/Accesul”

Parametri: {business_platform_name} (TEXT), {pin} (NUMĂR sau TEXT) Exemplu de format: „Codul dvs. pentru {business_platform_name} este {pin}”.

4. „Momentul validării codului”

Parametri: {pin} (NUMĂR/TEXT), {code_validity_time} (NUMĂR) Exemplu de format: „Codul dvs. de verificare este {pin}. Este valabil timp de {code_validity_time} minute."

5. „Accesul mărcii și validarea codului”

Parametri: {business_platform_name} (TEXT), {pin} (NUMĂR/TEXT), {code_validity_time} (NUMĂR) Exemplu de format: „Codul de verificare {business_platform_name} este {pin} valabil timp de {code_validity_time} minute.”

(Notă: există până la 9 blocuri structurale predefinite pentru regulile OTP standard Viber bazate pe combinații de utilizare a „pin”, „nume_platform_afacerii” și „cod_validitate_timp”.

Cerințe generale

Toate tipurile de mesaje Viber necesită:

de la: ID-ul expeditorului alfanumeric
to: număr de telefon în format E.164
type: identificatorul tipului de mesaj
ttl: timpul de expirare a mesajului în secunde (recomandat)

Revenire la SMS

Toate tipurile de mesaje Viber acceptă SMS-uri de rezervă utilizând blocul de matrice „fallbacks”. Dacă livrarea Viber nu reușește, mesajul revine automat la canalele configurate alternative.

Promoție Viber -> SMS de rezervă

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

Sondaj Viber -> SMS de rezervă

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

Cele mai bune practici

Imagini

Folosiți formatul JPG sau PNG
Dimensiune recomandată: 800x600 pixeli
Păstrați dimensiunea fișierului sub 1 MB
Utilizați adrese URL HTTPS

Videoclipuri

Folosiți formatul MP4
Păstrați dimensiunea fișierului sub 10 MB
Includeți imaginea în miniatură
Specificați durata și dimensiunea fișierului

Butoane

Păstrați textul butonului scurt (2-3 cuvinte)
Folosiți expresii clare de îndemn
Folosiți întotdeauna adrese URL HTTPS
Testați adresele URL înainte de a trimite

TTL (Time-to-Live)

Mesaje promotionale: 24-72 ore
Mesaje tranzacționale: 24 de ore
Mesaje OTP: 5-10 minute
Sondaje: 7-30 zile

Următorii pași

Mesaje SMS - Aflați despre alternativele SMS
RCS Messages - Servicii de comunicare bogate
Verificați starea - Urmăriți starea livrării