Help Center Mesazhe Viber

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

LlojiQëllimiMedia e pasurInteraktive
viber_promoFushata marketingu✅ Imazhe, Video✅ Butonat
viber_transNjoftimet për transaksionet✅ PDF❌
viber_carouselVitrinat e produkteve✅ Imazhe✅ Butona të shumtë
viber_surveySondazhet dhe komentet❌✅ Opsione të shumta
viber_otpFjalë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

ParametriLlojiKërkohetPërshkrimi
imgvargJoURL e imazhit
videovargJoURL e skedarit video
miniaturëvargJoPamja paraprake e videos
ButtonTextvargJoEtiketa e butonit thirrje për veprim
”buttonAction”vargJoKlikoni butonin Destinacioni i URL-së
Madhësia e skedaritnumër i plotëJoMadhësia e skedarit të videos në byte
’kohëzgjatja’numër i plotëJoGjatë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

ParametriLlojiKërkohetPërshkrimi
FileUrlvargJoURL e dokumentit PDF
Emri i skedaritvargJoEmri i shfaqur për bashkëngjitjen
”Lloji i skedarit”vargJoLloji 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

ParametriLlojiKërkohetPërshkrimi
carouselgrupPoGama e artikujve karusel
artikujgrupPoObjektet 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

ParametriLlojiKërkohetPërshkrimi
anketëobjektPoKontejneri i anketimit
’opsione’grupPoNjë 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

ParametriLlojiKërkohetPërshkrimi
Id shabllonvarg (UUID)PoIdentifikuesi i shabllonit
templateLangvargPoKodi i gjuhës ISO
shabllonParamsobjektPoNdryshoret 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