Help Center Messaġġi Viber

Messaġġi Viber

SMSBAT API jappoġġja tipi multipli ta ‘messaġġi Viber għal każijiet ta’ użu differenti, minn kampanji promozzjonali għal notifiki ta ‘tranżazzjonijiet.

Ħarsa ġenerali tat-tipi ta’ messaġġi

Tip	Għan	Rich Media	Interattiv
`viber_promo`	Kampanji ta’ kummerċjalizzazzjoni	✅ Stampi, Videos	✅ Buttuni
`viber_trans`	Notifiki transazzjonali	✅ PDFs	❌
`viber_carousel`	Vetrini tal-prodotti	✅ Stampi	✅ Buttuni multipli
`viber_survey`	Polls u feedback	❌	✅ Għażliet multipli
`viber_otp`	Passwords ta’ darba	❌	❌

Messaġġi promozzjonali b’appoġġ rikk tal-midja għal kampanji ta’ kummerċjalizzazzjoni.

Kontenut Appoġġjat

Immaġini biss
Test biss
Test + buttuna
Immaġni + test + buttuna
Vidjo + test
Vidjo + test + buttuna
Vidjow biss

Parametri

Parametru	Tip	Meħtieġa	Deskrizzjoni
`img`	spag	Le	URL tal-immaġni
”video”	spag	Le	URL tal-fajl tal-vidjo
`thumbnail`	spag	Le	Preview image tal-vidjo
`buttonText`	spag	Le	Tikketta tal-buttuna tas-sejħa għall-azzjoni
”buttonAction”	spag	Le	Ikklikkja buttuna URL destinazzjoni
`Daqs tal-fajl`	numru sħiħ	Le	Daqs tal-fajl tal-vidjo f’bytes
”tul”	numru sħiħ	Le	Tul tal-vidjo f’sekondi

Eżempji

Test + Immaġni + Button

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

Vidjo + Test + Button

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

Immaġini Biss

Eżempju ta' Immaġni biss

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

Test Biss

Eżempju ta' Test biss

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

Video Biss

Eżempju tal-vidjo biss

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

Vidjo + Test

Eżempju ta' Video + Test

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

Notifiki tat-tranżazzjonijiet għal informazzjoni sensittiva għall-ħin bħal konfermi tal-ordnijiet u rċevuti.

Kontenut Appoġġjat

Test biss
Fajl PDF + test
Fajl PDF biss

Parametri

Parametru	Tip	Meħtieġa	Deskrizzjoni
`fileUrl`	spag	Le	URL tad-dokument PDF
`fileName`	spag	Le	Isem tal-wiri għat-twaħħil
`fileType`	spag	Le	Tip ta’ fajl (uża “pdf”)

Eżempji

Test Biss

Eżempju ta' Test biss

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

Test + PDF

Test + PDF Eżempju

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

PDF Biss

Eżempju PDF biss

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

Viber Carousel

Vetrina browsable b’ħafna oġġetti għal prodotti jew kontenut.

Struttura

Array ta’ oġġetti tal-karużell, li kull wieħed ikun fih:

Titolu
Immaġni
Buttuna primarja (azzjoni ewlenija)
Buttuna sekondarja (azzjoni alternattiva)

Parametri

Parametru	Tip	Meħtieġa	Deskrizzjoni
”karużell”	firxa	Iva	Array ta’ oġġetti tal-karużell
”oġġetti”	firxa	Iva	Oġġetti tal-kards individwali

Eżempju

Eżempju tal-Carousel Viber

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

Stħarriġ Viber

Stħarriġ interattiv u ġbir ta ‘feedback b’għażliet ta’ għażla multipla.

Parametri

Parametru	Tip	Meħtieġa	Deskrizzjoni
”stħarriġ”	oġġett	Iva	Kontenitur tal-istħarriġ
”għażliet”	firxa	Iva	Array ta’ 1-5 għażliet ta’ tweġiba

Limitazzjonijiet

Massimu ta’ 5 għażliet ta’ rispons appoġġjati
Kull għażla għandha tkun konċiża (rakkomandat: taħt 30 karattru)

Eżempju

Viber Survey Eżempju

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

Kunsinna ta’ password ta’ darba b’mudelli definiti minn qabel.

Karatteristiċi Ewlenin

9 mudelli definiti minn qabel
Validazzjoni tal-parametri (TEST, NUMRU tipi)
Appoġġ b’ħafna lingwi (19-il lingwa)
Ismijiet varjabbli sensittivi għall-każ

Lingwi Appoġġjati

Ukrain, Ingliż, Russu, Pollakk, Rumen, Spanjol, Ġermaniż, Franċiż, Taljan, Portugiż, Olandiż, Tork, Għarbi, Ebrajk, Ħindi, Ċiniż, Ġappuniż, Korean, Vjetnamiż

Parametri

Parametru	Tip	Meħtieġa	Deskrizzjoni
`templateId`	string (UUID)	Iva	Identifikatur tal-mudell
`templateLang`	spag	Iva	Kodiċi tal-lingwa ISO
`templateParams`	oġġett	Iva	Mudell ta’ tqabbil ta’ varjabbli

Eżempju

Viber OTP Eżempju

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

Eżempju ta’ mudell: “Il-kodiċi tiegħek: 123456. Validu għal 10 minuti. Qatt taqsam dan il-kodiċi.”

Templates & Validazzjonijiet Appoġġjati

Viber joffri mudelli predefiniti u kkontrollati b’mod strett. Il-parametri varjabbli mgħoddija għandhom jikkorrispondu mat-tipi ta’ data korretti.

Tipi ta’ Dejta:

NUMRU: Numri biss [0-9], +, -, u .. Simboli bħal / jew whitespace mhumiex appoġġjati.
TEST: Kull alfabett tal-lingwa, simboli (@#$%^&*().,<>;:!\"'+=-()[]{} \n eċċ).
Immappjar regolari: Sekwenza ta’ "" ma tistax teżisti ħdejn sekwenza ""; jeħtieġu separazzjoni tal-ispazju abjad. L-ispazji bojod doppji ġewwa mudelli huma ġeneralment projbiti. Għal links, evita l-ispazji jekk jaqbżu l-limiti.

Hawn taħt jinsabu d-9 mudelli ISO Standard. Ibdel IDs ibbażati fuq ir-rekwiżiti tar-reġistrazzjoni tiegħek f’pajjiżi speċifiċi. Ikkuntattja l-appoġġ jekk iżżid lingwi addizzjonali.

1. “Kodiċi BISS (Kull PIN)”

Rekwiżiti: Jappoġġja PINs f’numri u ittri Ingliżi, simboli - jew .. Il-mudell jeħtieġ ifformattjar biex juri l-marka tiegħek sewwa flimkien mal-PIN tal-verifika.

2. “Azzjoni: Jekk jogħġbok uża dan il-kodiċi”

Parametri: {pin} (NUMRU jew TEST) Format ta’ eżempju: “Jekk jogħġbok uża dan il-kodiċi {pin} għall-verifika.”

3. “Reġistrazzjoni/Aċċess tal-Marka”

Parametri: {business_platform_name} (TEXT), {pin} (NUMRU jew TEXT) Format ta’ eżempju: “Il-kodiċi tiegħek għal {business_platform_name} huwa {pin}.“

4. “Ħin tal-Validazzjoni tal-Kodiċi”

Parametri: {pin} (NUMRU/TEXT), {code_validity_time} (NUMRU) Format ta’ eżempju: “Il-kodiċi ta’ verifika tiegħek huwa {pin}. Huwa validu għal {code_validity_time} minuti.”

5. “Aċċess għall-Marka u Validazzjoni tal-Kodiċi”

Parametri: {business_platform_name} (TEXT), {pin} (NUMRU/TEXT), {code_validity_time} (NUMRU) Format ta’ eżempju: “{business_platform_name} kodiċi ta’ verifika huwa {pin} validu għal {code_validity_time} minuti.”

(Nota: Hemm sa 9 blokki strutturali predefiniti għal regoli standard OTP ta’ Viber ibbażati fuq kombinazzjonijiet tal-użu tal-‘pin’, ‘business_platform_name’, u l-użu tal-‘code_validity_time’).

Rekwiżiti Ġenerali

It-tipi kollha ta’ messaġġi Viber jeħtieġu:

“minn”: ID alfanumeriku tal-mittent
to: Numru tat-telefon fil-format E.164
“tip”: Identifikatur tat-tip ta’ messaġġ
ttl: Il-ħin tal-iskadenza tal-messaġġ f’sekondi (rakkomandat)

Fallback għall-SMS

It-tipi kollha ta’ messaġġi Viber jappoġġjaw l-SMS fallback bl-użu tal-blokk tal-firxa “fallbacks”. Jekk il-kunsinna ta ‘Viber tfalli, il-messaġġ jaqa’ awtomatikament lura għal kanali konfigurati alternattivi.

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

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

L-Aħjar Prattiċi

Stampi

Uża format JPG jew PNG
Daqs rakkomandat: 800x600 pixels
Żomm id-daqs tal-fajl taħt 1MB
Uża URLs HTTPS

Vidjows

Uża format MP4
Żomm id-daqs tal-fajl taħt 10MB
Inkludi immaġni miniatura
Speċifika t-tul u d-Daqs tal-fajl

Buttuni

Żomm it-test tal-buttuna qasir (2-3 kelmiet)
Uża frażijiet ċari ta’ sejħa għall-azzjoni
Dejjem uża URLs HTTPS
Ittestja l-URLs qabel ma tibgħat

TTL (Time-to-Live)

Messaġġi promozzjonali: 24-72 siegħa
Messaġġi transazzjonali: 24 siegħa
Messaġġi OTP: 5-10 minuti
Stħarriġ: 7-30 jum

Il-passi li jmiss

Messaġġi SMS - Tgħallem dwar l-SMS fallback
Messaġġi RCS - Servizzi ta’ Komunikazzjoni Sinjuri
Iċċekkja l-Istatus - Ittraċċa l-istatus tal-kunsinna

Search Results

Messaġġi Viber

Ħarsa ġenerali tat-tipi ta’ messaġġi

Viber Promo

Kontenut Appoġġjat

Parametri

Eżempji

Test + Immaġni + Button

Vidjo + Test + Button

Immaġini Biss

Test Biss

Video Biss

Vidjo + Test

Viber Transazzjonali

Kontenut Appoġġjat

Parametri

Eżempji

Test Biss

Test + PDF

PDF Biss

Viber Carousel

Struttura

Parametri

Eżempju

Stħarriġ Viber

Parametri

Limitazzjonijiet

Eżempju

Viber OTP

Karatteristiċi Ewlenin

Lingwi Appoġġjati

Parametri

Eżempju

Templates & Validazzjonijiet Appoġġjati

1. “Kodiċi BISS (Kull PIN)”

2. “Azzjoni: Jekk jogħġbok uża dan il-kodiċi”

3. “Reġistrazzjoni/Aċċess tal-Marka”

4. “Ħin tal-Validazzjoni tal-Kodiċi”

5. “Aċċess għall-Marka u Validazzjoni tal-Kodiċi”

Rekwiżiti Ġenerali

Fallback għall-SMS

Viber Promo -> SMS Fallback

Viber Survey -> SMS Fallback

Viber Trans -> SMS Fallback

L-Aħjar Prattiċi

Stampi

Vidjows

Buttuni

TTL (Time-to-Live)

Il-passi li jmiss