Kihagyás

Viber üzenetek

Az SMSBAT API többféle Viber-üzenetet támogat különböző felhasználási esetekben, a promóciós kampányoktól a tranzakciós értesítésekig.

Az üzenettípusok áttekintése

Típus Cél Multimédiás Interaktív
viber_promo Marketing kampányok ✅ Képek, videók ✅ Gombok
viber_trans Tranzakciós értesítések ✅ PDF ❌
viber_carousel Termékbemutatók ✅ Képek ✅ Több gomb
viber_survey Szavazások és visszajelzések ❌ ✅ Több lehetőség
viber_otp Egyszeri jelszavak ❌ ❌

Viber Promo

Promóciós üzenetek multimédiás támogatással marketingkampányokhoz.

Támogatott tartalom

  • Csak kép
  • Csak szöveg
  • Szöveg + gomb
  • Kép + szöveg + gomb
  • Videó + szöveg
  • Videó + szöveg + gomb
  • Csak videó

Paraméterek

Paraméter Típus Kötelező Leírás
"img" húr Nem Kép URL
"videó" húr Nem Videofájl URL-je
"bélyegkép" húr Nem Videó előnézeti kép
buttonText húr Nem Cselekvésre ösztönző gomb címke
"buttonAction" húr Nem Gomb kattintás URL célhely
fileSize egész Nem Videofájl mérete bájtban
"időtartam" egész Nem Videó hossza másodpercben

Példák

Szöveg + Kép + gomb

Példa szöveg + kép + gomb

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

Videó + szöveg + gomb

Videó + szöveg + gomb példa

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

Csak kép

Példa csak képre

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

Csak szöveg

Példa csak szövegre

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

Csak videó

Példa csak videóra

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

Videó + szöveg

Videó + szövegpélda

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

Tranzakciós értesítések az időérzékeny információkhoz, például a rendelési visszaigazolásokhoz és a nyugtákhoz.

Támogatott tartalom

  • Csak szöveg
  • PDF fájl + szöveg
  • Csak PDF fájl

Paraméterek

Paraméter Típus Kötelező Leírás
fileUrl húr Nem PDF dokumentum URL
fileName húr Nem Melléklet megjelenített neve
fileType húr Nem Fájltípus (használjon "pdf"-et)

Példák

Csak szöveg

Példa csak szövegre

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

Szöveg + PDF

Szöveg + PDF példa

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

Csak PDF

Példa csak PDF-ben

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

Viber körhinta

Több tételből álló, böngészhető kirakat termékekhez vagy tartalmakhoz.

Szerkezet

A körhinta elemek tömbje, amelyek mindegyike a következőket tartalmazza:

  • Cím
  • Kép
  • Elsődleges gomb (főművelet)
  • Másodlagos gomb (alternatív művelet)

Paraméterek

Paraméter Típus Kötelező Leírás
"körhinta" tömb Igen A körhinta elemek tömbje
"elemek" tömb Igen Egyedi kártyaobjektumok

Példa

Viber Carousel példa

{
  "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 felmérés

Interaktív szavazások és visszajelzések gyűjtése feleletválasztós lehetőségekkel.

Paraméterek

Paraméter Típus Kötelező Leírás
"felmérés" tárgy Igen Felmérés konténer
"opciók" tömb Igen 1-5 válaszlehetőségből álló tömb

Korlátozások

  • Maximum 5 válaszlehetőség támogatott
  • Minden opciónak tömörnek kell lennie (ajánlott: 30 karakter alatt)

Példa

Példa a Viber felmérésre

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

Egyszeri jelszókézbesítés előre meghatározott sablonokkal.

Főbb jellemzők

  • 9 előre meghatározott sablon
  • Paraméterellenőrzés (SZÖVEG, NUMBER típusú)
  • Többnyelvű támogatás (19 nyelven)
  • Kis- és nagybetűket megkülönböztető változónevek

Támogatott nyelvek

ukrán, angol, orosz, lengyel, román, spanyol, német, francia, olasz, portugál, holland, török, arab, héber, hindi, kínai, japán, koreai, vietnami

Paraméterek

Paraméter Típus Kötelező Leírás
templateId karakterlánc (UUID) Igen Sablonazonosító
templateLang húr Igen ISO nyelvkód
templateParams tárgy Igen Sablonnak megfelelő változók

Példa

Viber OTP példa

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

Példa a sablonra: "Az Ön kódja: 123456. 10 percig érvényes. Soha ne ossza meg ezt a kódot."

Támogatott sablonok és ellenőrzések

A Viber előre meghatározott és szigorúan ellenőrzött sablonokat kínál. Az átadott változók paramétereinek meg kell felelniük a megfelelő adattípusoknak.

Adattípusok: - SZÁM: Csak a [0-9], +, - és . számok. Az olyan szimbólumok, mint a / vagy a szóköz, nem támogatottak. - SZÖVEG: Bármilyen nyelvi ábécé, szimbólumok (@#$%^&*().,<>;:!\"'+=-()[]{} \n stb.). - Szabályos leképezés: „” sorozat nem létezhet „” sorozat mellett; szóközök elválasztását igénylik. A dupla szóközök `` használata a sablonokon belül általában tilos. A hivatkozásoknál kerülje a szóközt, ha túllépi a határértékeket.

Az alábbiakban a 9 szabványos ISO-sablon található. Cserélje ki az azonosítókat az adott országokban érvényes regisztrációs követelményei alapján. További nyelvek hozzáadása esetén forduljon az ügyfélszolgálathoz.

1. "CSAK kód (bármilyen PIN)"

Követelmények: Támogatja a PIN-kódokat számokkal és angol betűkkel, valamint - vagy . szimbólumokkal. A sablont formázni kell ahhoz, hogy a márka megfelelően megjelenjen az ellenőrző PIN-kód mellett.

2. "Művelet: Kérjük, használja ezt a kódot"

Paraméterek: {pin} (SZÁM vagy SZÖVEG) Példaformátum: "Kérjük, használja ezt a kódot: {pin} az ellenőrzéshez."

3. "Márkaregisztráció/Hozzáférés"

Paraméterek: "{business_platform_name}" (SZÖVEG), "{pin}" (SZÁM vagy SZÖVEG) Példaformátum: "A(z) {business_platform_name} kódja {pin}."

4. "Kódellenőrzés időzítése"

Paraméterek: "{pin}" (SZÁM/SZÖVEG), "{code_validity_time}" (NUMBER) Példaformátum: „Az Ön ellenőrző kódja: {pin}. {code_validity_time} percig érvényes."

5. "Márkahozzáférés és kódellenőrzés"

Paraméterek: "{business_platform_name}" (SZÖVEG), "{pin}" (SZÁM/SZÖVEG), "{code_validity_time}" (NUMBER) Példaformátum: „A(z) {business_platform_name} ellenőrző kód {pin} érvényes {code_validity_time} percig”.

(Megjegyzés: A Viber szabványos OTP-szabályaihoz legfeljebb 9 előre definiált szerkezeti blokk áll rendelkezésre, amelyek a „pin”, „business_platform_name” és „code_validity_time” használat kombinációin alapulnak.

Általános követelmények

Minden Viber üzenettípushoz szükség van:

  • "feladó": Alfanumerikus feladóazonosító
  • "Címzett": Telefonszám E.164 formátumban
  • type: Üzenettípus azonosító
  • "ttl": Az üzenet lejárati ideje másodpercben (ajánlott)

Visszatérés SMS-hez

Minden Viber-üzenettípus támogatja a tartalék SMS-t a "fallbacks" tömbblokk használatával. Ha a Viber kézbesítés sikertelen, az üzenet automatikusan visszatér az alternatív konfigurált csatornákra.

Viber Promo -> SMS tartalék

{
  "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 felmérés -> SMS tartalék

{
  "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 tartalék

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

Bevált gyakorlatok

Képek

  • Használjon JPG vagy PNG formátumot
  • Javasolt méret: 800x600 pixel
  • Tartsa a fájlméretet 1 MB alatt
  • Használjon HTTPS URL-eket

Videók

  • Használjon MP4 formátumot
  • Tartsa a fájlméretet 10 MB alatt
  • Indexkép szerepeltetése
  • Adja meg az időtartamot és a fájlméretet

Gombok

  • A gomb szövege legyen rövid (2-3 szó)
  • Használjon egyértelmű cselekvésre ösztönző kifejezéseket
  • Mindig HTTPS URL-eket használjon
  • Tesztelje az URL-eket küldés előtt

TTL (Time-to-Live)

  • Promóciós üzenetek: 24-72 óra
  • Tranzakciós üzenetek: 24 óra
  • OTP üzenetek: 5-10 perc
  • Felmérések: 7-30 nap

Következő lépések