Preskočiť na obsah

Správy Viber

SMSBAT API podporuje viacero typov správ Viber pre rôzne prípady použitia, od propagačných kampaní až po oznámenia o transakciách.

Prehľad typov správ

Typ Účel Rich Media Interaktívne
viber_promo Marketingové kampane ✅ Obrázky, videá ✅ Gombíky
viber_trans Oznámenia o transakciách ✅ PDF ❌
viber_carousel Vitríny produktov ✅ Obrázky ✅ Viaceré tlačidlá
viber_survey Ankety a spätná väzba ❌ ✅ Viac možností
viber_otp Jednorazové heslá ❌ ❌

Viber Promo

Propagačné správy s multimediálnou podporou pre marketingové kampane.

Podporovaný obsah

  • Iba obrázok
  • Len text
  • Text + tlačidlo
  • Obrázok + text + tlačidlo
  • Video + text
  • Video + text + tlačidlo
  • Len video

Parametre

Parameter Typ povinné Popis
"img" reťazec Nie Adresa URL obrázka
"video" reťazec Nie URL súboru videa
"miniatúra" reťazec Nie Náhľad videa
buttonText reťazec Nie Označenie tlačidla výzvy na akciu
"tlačidloAkcia" reťazec Nie Cieľová adresa URL na kliknutie na tlačidlo
"veľkosť súboru" celé číslo Nie Veľkosť súboru videa v bajtoch
"trvanie" celé číslo Nie Dĺžka videa v sekundách

Príklady

Text + obrázok + tlačidlo

Príklad textu + obrázka + tlačidla

{
  "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 + tlačidlo

Príklad videa + textu + tlačidla

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

Iba obrázok

Príklad iba obrázka

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

Iba text

Príklad iba textu

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

Iba video

Príklad iba videa

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

Príklad videa + textu

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

Oznámenia o transakciách pre časovo citlivé informácie, ako sú potvrdenia objednávok a potvrdenky.

Podporovaný obsah

  • Len text
  • PDF súbor + text
  • Len súbor PDF

Parametre

Parameter Typ povinné Popis
fileUrl reťazec Nie URL dokumentu PDF
názov súboru reťazec Nie Zobrazovaný názov prílohy
"typ súboru" reťazec Nie Typ súboru (použite "pdf")

Príklady

Iba text

Príklad iba textu

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

Text + PDF

Príklad textu + 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
}

Iba PDF

Iba PDF príklad

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

Viacpoložková prehliadateľná vitrína produktov alebo obsahu.

Štruktúra

Pole položiek karuselu, z ktorých každá obsahuje:

  • Názov
  • Obrázok
  • Hlavné tlačidlo (hlavná akcia)
  • Sekundárne tlačidlo (alternatívna akcia)

Parametre

Parameter Typ povinné Popis
"kolotoč" pole áno Pole položiek karuselu
"položky" pole áno Jednotlivé kartové predmety

Príklad

Príklad Viber Carousel

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

Prieskum Viber

Interaktívne prieskumy a zber spätnej väzby s možnosťou výberu z viacerých možností.

Parametre

Parameter Typ povinné Popis
"prieskum" objekt áno Prieskumný kontajner
"možnosti" pole áno Pole 1-5 odpovedí

Obmedzenia

  • Podporovaných je maximálne 5 možností odozvy
  • Každá možnosť by mala byť stručná (odporúčané: menej ako 30 znakov)

Príklad

Príklad prieskumu 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

Doručenie jednorazového hesla s preddefinovanými šablónami.

Kľúčové vlastnosti

  • 9 preddefinovaných šablón
  • Overenie parametrov (typy TEXT, NUMBER)
  • Podpora viacerých jazykov (19 jazykov)
  • V názvoch premenných sa rozlišujú malé a veľké písmená

Podporované jazyky

Ukrajinčina, angličtina, ruština, poľština, rumunčina, španielčina, nemčina, francúzština, taliančina, portugalčina, holandčina, turečtina, arabčina, hebrejčina, hindčina, čínština, japončina, kórejčina, vietnamčina

Parametre

Parameter Typ povinné Popis
templateId reťazec (UUID) áno Identifikátor šablóny
"templateLang" reťazec áno Kód jazyka ISO
"templateParams" objekt áno Premenné zodpovedajúce šablóne

Príklad

Príklad 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
}

Príklad šablóny: "Váš kód: 123456. Platí 10 minút. Tento kód nikdy nezdieľajte."

Podporované šablóny a overenia

Viber ponúka preddefinované a prísne kontrolované šablóny. Odovzdané parametre premenných musia zodpovedať správnym typom údajov.

Typy údajov: - NUMBER: Iba číslice [0-9], +, - a.. Symboly ako / alebo medzery nie sú podporované. - TEXT: Akákoľvek abeceda jazyka, symboly (@#$%^&*().,<>;:!\"'+=-()[]{} \n atď.). - Bežné mapovanie: Sekvencia „“ nemôže susediť so sekvenciou „<číslo>“; vyžadujú oddelenie medzier. Dvojité medzery vo vnútri šablón sú vo všeobecnosti zakázané. V prípade odkazov sa vyhnite medzerám, ak prekračujú limity.

Nižšie je uvedených 9 štandardných ISO šablón. Nahraďte ID na základe vašich požiadaviek na registráciu v konkrétnych krajinách. Ak pridávate ďalšie jazyky, kontaktujte podporu.

1. „LEN kód (akýkoľvek PIN)“

Požiadavky: Podporuje kódy PIN v číslach a anglických písmenách, symboly „-“ alebo „.“. Šablóna vyžaduje formátovanie na správne zobrazenie vašej značky spolu s overovacím kódom PIN.

2. „Akcia: Použite tento kód“

Parametre: {pin} (ČÍSLO alebo TEXT) Príklad formátu: „Na overenie použite tento kód {pin}.“

3. „Registrácia značky/prístup“

Parametre: {business_platform_name} (TEXT), {pin} (NUMBER alebo TEXT) Príklad formátu: „Váš kód pre {business_platform_name} je {pin}.“

4. „Časovanie overenia kódu“

Parametre: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Príklad formátu: „Váš overovací kód je {pin}. Platí {code_validity_time} min.“

5. „Prístup k značke a overenie kódu“

Parametre: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Príklad formátu: „Verifikačný kód {business_platform_name} je {pin} platný po dobu {code_validity_time} minút.“

(Poznámka: Pre štandardné pravidlá OTP Viber existuje až 9 preddefinovaných štrukturálnych blokov založených na kombináciách použitia pin, business_platform_name a code_validity_time).

Všeobecné požiadavky

Všetky typy správ Viber vyžadujú:

  • from: Alfanumerické ID odosielateľa
  • to: Telefónne číslo vo formáte E.164
  • type: Identifikátor typu správy
  • ttl: čas vypršania platnosti správy v sekundách (odporúča sa)

Náhrada na SMS

Všetky typy správ Viber podporujú núdzové SMS s využitím bloku poľa „fallbacks“. Ak doručenie Viber zlyhá, správa sa automaticky vráti späť na alternatívne nakonfigurované kanály.

Viber Promo -> SMS Fallback

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

Prieskum Viber -> Záložná 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 -> Záložná 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
        }
      ]
    }
  ]
}

Osvedčené postupy

Obrázky

  • Použite formát JPG alebo PNG
  • Odporúčaná veľkosť: 800 x 600 pixelov
  • Udržujte veľkosť súboru pod 1 MB
  • Používajte adresy URL HTTPS

Videá

  • Použite formát MP4
  • Udržujte veľkosť súboru pod 10 MB
  • Zahrňte miniatúrny obrázok
  • Zadajte trvanie a veľkosť súboru

Tlačidlá

  • Text tlačidla udržujte krátky (2-3 slová)
  • Používajte jasné frázy s výzvou na akciu – Vždy používajte adresy URL HTTPS
  • Pred odoslaním otestujte adresy URL

TTL (Time-to-Live)

  • Propagačné správy: 24-72 hodín
  • Transakčné správy: 24 hodín
  • OTP správy: 5-10 minút
  • Prieskumy: 7-30 dní

Ďalšie kroky

– SMS správy – Prečítajte si o záložných správach SMS - Správy RCS - Rozšírené komunikačné služby - Skontrolovať stav - Sledujte stav doručenia