Kalo te përmbajtja

Mesazhe Viber

SMSBAT API mbështet lloje të shumta mesazhesh Viber për raste të ndryshme përdorimi, nga fushatat promocionale deri te njoftimet e transaksioneve.

Përmbledhje e llojeve të mesazheve

Lloji Qëllimi Media e pasur Interaktive
viber_promo Fushata marketingu ✅ Imazhe, Video ✅ Butonat
viber_trans Njoftimet për transaksionet ✅ PDF ❌
viber_carousel Vitrinat e produkteve ✅ Imazhe ✅ Butona të shumtë
viber_survey Sondazhet dhe komentet ❌ ✅ Opsione të shumta
viber_otp Fjalëkalimet një herë ❌ ❌

Promo Viber

Mesazhe promovuese me mbështetje të pasur mediatike për fushatat e marketingut.

Përmbajtje e mbështetur

  • Vetëm imazh
  • Vetëm tekst
  • Butoni "Tekst +".
  • Imazhi + tekst + butoni
  • Video + tekst
  • Video + tekst + butoni
  • Vetëm video

Parametrat

Parametri Lloji Kërkohet Përshkrimi
img varg Jo URL e imazhit
video varg Jo URL e skedarit video
miniaturë varg Jo Pamja paraprake e videos
ButtonText varg Jo Etiketa e butonit thirrje për veprim
"buttonAction" varg Jo Klikoni butonin Destinacioni i URL-së
Madhësia e skedarit numër i plotë Jo Madhësia e skedarit të videos në byte
'kohëzgjatja' numër i plotë Jo Gjatësia e videos në sekonda

Shembuj

Tekst + Imazh + Butoni

Tekst + Imazh + Shembull i butonit

{
  "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 + Tekst + Butoni

Video + Tekst + Shembull i butonit

KODI_BLOCK_1

Vetëm imazh

Shembull vetëm për imazhin

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

Vetëm tekst

Shembull vetëm për tekst

KODI_BLOCK_3

Vetëm video

Shembull vetëm për 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 + Tekst

Video + Shembull 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 Transactional

Njoftimet e transaksioneve për informacione të ndjeshme për kohën, si konfirmimet dhe faturat e porosive.

Përmbajtje e mbështetur

  • Vetëm tekst
  • Skedar PDF + tekst
  • Vetëm skedar PDF

Parametrat

Parametri Lloji Kërkohet Përshkrimi
FileUrl varg Jo URL e dokumentit PDF
Emri i skedarit varg Jo Emri i shfaqur për bashkëngjitjen
"Lloji i skedarit" varg Jo Lloji i skedarit (përdorni "pdf")

Shembuj

Vetëm tekst

Shembull vetëm për tekst

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

Tekst + PDF

Tekst + Shembull 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
}

Vetëm PDF

Shembull vetëm PDF

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

Vitrinë e shfletueshme me shumë artikuj për produkte ose përmbajtje.

Struktura

Një sërë artikujsh karuseli, secili përmban:

  • Titulli
  • Imazhi
  • Butoni kryesor (veprimi kryesor)
  • Butoni dytësor (veprim alternativ)

Parametrat

Parametri Lloji Kërkohet Përshkrimi
carousel grup Po Gama e artikujve karusel
artikuj grup Po Objektet individuale të kartës

Shembull

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

Anketa Viber

Sondazhe interaktive dhe mbledhja e komenteve me opsione të shumëfishta.

Parametrat

Parametri Lloji Kërkohet Përshkrimi
anketë objekt Po Kontejneri i anketimit
'opsione' grup Po Një grup prej 1-5 përgjigjesh

Kufizimet

  • Mbështeten maksimumi 5 opsione përgjigjeje
  • Çdo opsion duhet të jetë konciz (rekomandohet: nën 30 karaktere)

Shembull

Shembull i anketës 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

Dorëzimi i fjalëkalimit një herë me shabllone të paracaktuara.

Karakteristikat kryesore

  • 9 shabllone të paracaktuara
  • Vlefshmëria e parametrave (TEXT, NUMBER lloje)
  • Mbështetje shumë-gjuhëshe (19 gjuhë)
  • Emrat e ndryshoreve me ndjeshmëri të madhe

Gjuhët e mbështetura

Ukrainisht, anglisht, rusisht, polonisht, rumune, spanjisht, gjermanisht, frëngjisht, italisht, portugalisht, holandisht, turqisht, arabisht, hebraisht, hindisht, kinezisht, japonisht, koreanisht, vietnamezisht

Parametrat

Parametri Lloji Kërkohet Përshkrimi
Id shabllon varg (UUID) Po Identifikuesi i shabllonit
templateLang varg Po Kodi i gjuhës ISO
shabllonParams objekt Po Ndryshoret që përputhen me shabllonin

Shembull

Shembull Viber OTP

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

Shembull modeli: "Kodi juaj: 123456. I vlefshëm për 10 minuta. Mos e shpërndani kurrë këtë kod."

Modele dhe vërtetime të mbështetura

Viber ofron modele të paracaktuara dhe të kontrolluara rreptësisht. Parametrat e variablave të kaluar duhet të korrespondojnë me llojet e sakta të të dhënave.

Llojet e të dhënave: - NUMRI: Vetëm numrat [0-9], +, - dhe .. Simbolet si / ose hapësira e bardhë nuk mbështeten. - TEXT: çdo alfabet gjuhe, simbole (@#$%^&*().,<>;:!\"'+=-()[]{} \n etj). - Hartëzimi i rregullt: Një sekuencë e <shkronjave> nuk mund të ekzistojë ngjitur me një sekuencë <numri>; ato kërkojnë ndarje të hapësirave të bardha. Hapësirat e dyfishta `` brenda shablloneve janë përgjithësisht të ndaluara. Për lidhjet, shmangni hapësirat nëse tejkalojnë kufijtë.

Më poshtë janë 9 shabllonet standarde ISO. Zëvendësoni ID-të bazuar në kërkesat tuaja të regjistrimit në vende të veçanta. Kontaktoni mbështetjen nëse shtoni gjuhë të tjera.

1. "VETËM Kodi (Çdo PIN)"

Kërkesat: Mbështet kodet PIN me numra dhe shkronja angleze, simbolet - ose .. Modeli kërkon formatimin për të shfaqur siç duhet markën tuaj krahas kodit PIN të verifikimit.

2. "Veprim: Ju lutemi përdorni këtë kod"

Parametrat: {pin} (NUMR ose TEXT) Formati shembull: "Ju lutemi përdorni këtë kod {pin} për verifikim."

3. "Regjistrimi/Qasja e markës"

Parametrat: {business_platform_name} (TEXT), {pin} (NUMBER ose TEXT) Formati i shembullit: "Kodi juaj për {business_platform_name} është {pin}."

4. "Koha e verifikimit të kodit"

Parametrat: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Formati i shembullit: "Kodi juaj i verifikimit është {pin}. Është e vlefshme për {code_validity_time} minuta."

5. "Qasja e markës dhe verifikimi i kodit"

Parametrat: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Formati shembull: "Kodi i verifikimit të {business_platform_name} është {pin} i vlefshëm për {code_validity_time} minuta."

(Shënim: Ka deri në 9 blloqe strukturore të paracaktuara për rregullat standarde OTP të Viber bazuar në kombinimet e përdorimit të 'pin', 'emrit_platformës_biznesit' dhe 'code_validity_time').

Kërkesa të Përgjithshme

Të gjitha llojet e mesazheve Viber kërkojnë:

  • nga: ID alfanumerike e dërguesit
  • to: Numri i telefonit në formatin E.164
  • lloj: identifikues i llojit të mesazhit
  • ttl: Koha e skadimit të mesazhit në sekonda (rekomandohet)

Rikthim në SMS

Të gjitha llojet e mesazheve Viber mbështesin kthimin e SMS-ve duke përdorur bllokun e grupit të "fallbacks". Nëse dërgimi i Viber dështon, mesazhi kthehet automatikisht në kanale alternative të konfiguruara.

Viber Promo -> Kthim SMS

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

Anketa Viber -> Kthim 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 -> SMS Fallback

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

Praktikat më të mira

Imazhe

  • Përdorni formatin JPG ose PNG
  • Madhësia e rekomanduar: 800x600 piksele
  • Mbani madhësinë e skedarit nën 1 MB
  • Përdorni URL HTTPS

Video

  • Përdorni formatin MP4
  • Mbani madhësinë e skedarit nën 10 MB
  • Përfshi imazhin e miniaturës
  • Specifikoni kohëzgjatjen dhe madhësinë e skedarit

Butonat

  • Mbajeni tekstin e butonit të shkurtër (2-3 fjalë)
  • Përdorni fraza të qarta thirrje për veprim
  • Përdorni gjithmonë URL HTTPS
  • Testoni URL-të përpara se të dërgoni

TTL (Koha për të jetuar)

  • Mesazhe promocionale: 24-72 orë
  • Mesazhe transaksioni: 24 orë
  • Mesazhet OTP: 5-10 minuta
  • Sondazhet: 7-30 ditë

Hapat e ardhshëm