Help Center Zprávy Viber

Zprávy Viber

SMSBAT API podporuje několik typů zpráv Viber pro různé případy použití, od propagačních kampaní po oznámení o transakcích.

Přehled typů zpráv

TypÚčelRich MediaInteraktivní
viber_promoMarketingové kampaně✅ Obrázky, videa✅ Tlačítka
viber_transOznámení o transakcích✅ PDF❌
viber_carouselPrezentace produktů✅ Obrázky✅ Více tlačítek
viber_surveyAnkety a zpětná vazba❌✅ Více možností
viber_otpJednorázová hesla❌❌

Viber Promo

Propagační zprávy s multimediální podporou pro marketingové kampaně.

Podporovaný obsah

  • Pouze obrázek
  • Pouze text
  • Text + tlačítko
  • Obrázek + text + tlačítko
  • Video + text
  • Video + text + tlačítko
  • Pouze video

Parametry

ParametrTypPovinnéPopis
imgřetězecNeURL obrázku
videořetězecNeURL souboru videa
”miniatura”řetězecNeNáhled videa
buttonTextřetězecNeŠtítek tlačítka s výzvou k akci
”tlačítkoAkce”řetězecNeCílová adresa URL pro kliknutí na tlačítko
velikost souborucelé čísloNeVelikost souboru videa v bajtech
”trvání”celé čísloNeDélka videa v sekundách

Příklady

Text + obrázek + tlačítko

Příklad textu + obrázku + tlačítka

{
  "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čítko

Video + text + příklad tlačítka

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

Pouze obrázek

Příklad pouze obrázku

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

Pouze text

Příklad pouze textu

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

Pouze video

Příklad pouze 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

Příklad videa a 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 Transakční

Oznámení o transakcích pro časově citlivé informace, jako jsou potvrzení objednávek a účtenky.

Podporovaný obsah

  • Pouze text
  • PDF soubor + text
  • Pouze soubor PDF

Parametry

ParametrTypPovinnéPopis
fileUrlřetězecNeURL dokumentu PDF
název souboruřetězecNeZobrazovaný název pro přílohu
fileTypeřetězecNeTyp souboru (použijte “pdf”)

Příklady

Pouze text

Příklad pouze textu

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

Text + PDF

Pří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
}

Pouze PDF

Pouze příklad PDF

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

Vícepoložková prohledávatelná prezentace produktů nebo obsahu.

Struktura

Pole položek karuselu, z nichž každá obsahuje:

  • Název
  • Obrázek
  • Primární tlačítko (hlavní akce)
  • Sekundární tlačítko (alternativní akce)

Parametry

ParametrTypPovinnéPopis
”kolotoč”poleAnoPole položek karuselu
”položky”poleAnoJednotlivé objekty karet

Příklad

Pří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"
          }
        }
      ]
    }
  }
}

Průzkum Viber

Interaktivní ankety a shromažďování zpětné vazby s více možnostmi výběru.

Parametry

ParametrTypPovinnéPopis
”průzkum”objektAnoPrůzkumný kontejner
”možnosti”poleAnoPole 1-5 odpovědí

Omezení

  • Podporováno maximálně 5 možností odezvy
  • Každá možnost by měla být stručná (doporučeno: méně než 30 znaků)

Příklad

Příklad průzkumu 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čení jednorázového hesla s předdefinovanými šablonami.

Klíčové vlastnosti

  • 9 předdefinovaných šablon
  • Ověření parametrů (typy TEXT, NUMBER)
  • Podpora více jazyků (19 jazyků)
  • Názvy proměnných rozlišují malá a velká písmena

Podporované jazyky

Ukrajinština, angličtina, ruština, polština, rumunština, španělština, němčina, francouzština, italština, portugalština, holandština, turečtina, arabština, hebrejština, hindština, čínština, japonština, korejština, vietnamština

Parametry

ParametrTypPovinnéPopis
templateIdřetězec (UUID)AnoIdentifikátor šablony
”templateLang”řetězecAnoKód jazyka ISO
templateParamsobjektAnoProměnné odpovídající šabloně

Příklad

Příklad jednorázového hesla Viber

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

Příklad šablony: “Váš kód: 123456. Platí 10 minut. Tento kód nikdy nesdílejte.”

Podporované šablony a ověření

Viber nabízí předdefinované a přísně kontrolované šablony. Předávané parametry proměnných musí odpovídat správným datovým typům.

Typy dat:

  • NUMBER: Pouze číslice [0-9], +, - a .. Symboly jako / nebo mezery nejsou podporovány.
  • TEXT: Jakákoli jazyková abeceda, symboly (@#$%^&*().,<>;:!\"'+=-()[]{} \n atd.).
  • Běžné mapování: Sekvence <písmen> nemůže existovat vedle sekvence <číslo>; vyžadují oddělení mezer. Dvojité bílé znaky uvnitř šablon jsou obecně zakázány. U odkazů se vyhněte mezerám, pokud překračují limity.

Níže je uvedeno 9 standardních šablon ISO. Nahraďte ID na základě vašich registračních požadavků v konkrétních zemích. Pokud přidáváte další jazyky, kontaktujte podporu.

1. „POUZE kód (jakýkoli PIN)“

Požadavky: Podporuje kódy PIN v číslicích a anglických písmenech, symboly „-“ nebo „.“. Šablona vyžaduje formátování, aby se vaše značka správně zobrazovala spolu s ověřovacím kódem PIN.

2. “Akce: Použijte prosím tento kód”

Parametry: {pin} (ČÍSLO nebo TEXT) Příklad formátu: „Pro ověření použijte tento kód {pin}.“

3. „Registrace značky/přístup“

Parametry: {business_platform_name} (TEXT), {pin} (NUMBER nebo TEXT) Příklad formátu: “Váš kód pro {business_platform_name} je {pin}.“

4. “Časování ověření kódu”

Parametry: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Příklad formátu: „Váš ověřovací kód je {pin}. Je platný po dobu {code_validity_time} minut.”

5. „Přístup ke značce a ověření kódu“

Parametry: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Příklad formátu: „Ověřovací kód {business_platform_name} je {pin} platný po dobu {code_validity_time} minut.“

(Poznámka: Pro standardní pravidla OTP Viber existuje až 9 předdefinovaných strukturálních bloků založených na kombinacích použití pin, business_platform_name a code_validity_time).

Obecné požadavky

Všechny typy zpráv Viber vyžadují:

  • from: Alfanumerické ID odesílatele
  • to: Telefonní číslo ve formátu E.164
  • type: Identifikátor typu zprávy
  • ttl: Doba vypršení platnosti zprávy v sekundách (doporučeno)

Záloha na SMS

Všechny typy zpráv Viber podporují záložní SMS s využitím bloku pole „fallbacks“. Pokud se doručení Viber nezdaří, zpráva se automaticky vrátí zpět na alternativní 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
        }
      ]
    }
  ]
}

Průzkum 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
        }
      ]
    }
  ]
}

Nejlepší postupy

Obrázky

  • Použijte formát JPG nebo PNG
  • Doporučená velikost: 800 x 600 pixelů
  • Udržujte velikost souboru pod 1 MB
  • Používejte adresy URL HTTPS

Videa

  • Použijte formát MP4
  • Udržujte velikost souboru pod 10 MB
  • Zahrnout miniaturu obrázku
  • Zadejte dobu trvání a velikost souboru

Tlačítka

  • Udržujte text tlačítka krátký (2-3 slova)
  • Používejte jasné fráze s výzvou k akci – Vždy používejte adresy URL HTTPS
  • Před odesláním otestujte adresy URL

TTL (Time-to-Live)

  • Propagační zprávy: 24-72 hodin
  • Transakční zprávy: 24 hodin
  • OTP zprávy: 5-10 minut
  • Průzkumy: 7-30 dní

Další kroky

– Zprávy SMS – Další informace o záložních zprávách SMS