Přeskočit obsah

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 Účel Rich Media Interaktivní
viber_promo Marketingové kampaně ✅ Obrázky, videa ✅ Tlačítka
viber_trans Oznámení o transakcích ✅ PDF ❌
viber_carousel Prezentace produktů ✅ Obrázky ✅ Více tlačítek
viber_survey Ankety a zpětná vazba ❌ ✅ Více možností
viber_otp Jednorá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

Parametr Typ Povinné Popis
img řetězec Ne URL obrázku
video řetězec Ne URL souboru videa
"miniatura" řetězec Ne Náhled videa
buttonText řetězec Ne Štítek tlačítka s výzvou k akci
"tlačítkoAkce" řetězec Ne Cílová adresa URL pro kliknutí na tlačítko
velikost souboru celé číslo Ne Velikost souboru videa v bajtech
"trvání" celé číslo Ne Dé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

Parametr Typ Povinné Popis
fileUrl řetězec Ne URL dokumentu PDF
název souboru řetězec Ne Zobrazovaný název pro přílohu
fileType řetězec Ne Typ 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

Parametr Typ Povinné Popis
"kolotoč" pole Ano Pole položek karuselu
"položky" pole Ano Jednotlivé 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

Parametr Typ Povinné Popis
"průzkum" objekt Ano Průzkumný kontejner
"možnosti" pole Ano Pole 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

Parametr Typ Povinné Popis
templateId řetězec (UUID) Ano Identifikátor šablony
"templateLang" řetězec Ano Kód jazyka ISO
templateParams objekt Ano Promě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 - Zprávy RCS - Bohaté komunikační služby - Kontrola stavu - Sledovat stav doručení