Messaggi Viber

L'API SMSBAT supporta più tipi di messaggi Viber per diversi casi d'uso, dalle campagne promozionali alle notifiche delle transazioni.

Panoramica dei tipi di messaggio

Digitare	Scopo	Rich Media	Interattivo
viber_promo	Campagne di marketing	✅ Immagini, Video	✅ Bottoni
viber_trans	Notifiche transazionali	✅ PDF	❌
viber_carousel	Vetrine prodotti	✅ Immagini	✅ Pulsanti multipli
viber_survey	Sondaggi e feedback	❌	✅ Molteplici opzioni
viber_otp	Password monouso	❌	❌

Promozione Viber

Messaggi promozionali con supporto rich media per campagne di marketing.

Contenuti supportati

• Solo immagine
• Solo testo
• Testo + pulsante
• Immagine + testo + pulsante -Video + testo
• Video + testo + pulsante
• Solo video

Parametri

Parametro	Digitare	Obbligatorio	Descrizione
img	stringa	No	URL dell'immagine
"video"	stringa	No	URL del file video
miniatura	stringa	No	Immagine di anteprima video
pulsanteTesto	stringa	No	Etichetta del pulsante di invito all'azione
pulsanteAzione	stringa	No	Fare clic sul pulsante URL di destinazione
dimensionefile	intero	No	Dimensioni del file video in byte
durata	intero	No	Durata del video in secondi

Esempi

Testo + Immagine + Pulsante

{
  "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 + Testo + Pulsante

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

Solo immagine

CODICE_BLOCCO_2

Solo testo

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

Solo 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 + testo

CODICE_BLOCCO_5

Transazionale Viber

Notifiche di transazione per informazioni urgenti come conferme di ordini e ricevute.

Contenuti supportati

• Solo testo
• File PDF + testo -Solo file PDF

Parametri

Parametro	Digitare	Obbligatorio	Descrizione
fileUrl	stringa	No	URL del documento PDF
nomefile	stringa	No	Nome visualizzato per l'allegato
"tipofile"	stringa	No	Tipo di file (usa "pdf")

Esempi

Solo testo

CODICE_BLOCCO_6

Testo + PDF

CODICE_BLOCCO_7

Solo PDF

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

Carosello Viber

Vetrina sfogliabile multiarticolo per prodotti o contenuti.

Struttura

Serie di elementi del carosello, ciascuno contenente:

• Titolo
• Immagine
• Pulsante principale (azione principale)
• Pulsante secondario (azione alternativa)

Parametri

Parametro	Digitare	Obbligatorio	Descrizione
carosello	matrice	Sì	Serie di elementi del carosello
"oggetti"	matrice	Sì	Oggetti di carte individuali

Esempio

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

Sondaggio Viber

Sondaggi interattivi e raccolta di feedback con opzioni a scelta multipla.

Parametri

Parametro	Digitare	Obbligatorio	Descrizione
"sondaggio"	oggetto	Sì	Contenitore per sondaggi
"opzioni"	matrice	Sì	Serie di 1-5 scelte di risposta

Vincoli

• Sono supportate un massimo di 5 opzioni di risposta
• Ogni opzione deve essere concisa (consigliato: meno di 30 caratteri)

Esempio

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

Consegna di password monouso con modelli predefiniti.

Caratteristiche principali

• 9 modelli predefiniti
• Convalida dei parametri (tipi TESTO, NUMERO)
• Supporto multilingue (19 lingue)
• Nomi delle variabili con distinzione tra maiuscole e minuscole

Lingue supportate

Ucraino, inglese, russo, polacco, rumeno, spagnolo, tedesco, francese, italiano, portoghese, olandese, turco, arabo, ebraico, hindi, cinese, giapponese, coreano, vietnamita

Parametri

Parametro	Digitare	Obbligatorio	Descrizione
templateId	stringa (UUID)	Sì	Identificatore del modello
templateLang	stringa	Sì	Codice lingua ISO
templateParams	oggetto	Sì	Modello di corrispondenza delle variabili

Esempio

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

Esempio di modello: "Il tuo codice: 123456. Valido per 10 minuti. Non condividere mai questo codice."

Modelli e convalide supportati

Viber offre modelli predefiniti e rigorosamente controllati. I parametri delle variabili passati devono corrispondere ai tipi di dati corretti.

Tipi di dati: - NUMERO: Solo numeri [0-9], +, - e .. Simboli come "/" o spazi bianchi non sono supportati. - TESTO: alfabeto di qualsiasi lingua, simboli (@#$%^&*().,<>;:!\"'+=-()[]{} \n ecc.). - Mappatura regolare: una sequenza di <lettere> non può esistere adiacente a una sequenza di <numero>; richiedono la separazione degli spazi bianchi. I doppi spazi all'interno dei template sono generalmente proibiti. Per i collegamenti, evitare gli spazi se superano i limiti.

Di seguito sono riportati i 9 modelli ISO standard. Sostituisci gli ID in base ai requisiti di registrazione in paesi specifici. Contatta l'assistenza se aggiungi altre lingue.

1. "SOLO codice (qualsiasi PIN)"

Requisiti: Supporta PIN in numeri e lettere inglesi, simboli "-" o ".". Il modello richiede la formattazione per visualizzare correttamente il tuo marchio insieme al PIN di verifica.

2. "Azione: utilizzare questo codice"

Parametri: {pin} (NUMERO o TESTO) Formato di esempio: "Utilizza questo codice {pin} per la verifica."

3. "Registrazione/Accesso al marchio"

Parametri: {business_platform_name} (TESTO), {pin} (NUMERO o TESTO) Formato di esempio: "Il tuo codice per {business_platform_name} è {pin}."

4. "Tempistiche di convalida del codice"

Parametri: {pin} (NUMERO/TESTO), {code_validity_time} (NUMERO) Formato di esempio: "Il tuo codice di verifica è {pin}. È valido per {code_validity_time} minuti."

5. "Accesso al marchio e convalida del codice"

Parametri: {business_platform_name} (TESTO), {pin} (NUMERO/TESTO), {code_validity_time} (NUMERO) Formato di esempio: "Il codice di verifica di {business_platform_name} è {pin} valido per {code_validity_time} minuti."

(Nota: sono disponibili fino a 9 blocchi strutturali predefiniti per le regole OTP standard di Viber basate sulle combinazioni di utilizzo di pin, business_platform_name e code_validity_time).

Requisiti generali

Tutti i tipi di messaggi Viber richiedono:

• "da": ID mittente alfanumerico
• "a": numero di telefono in formato E.164
• type: identificatore del tipo di messaggio
• ttl: tempo di scadenza del messaggio in secondi (consigliato)

Fallback agli SMS

Tutti i tipi di messaggi Viber supportano il fallback SMS utilizzando il blocco array fallbacks. Se la consegna di Viber fallisce, il messaggio ritorna automaticamente su canali configurati alternativi.

Promozione Viber -> Fallback SMS

CODICE_BLOCCO_12

Sondaggio Viber -> Fallback 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 -> Fallback SMS

CODICE_BLOCCO_14

Migliori pratiche

Immagini

• Utilizza il formato JPG o PNG
• Dimensione consigliata: 800x600 pixel
• Mantieni la dimensione del file inferiore a 1 MB
• Utilizza URL HTTPS

Video

• Utilizza il formato MP4
• Mantieni la dimensione del file inferiore a 10 MB
• Includi immagine in miniatura
• Specificare la durata e la dimensione del file

Pulsanti

• Mantieni il testo del pulsante breve (2-3 parole)
• Utilizza frasi di invito all'azione chiare
• Utilizza sempre gli URL HTTPS
• Testare gli URL prima dell'invio

TTL (Time-to-Live)

• Messaggi promozionali: 24-72 ore
• Messaggi transazionali: 24 ore
• Messaggi OTP: 5-10 minuti
• Sondaggi: 7-30 giorni

Passaggi successivi

• Messaggi SMS - Ulteriori informazioni sugli SMS di riserva
• Messaggi RCS - Rich Communication Services
• Verifica stato - Tieni traccia dello stato della consegna