Preskoči na sadržaj

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 ❌ ❌

Viber Promo

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

Tekst + slika + primjer gumba

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

Primjer videozapisa + teksta + gumba

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

Viber Promo -> SMS rezervni

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