Skip to content

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 ❌ ❌

Viber Promo

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

Test + Immaġni + Buttuna Eżempju

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

Video + Test + Button Eżempju

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

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.

Viber Promo -> SMS Fallback

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