Viber-viestit

SMSBAT API tukee useita Viber-viestejä erilaisiin käyttötapauksiin promootiokampanjoista tapahtumailmoituksiin.

Viestityyppien yleiskatsaus

Tyyppi	Tarkoitus	Interaktiivinen media	Interaktiivinen
viber_promo	Markkinointikampanjat	✅ Kuvia, videoita	✅ Painikkeet
”viber_trans”	Tapahtumailmoitukset	✅ PDF	❌
viber_carousel	Tuoteesittelyt	✅ Kuvat	✅ Useita painikkeita
viber_survey	Kyselyt ja palaute	❌	✅ Useita vaihtoehtoja
viber_otp	Kertakäyttöiset salasanat	❌	❌

Viber Promo

Mainosviestit multimediatuella markkinointikampanjoita varten.

Tuettu sisältö

• Vain kuva
• Vain teksti
• Teksti + -painike
• Kuva + teksti + painike
• Video + teksti
• Video + teksti + painike
• Vain video

Parametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
”img”	merkkijono	Ei	Kuvan URL-osoite
”video”	merkkijono	Ei	Videotiedoston URL-osoite
”pikkukuva”	merkkijono	Ei	Videon esikatselukuva
”painiketeksti”	merkkijono	Ei	Toimintakehotuspainikkeen etiketti
”buttonAction”	merkkijono	Ei	Napsauta painiketta URL-kohde
fileSize	kokonaisluku	Ei	Videotiedoston koko tavuina
”kesto”	kokonaisluku	Ei	Videon pituus sekunneissa

Esimerkkejä

Teksti + kuva + painike

{
  "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 + teksti + painike

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

Vain kuva

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

Vain teksti

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

Vain video

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

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

Tapahtumailmoitukset aikaherkille tiedoille, kuten tilausvahvistuksille ja kuiteille.

Tuettu sisältö

• Vain teksti
• PDF-tiedosto + teksti
• Vain PDF-tiedosto

Parametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
fileUrl	merkkijono	Ei	PDF-dokumentin URL-osoite
”tiedostonimi”	merkkijono	Ei	Liitteen näyttönimi
”tiedostotyyppi”	merkkijono	Ei	Tiedostotyyppi (käytä “pdf”)

Esimerkkejä

Vain teksti

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

Teksti + 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
}

Vain PDF

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

Viber-karuselli

Useita kohteita selattava esittely tuotteista tai sisällöstä.

Rakenne

Joukko karusellikohteita, joista jokainen sisältää:

• Otsikko
• Kuva
• Ensisijainen painike (päätoiminto)
• Toissijainen painike (vaihtoehtoinen toiminto)

Parametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
”karuselli”	joukko	Kyllä	Joukko karusellituotteita
”kohteet”	joukko	Kyllä	Yksittäiset korttiesineet

Esimerkki

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

Interaktiiviset kyselyt ja palautteen kerääminen monivalintavaihtoehdoilla.

Parametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
”tutkimus”	esine	Kyllä	Tutkimuskontti
”vaihtoehdot”	joukko	Kyllä	Joukko 1-5 vastausvaihtoehtoa

Rajoitukset

• Enintään 5 vastausvaihtoehtoa tuetaan
• Jokaisen vaihtoehdon tulee olla ytimekäs (suositus: alle 30 merkkiä)

Esimerkki

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

Kertaluonteinen salasanan toimitus ennalta määritetyillä malleilla.

Tärkeimmät ominaisuudet

• 9 ennalta määritettyä mallia
• Parametrien vahvistus (TEXT, NUMBER tyypit)
• Monikielinen tuki (19 kieltä)
• Muuttujien nimet kirjainkoolla

Tuetut kielet

ukraina, englanti, venäjä, puola, romania, espanja, saksa, ranska, italia, portugali, hollanti, turkki, arabia, heprea, hindi, kiina, japani, korea, vietnami

Parametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
templateId	merkkijono (UUID)	Kyllä	Mallin tunniste
templateLang	merkkijono	Kyllä	ISO-kielikoodi
templateParams	esine	Kyllä	Mallia vastaavat muuttujat

Esimerkki

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

Malliesimerkki: “Koodisi: 123456. Voimassa 10 minuuttia. Älä koskaan jaa tätä koodia.”

Tuetut mallit ja vahvistukset

Viber tarjoaa ennalta määritettyjä ja tiukasti valvottuja malleja. Siirrettyjen muuttujien parametrien on vastattava oikeita tietotyyppejä.

Tietotyypit:

• NUMERO: vain numerot [0-9], +, - ja .. Symboleja, kuten / tai välilyöntejä, ei tueta.
• TEKSTI: Mikä tahansa kielen aakkoset, symbolit (@#$%^&*().,<>;:!\"'+=-()[]{} \n jne).
• Säännöllinen kartoitus: -jono ei voi olla -sekvenssin vieressä. ne vaativat välilyöntien erottelun. Kaksinkertaiset välilyönnit “ mallien sisällä ovat yleensä kiellettyjä. Vältä välilyöntejä linkeissä, jos ne ylittävät rajat.

Alla on 9 standardi ISO-mallia. Vaihda tunnukset tiettyjen maiden rekisteröintivaatimustesi perusteella. Ota yhteyttä tukeen, jos lisäät muita kieliä.

1. “VAIN koodi (kaikki PIN-koodit)”

Edellytykset: Tukee PIN-koodeja numeroilla ja englanninkielisillä kirjaimilla, symboleilla - tai .. Malli vaatii muotoilun, jotta brändisi näkyy oikein vahvistus-PIN-koodin rinnalla.

2. “Toiminto: Käytä tätä koodia”

Parametrit: {pin} (NUMERO tai TEKSTI) Esimerkkimuoto: “Käytä tätä koodia {pin} vahvistamiseen.”

3. “Brändin rekisteröinti/pääsy”

Parametrit: {business_platform_name} (TEXT), {pin} (NUMERO tai TEKSTI) Esimerkkimuoto: “Koodisi kohteelle {business_platform_name} on {pin}.“

4. “Koodin vahvistuksen ajoitus”

Parametrit: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Esimerkkimuoto: “Vahvistuskoodisi on {pin}. Se on voimassa {code_validity_time} minuuttia.”

5. “Brand Access & Code Validation”

Parametrit: “{business_platform_name}” (TEKSTI), “{pin}” (NUMERO/TEKSTI), “{code_validity_time}” (NUMBER) Esimerkkimuoto: “{business_platform_name}-vahvistuskoodi on {pin} voimassa {code_validity_time} minuuttia.”

(Huomaa: Viberin vakiomuotoisille OTP-säännöille on jopa 9 ennalta määritettyä rakennelohkoa, jotka perustuvat PIN-, business_platform_name- ja Code_validity_time-käytön yhdistelmiin).

Yleiset vaatimukset

Kaikki Viber-viestityypit vaativat:

• “from”: Aakkosnumeerinen lähettäjän tunnus
• Vastaanottaja: Puhelinnumero E.164-muodossa
• type: Viestityypin tunniste
• ttl: Viestin vanhenemisaika sekunneissa (suositus)

Takaisin tekstiviestiin

Kaikki Viber-viestityypit tukevat varatekstiviestien palautusvaihtoehtoa käyttämällä “fallbacks”-taulukkolohkoa. Jos Viber-toimitus epäonnistuu, viesti palautuu automaattisesti vaihtoehtoisille konfiguroiduille kanaville.

Viber Promo -> SMS-varaus

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

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

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

Parhaat käytännöt

Kuvat

• Käytä JPG- tai PNG-muotoa
• Suositeltu koko: 800x600 pikseliä
• Pidä tiedostokoko alle 1 Mt
• Käytä HTTPS-URL-osoitteita

Videot

• Käytä MP4-muotoa
• Pidä tiedostokoko alle 10 Mt
• Sisällytä pikkukuva
• Määritä kesto ja tiedostokoko

Painikkeet

• Pidä painikkeen teksti lyhyenä (2-3 sanaa)
• Käytä selkeitä toimintakehotuksia
• Käytä aina HTTPS-URL-osoitteita
• Testaa URL-osoitteet ennen lähettämistä

TTL (Time-to-Live)

• Kampanjaviestit: 24-72 tuntia
• Tapahtumaviestit: 24 tuntia
• OTP-viestit: 5-10 minuuttia
• Kyselyt: 7-30 päivää

Seuraavat vaiheet

• Tekstiviestit - Lisätietoja tekstiviestien varapuhelimesta
• RCS-viestit - Monipuoliset viestintäpalvelut
• Tarkista tila - Seuraa toimituksen tilaa