Help Center Viber poruke

Viber poruke

SMSBAT API podržava više vrsta Viber poruka za različite slučajeve upotrebe, od promotivnih kampanja do obavijesti o transakcijama.

Pregled vrsta poruka

Upišite	Svrha	Bogati mediji	Interaktivno
`viber_promo`	Marketinške kampanje	✅ Slike, Video	✅ Gumbi
`viber_trans`	Transakcijske obavijesti	✅ PDF-ovi	❌
`viber_vrtuljak`	Vitrine proizvoda	✅ Slike	✅ Višestruki gumbi
`viber_anketa`	Ankete i povratne informacije	❌	✅ Više opcija
`viber_otp`	Jednokratne lozinke	❌	❌

Promotivne poruke s bogatom medijskom podrškom za marketinške kampanje.

Podržani sadržaj

Samo slika
Samo tekst
Tekst + gumb
Slika + tekst + gumb
Video + tekst
Video + tekst + gumb
Samo video

Parametri

Parametar	Upišite	Obavezno	Opis
`img`	niz	Ne	URL slike
`video`	niz	Ne	URL video datoteke
`sličica`	niz	Ne	Video pregled slike
`gumbTekst`	niz	Ne	Oznaka gumba poziva na radnju
`gumbAkcija`	niz	Ne	Odredište URL-a klika na gumb
`veličina datoteke`	cijeli broj	Ne	Veličina video datoteke u bajtovima
`trajanje`	cijeli broj	Ne	Trajanje videozapisa u sekundama

Primjeri

Tekst + Slika + Gumb

{
  "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 + Tekst + Gumb

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

Samo slika

Primjer samo slike

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

Samo tekst

Primjer samo teksta

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

Samo video

Primjer samo videozapisa

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

Primjer videozapisa + teksta

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

Obavijesti o transakcijama za vremenski osjetljive informacije poput potvrda narudžbi i računa.

Podržani sadržaj

Samo tekst
PDF datoteka + tekst
Samo PDF datoteka

Parametri

Parametar	Upišite	Obavezno	Opis
`fileUrl`	niz	Ne	URL PDF dokumenta
`naziv datoteke`	niz	Ne	Ime za prikaz za privitak
`vrsta datoteke`	niz	Ne	Vrsta datoteke (koristite “pdf”)

Primjeri

Samo tekst

Primjer samo teksta

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

Tekst + PDF

Tekst + primjer PDF-a

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

Samo PDF

Primjer samo u PDF-u

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

Viber vrtuljak

Izlog proizvoda ili sadržaja koji se može pregledavati s više stavki.

Struktura

Niz stavki vrtuljka, od kojih svaka sadrži:

Naslov
Slika
Primarni gumb (glavna radnja)
Sekundarni gumb (alternativna radnja)

Parametri

Parametar	Upišite	Obavezno	Opis
`vrtuljak`	niz	Da	Niz stavki vrtuljka
`stavke`	niz	Da	Pojedinačni objekti kartice

Primjer

Primjer Viber vrtuljka

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

Interaktivne ankete i prikupljanje povratnih informacija s više opcija izbora.

Parametri

Parametar	Upišite	Obavezno	Opis
`anketa`	objekt	Da	Anketni spremnik
`opcije`	niz	Da	Niz od 1-5 odgovora

Ograničenja

Podržano je najviše 5 opcija odgovora
Svaka opcija treba biti sažeta (preporučeno: manje od 30 znakova)

Primjer

Primjer Viber ankete

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

Isporuka jednokratne lozinke s unaprijed definiranim predlošcima.

Ključne značajke

9 unaprijed definiranih predložaka
Validacija parametra (TEKST, NUMBER vrsta)
Višejezična podrška (19 jezika)
Nazivi varijabli koji razlikuju velika i mala slova

Podržani jezici

Ukrajinski, engleski, ruski, poljski, rumunjski, španjolski, njemački, francuski, talijanski, portugalski, nizozemski, turski, arapski, hebrejski, hindi, kineski, japanski, korejski, vijetnamski

Parametri

Parametar	Upišite	Obavezno	Opis
`templateId`	niz (UUID)	Da	Identifikator predloška
`jezik predloška`	niz	Da	ISO kod jezika
`Parametri predloška`	objekt	Da	Predložak za podudaranje varijabli

Primjer

Viber OTP primjer

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

Primjer predloška: “Vaš kod: 123456. Vrijedi 10 minuta. Nikada nemojte dijeliti ovaj kod.”

Podržani predlošci i provjere valjanosti

Viber nudi unaprijed definirane i strogo kontrolirane predloške. Proslijeđeni parametri varijabli moraju odgovarati ispravnim tipovima podataka.

Vrste podataka:

BROJ: Samo brojevi [0-9], +, - i .. Simboli poput / ili razmak nisu podržani.
TEKST: abeceda bilo kojeg jezika, simboli (@#$%^&*().,<>;:!\"'+=-()[]{} \n itd.).
Uobičajeno preslikavanje: niz <slova> ne može postojati pored niza <broj>; zahtijevaju odvajanje razmaka. Dvostruki razmaci unutar predložaka općenito su zabranjeni. Za veze izbjegavajte razmake ako premašuju ograničenja.

Ispod je 9 standardnih ISO predložaka. Zamijenite ID-ove na temelju vaših zahtjeva za registraciju u određenim zemljama. Kontaktirajte podršku ako dodajete dodatne jezike.

1. “SAMO kod (Bilo koji PIN)”

Zahtjevi: Podržava PIN-ove u brojevima i engleskim slovima, simbole - ili .. Predložak zahtijeva formatiranje kako bi pravilno prikazao vašu marku uz PIN za provjeru.

2. “Radnja: upotrijebite ovaj kod”

Parametri: {pin} (BROJ ili TEKST) Primjer formata: “Molimo upotrijebite ovaj kod {pin} za potvrdu.”

3. “Registracija robne marke/pristup”

Parametri: {business_platform_name} (TEKST), {pin} (BROJ ili TEKST) Primjer formata: “Vaš kod za {business_platform_name} je {pin}.“

4. “Vrijeme provjere koda”

Parametri: {pin} (BROJ/TEKST), {code_validity_time} (BROJ) Primjer formata: “Vaš kontrolni kod je {pin}. Vrijedi {code_validity_time} minuta.”

5. “Pristup marki i provjera koda”

Parametri: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Primjer formata: “{business_platform_name} kontrolni kod je {pin} valjan {code_validity_time} minuta.”

(Napomena: Postoji do 9 unaprijed definiranih strukturnih blokova za Viber standardna OTP pravila temeljena na kombinacijama korištenja pin, business_platform_name i code_validity_time).

Opći zahtjevi

Sve vrste Viber poruka zahtijevaju:

od: Alfanumerički ID pošiljatelja
za: telefonski broj u formatu E.164
type: Identifikator vrste poruke
ttl: Vrijeme isteka poruke u sekundama (preporučeno)

Povratak na SMS

Sve vrste poruka na Viberu podržavaju povratne SMS-ove korištenjem bloka niza zamjenskih poruka. Ako Viber isporuka ne uspije, poruka se automatski vraća na alternativne konfigurirane kanale.

{
  "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 anketa -> SMS rezervni

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

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

Najbolji primjeri iz prakse

Slike

Koristite JPG ili PNG format
Preporučena veličina: 800x600 piksela
Neka veličina datoteke bude ispod 1 MB
Koristite HTTPS URL-ove

Videozapisi

Koristite MP4 format
Neka veličina datoteke bude ispod 10 MB
Uključite minijaturnu sliku
Navedite trajanje i veličinu datoteke

Gumbi

Neka tekst gumba bude kratak (2-3 riječi)
Koristite jasne fraze poziva na radnju
Uvijek koristite HTTPS URL-ove
Testirajte URL-ove prije slanja

TTL (Time-to-Live)

Promotivne poruke: 24-72 sata
Transakcijske poruke: 24 sata
OTP poruke: 5-10 minuta
Ankete: 7-30 dana

Sljedeći koraci

SMS poruke - Saznajte više o rezervnim SMS-ovima
RCS poruke - Bogate komunikacijske usluge
Provjeri status - Pratite status isporuke

Search Results

Viber poruke

Pregled vrsta poruka

Viber Promo

Podržani sadržaj

Parametri

Primjeri

Tekst + Slika + Gumb

Video + Tekst + Gumb

Samo slika

Samo tekst

Samo video

Video + Tekst

Viber Transactional

Podržani sadržaj

Parametri

Primjeri

Samo tekst

Tekst + PDF

Samo PDF

Viber vrtuljak

Struktura

Parametri

Primjer

Viber Anketa

Parametri

Ograničenja

Primjer

Viber OTP

Ključne značajke

Podržani jezici

Parametri

Primjer

Podržani predlošci i provjere valjanosti

1. “SAMO kod (Bilo koji PIN)”

2. “Radnja: upotrijebite ovaj kod”

3. “Registracija robne marke/pristup”

4. “Vrijeme provjere koda”

5. “Pristup marki i provjera koda”

Opći zahtjevi

Povratak na SMS

Viber Promo -> SMS rezervni

Viber anketa -> SMS rezervni

Viber Trans -> SMS rezervni

Najbolji primjeri iz prakse

Slike

Videozapisi

Gumbi

TTL (Time-to-Live)

Sljedeći koraci