Hyppää sisältöön

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

Teksti + kuva + painike esimerkki

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

Video + teksti + painike esimerkki

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

Esimerkki vain kuvasta

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

Vain teksti

Esimerkki vain tekstistä

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

Vain video

Vain videoesimerkki

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

Video + tekstiesimerkki

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

Esimerkki vain tekstistä

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

Teksti + PDF

Teksti + PDF-esimerkki

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

PDF-esimerkki

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

Viber-karuselliesimerkki

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

Viber Survey 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

Viber OTP 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