Pereiti prie turinio

Viber žinutės

SMSBAT API palaiko kelių tipų Viber pranešimus įvairiems naudojimo atvejams, nuo reklaminių kampanijų iki pranešimų apie operaciją.

Pranešimų tipų apžvalga

Tipas Paskirtis Raiškioji medija Interaktyvus
viber_promo Rinkodaros kampanijos ✅ Vaizdai, vaizdo įrašai ✅ Mygtukai
„viber_trans“ Pranešimai apie sandorius ✅ PDF ❌
viber_carousel Prekių vitrinos ✅ Vaizdai ✅ Keli mygtukai
viber_survey Apklausos ir atsiliepimai ❌ ✅ Keli pasirinkimai
viber_otp Vienkartiniai slaptažodžiai ❌ ❌

Viber reklama

Reklaminiai pranešimai su raiškiosios medijos palaikymu rinkodaros kampanijoms.

Palaikomas turinys

– Tik vaizdas – Tik tekstas - Teksto + mygtukas - Vaizdas + tekstas + mygtukas - Vaizdo įrašas + tekstas - Vaizdo įrašas + tekstas + mygtukas – Tik vaizdo įrašas

Parametrai

Parametras Tipas Reikalingas Aprašymas
"img" styga Ne Vaizdo URL
"vaizdo įrašas" styga Ne Vaizdo įrašo failo URL
"miniatiūra" styga Ne Vaizdo įrašo peržiūros vaizdas
buttonText styga Ne Raginimo veikti mygtuko etiketė
"mygtuko veiksmas" styga Ne Mygtuko paspaudimas URL paskirties vieta
„failo dydis“ sveikasis skaičius Ne Vaizdo įrašo failo dydis baitais
"trukmė" sveikasis skaičius Ne Vaizdo įrašo trukmė sekundėmis

Pavyzdžiai

Tekstas + vaizdas + mygtukas

Tekstas + vaizdas + mygtuko pavyzdys

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

Vaizdo įrašas + tekstas + mygtukas

Vaizdo įrašas + tekstas + mygtuko pavyzdys

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

Tik vaizdas

Tik vaizdo pavyzdys

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

Tik tekstas

Tik teksto pavyzdys

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

Tik vaizdo įrašas

Tik vaizdo įrašo pavyzdys

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Vaizdo įrašas + tekstas

Vaizdo įrašas + teksto pavyzdys

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

Operacijų pranešimai, skirti informacijai, kuriai svarbus laikas, pvz., užsakymų patvirtinimai ir kvitai.

Palaikomas turinys

– Tik tekstas - PDF failas + tekstas - Tik PDF failas

Parametrai

Parametras Tipas Reikalingas Aprašymas
„fileUrl“ styga Ne PDF dokumento URL
„failo pavadinimas“ styga Ne Rodomas priedo pavadinimas
„failo tipas“ styga Ne Failo tipas (naudokite „pdf“)

Pavyzdžiai

Tik tekstas

Tik teksto pavyzdys

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

Tekstas + PDF

Tekstas + PDF pavyzdys

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

Tik PDF

Tik PDF pavyzdys

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

Viber karuselė

Produktų ar turinio vitrina, kurioje galima naršyti kelis elementus.

Struktūra

Karuselės elementų rinkinys, kurių kiekviename yra:

  • Pavadinimas
  • Vaizdas
  • Pagrindinis mygtukas (pagrindinis veiksmas)
  • Antrinis mygtukas (alternatyvus veiksmas)

Parametrai

Parametras Tipas Reikalingas Aprašymas
karuselė masyvas Taip Karuselės prekių masyvas
"daiktai" masyvas Taip Atskiri kortelių objektai

Pavyzdys

Viber karuselės pavyzdys

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

Interaktyvios apklausos ir atsiliepimų rinkimas su kelių pasirinkimų parinktimis.

Parametrai

Parametras Tipas Reikalingas Aprašymas
"apklausa" objektas Taip Apžiūros konteineris
"parinktys" masyvas Taip 1–5 atsakymų pasirinkimas

Apribojimai

  • Palaikomos daugiausia 5 atsakymo parinktys
  • Kiekviena parinktis turi būti glausta (rekomenduojama: mažiau nei 30 simbolių)

Pavyzdys

Viber apklausos pavyzdys

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

Vienkartinis slaptažodžio pristatymas su iš anksto nustatytais šablonais.

Pagrindinės funkcijos

  • 9 iš anksto nustatyti šablonai – Parametrų patvirtinimas (TEXT, NUMBER tipai)
  • Kelių kalbų palaikymas (19 kalbų) – Didžiosios ir mažosios raidės skiriamos kintamųjų pavadinimams

Palaikomos kalbos

ukrainiečių, anglų, rusų, lenkų, rumunų, ispanų, vokiečių, prancūzų, italų, portugalų, olandų, turkų, arabų, hebrajų, hindi, kinų, japonų, korėjiečių, vietnamiečių

Parametrai

Parametras Tipas Reikalingas Aprašymas
templateId eilutė (UUID) Taip Šablono identifikatorius
templateLang styga Taip ISO kalbos kodas
templateParams objektas Taip Kintamieji, atitinkantys šabloną

Pavyzdys

Viber OTP pavyzdys

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

Šablono pavyzdys: "Jūsų kodas: 123456. Galioja 10 minučių. Niekada nesidalykite šiuo kodu."

Palaikomi šablonai ir patvirtinimai

Viber siūlo iš anksto nustatytus ir griežtai kontroliuojamus šablonus. Perduotų kintamųjų parametrai turi atitikti teisingus duomenų tipus.

Duomenų tipai: - SKAIČIUS: tik skaitmenys „[0–9]“, „+“, „-“ ir „.“. Tokie simboliai kaip „/“ arba tarpai nepalaikomi. - TEKSTAS: bet kokia kalbos abėcėlė, simboliai (@#$%^&*().,<>;:!\"'+=-()[]{} \n ir tt). – Įprastas susiejimas: „“ seka negali egzistuoti šalia „“ sekos; jiems reikia atskirti tarpų. Dvigubi tarpai `` šablonų viduje paprastai draudžiami. Nuorodoms venkite tarpų, jei jie viršija ribas.

Žemiau yra 9 standartiniai ISO šablonai. Pakeiskite ID pagal jūsų registracijos reikalavimus konkrečiose šalyse. Jei norite pridėti papildomų kalbų, susisiekite su palaikymo komanda.

1. "TIK kodas (bet koks PIN kodas)"

Reikalavimai: palaiko PIN kodus skaitmenimis ir angliškomis raidėmis, simboliais „-“ arba „.“. Šabloną reikia formatuoti, kad jūsų prekės ženklas būtų tinkamai rodomas kartu su patvirtinimo PIN kodu.

2. "Veiksmas: naudokite šį kodą"

Parametrai: {pin} (SKAIČIUS arba TEKSTAS) Formato pavyzdys: „Patvirtinimui naudokite šį kodą {pin}“.

3. „Prekės ženklo registracija / prieiga“

Parametrai: „{business_platform_name}“ (TEXT), „{pin}“ (NUMERIS arba TEKSTAS) Formato pavyzdys: „Jūsų {business_platform_name} kodas yra {pin}“.

4. „Kodo patvirtinimo laikas“

Parametrai: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Formato pavyzdys: „Jūsų patvirtinimo kodas yra {pin}. Jis galioja {code_validity_time} minutes.

5. „Prekės ženklo prieiga ir kodo patvirtinimas“

Parametrai: „{business_platform_name}“ (TEKSTAS), „{pin}“ (NUMBER/TEXT), „{code_validity_time}“ (SKAIČIUS) Formato pavyzdys: „{business_platform_name} patvirtinimo kodas galioja {pin} {code_validity_time} minutes“.

(Pastaba: Viber standartinėms OTP taisyklėms yra iki 9 iš anksto nustatytų struktūrinių blokų, pagrįstų „pin“, „business_platform_name“ ir „code_validity_time“ deriniais).

Bendrieji reikalavimai

Visiems Viber pranešimų tipams reikia:

  • „nuo“: raidinis ir skaitinis siuntėjo ID
  • „Kam“: telefono numeris E.164 formatu
  • "type": pranešimo tipo identifikatorius
  • „ttl“: pranešimo galiojimo laikas sekundėmis (rekomenduojama)

Atsarginė SMS žinutė

Visi „Viber“ pranešimų tipai palaiko atsargines SMS žinutes naudojant „atsarginių“ masyvo bloką. Jei Viber pristatymas nepavyksta, pranešimas automatiškai grįžta į alternatyvius sukonfigūruotus kanalus.

Viber Promo -> SMS atsarginis

{
  "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 Survey -> SMS atsarginis

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

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

Geriausia praktika

Vaizdai

  • Naudokite JPG arba PNG formatą
  • Rekomenduojamas dydis: 800x600 pikselių
  • Laikykite failo dydį iki 1 MB
  • Naudokite HTTPS URL

Vaizdo įrašai

  • Naudokite MP4 formatą
  • Laikykite failo dydį iki 10 MB
  • Įtraukti miniatiūrą
  • Nurodykite trukmę ir failo dydį

Mygtukai

  • Mygtuko tekstas turi būti trumpas (2–3 žodžiai)
  • Naudokite aiškias raginimo veikti frazes – Visada naudokite HTTPS URL
  • Prieš siųsdami patikrinkite URL

TTL (gyvenimo laikas)

  • Reklaminiai pranešimai: 24-72 val
  • Operacijų pranešimai: 24 valandos
  • Vienkartiniai pranešimai: 5-10 minučių
  • Apklausos: 7-30 dienų

Kiti žingsniai

– SMS žinutės – Sužinokite apie atsargines SMS žinutes – RCS pranešimai – turtingos komunikacijos paslaugos – Patikrinti būseną – Stebėti pristatymo būseną