Zum Inhalt

Viber-Nachrichten

Die SMSBAT-API unterstützt mehrere Arten von Viber-Nachrichten für verschiedene Anwendungsfälle, von Werbekampagnen bis hin zu Transaktionsbenachrichtigungen.

Übersicht über Nachrichtentypen

Geben Sie ein Zweck Rich Media Interaktiv
viber_promo Marketingkampagnen ✅ Bilder, Videos ✅ Knöpfe
viber_trans Transaktionsbenachrichtigungen ✅ PDFs ❌
viber_carousel Produktvitrinen ✅ Bilder ✅ Mehrere Tasten
viber_survey Umfragen und Feedback ❌ ✅ Mehrere Optionen
viber_otp Einmalpasswörter ❌ ❌

Viber-Promo

Werbebotschaften mit Rich-Media-Unterstützung für Marketingkampagnen.

Unterstützte Inhalte

  • Nur Bild
  • Nur Text
  • Text + Schaltfläche
  • Bild + Text + Schaltfläche
  • Video + Text
  • Video + Text + Schaltfläche
  • Nur Video

Parameter

Parameter Geben Sie ein Erforderlich Beschreibung
img Zeichenfolge Nein Bild-URL
„Video“ Zeichenfolge Nein URL der Videodatei
Miniaturansicht Zeichenfolge Nein Videovorschaubild
buttonText Zeichenfolge Nein Beschriftung der Call-to-Action-Schaltfläche
buttonAction Zeichenfolge Nein Klicken Sie auf die Schaltfläche URL-Ziel
fileSize Ganzzahl Nein Videodateigröße in Bytes
„Dauer“ Ganzzahl Nein Videolänge in Sekunden

Beispiele

Text + Bild + Schaltfläche

Beispiel für Text + Bild + Schaltfläche

{
  "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 + Text + Schaltfläche

Beispiel für Video + Text + Schaltfläche

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

Nur Bild

Nur Bild-Beispiel

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

Nur Text

Nur-Text-Beispiel

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

Nur Video

Nur Video-Beispiel

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

Video + Textbeispiel

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

Transaktionsbenachrichtigungen für zeitkritische Informationen wie Bestellbestätigungen und Quittungen.

Unterstützte Inhalte

  • Nur Text
  • PDF-Datei + Text
  • Nur PDF-Datei

Parameter

Parameter Geben Sie ein Erforderlich Beschreibung
fileUrl Zeichenfolge Nein PDF-Dokument-URL
Dateiname Zeichenfolge Nein Anzeigename für Anhang
fileType Zeichenfolge Nein Dateityp (verwenden Sie „pdf“)

Beispiele

Nur Text

Nur-Text-Beispiel

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

Text + PDF

Text + PDF-Beispiel

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

Nur PDF

Nur PDF-Beispiel

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

Viber-Karussell

Durchsuchbare Präsentation mit mehreren Elementen für Produkte oder Inhalte.

Struktur

Array von Karussellelementen, die jeweils Folgendes enthalten:

  • Titel
  • Bild
  • Primärtaste (Hauptaktion)
  • Sekundärtaste (alternative Aktion)

Parameter

Parameter Geben Sie ein Erforderlich Beschreibung
„Karussell“ Array Ja Array von Karussellelementen
Artikel Array Ja Einzelne Kartenobjekte

Beispiel

Beispiel für ein Viber-Karussell

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

Viber-Umfrage

Interaktive Umfragen und Feedback-Sammlung mit Multiple-Choice-Optionen.

Parameter

Parameter Geben Sie ein Erforderlich Beschreibung
„Umfrage“ Objekt Ja Umfragecontainer
Optionen Array Ja Array mit 1–5 Antwortmöglichkeiten

Einschränkungen

  • Maximal 5 Antwortoptionen unterstützt
  • Jede Option sollte prägnant sein (empfohlen: weniger als 30 Zeichen)

Beispiel

Beispiel für eine Viber-Umfrage

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

Einmalpasswort-Versand mit vordefinierten Vorlagen.

Hauptmerkmale

  • 9 vordefinierte Vorlagen
  • Parametervalidierung (TEXT-, NUMBER-Typen)
  • Mehrsprachige Unterstützung (19 Sprachen)
  • Bei Variablennamen muss die Groß-/Kleinschreibung beachtet werden

Unterstützte Sprachen

Ukrainisch, Englisch, Russisch, Polnisch, Rumänisch, Spanisch, Deutsch, Französisch, Italienisch, Portugiesisch, Niederländisch, Türkisch, Arabisch, Hebräisch, Hindi, Chinesisch, Japanisch, Koreanisch, Vietnamesisch

Parameter

Parameter Geben Sie ein Erforderlich Beschreibung
templateId Zeichenfolge (UUID) Ja Vorlagen-ID
templateLang Zeichenfolge Ja ISO-Sprachcode
templateParams Objekt Ja Variablen, die mit der Vorlage übereinstimmen

Beispiel

Viber OTP-Beispiel

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

Vorlagenbeispiel: „Ihr Code: 123456. Gültig für 10 Minuten. Geben Sie diesen Code niemals weiter.“

Unterstützte Vorlagen und Validierungen

Viber bietet vordefinierte und streng kontrollierte Vorlagen. Die übergebenen Variablenparameter müssen den richtigen Datentypen entsprechen.

Datentypen: - NUMBER: Nur Ziffern „[0-9]“, „+“, „-“ und „.“. Symbole wie „/“ oder Leerzeichen werden nicht unterstützt. - TEXT: Beliebiges Sprachalphabet, Symbole (@#$%^&*().,<>;:!\"'+=-()[]{} \n usw.). - Reguläre Zuordnung: Eine Folge von „“ kann nicht neben einer „“-Folge existieren. Sie erfordern eine Trennung durch Leerzeichen. Doppelte Leerzeichen innerhalb von Vorlagen sind generell verboten. Vermeiden Sie bei Links Leerzeichen, wenn diese die zulässigen Grenzwerte überschreiten.

Nachfolgend finden Sie die 9 Standard-ISO-Vorlagen. Ersetzen Sie IDs basierend auf Ihren Registrierungsanforderungen in bestimmten Ländern. Wenden Sie sich an den Support, wenn Sie weitere Sprachen hinzufügen.

1. „NUR Code (beliebige PIN)“

Anforderungen: Unterstützt PINs in Ziffern und englischen Buchstaben sowie den Symbolen „-“ oder „.“. Die Vorlage muss formatiert werden, damit Ihre Marke zusammen mit der Bestätigungs-PIN richtig angezeigt wird.

2. „Aktion: Bitte verwenden Sie diesen Code“

Parameter: {pin} (NUMMER oder TEXT) Beispielformat: „Bitte verwenden Sie diesen Code {pin} zur Verifizierung.“

3. „Markenregistrierung/Zugriff“

Parameter: „{business_platform_name}“ (TEXT), „{pin}“ (NUMMER oder TEXT) Beispielformat: „Ihr Code für {business_platform_name} ist {pin}.“

4. „Zeitpunkt der Codevalidierung“

Parameter: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Beispielformat: „Ihr Bestätigungscode lautet {pin}. Es ist {code_validity_time} Minuten gültig.“

5. „Markenzugriff und Codevalidierung“

Parameter: „{business_platform_name}“ (TEXT), „{pin}“ (NUMBER/TEXT), „{code_validity_time}“ (NUMBER) Beispielformat: „Der Bestätigungscode für {business_platform_name} ist {pin} für {code_validity_time} Minuten gültig.“

(Hinweis: Es gibt bis zu 9 vordefinierte Strukturblöcke für Viber-Standard-OTP-Regeln, die auf Kombinationen aus der Verwendung von „PIN“, „Business-Plattformname“ und „Code_Gültigkeitszeit“ basieren.

Allgemeine Anforderungen

Für alle Viber-Nachrichtentypen ist Folgendes erforderlich:

  • „von“: Alphanumerische Absender-ID
  • „an“: Telefonnummer im E.164-Format
  • „Typ“: Kennung des Nachrichtentyps
  • ttl: Ablaufzeit der Nachricht in Sekunden (empfohlen)

Rückfall auf SMS

Alle Viber-Nachrichtentypen unterstützen SMS-Fallback mithilfe des Array-Blocks „Fallbacks“. Wenn die Viber-Zustellung fehlschlägt, wird die Nachricht automatisch auf alternativ konfigurierte Kanäle zurückgesetzt.

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-Umfrage -> 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
        }
      ]
    }
  ]
}

Best Practices

Bilder

  • Verwenden Sie das JPG- oder PNG-Format
  • Empfohlene Größe: 800x600 Pixel
  • Halten Sie die Dateigröße unter 1 MB
  • Verwenden Sie HTTPS-URLs

Videos

  • Verwenden Sie das MP4-Format
  • Halten Sie die Dateigröße unter 10 MB
  • Fügen Sie ein Miniaturbild hinzu
  • Geben Sie Dauer und Dateigröße an

Schaltflächen

  • Halten Sie den Schaltflächentext kurz (2–3 Wörter).
  • Verwenden Sie klare Call-to-Action-Formulierungen
  • Verwenden Sie immer HTTPS-URLs
  • Testen Sie URLs vor dem Senden

TTL (Time-to-Live)

  • Werbebotschaften: 24–72 Stunden
  • Transaktionsnachrichten: 24 Stunden
  • OTP-Nachrichten: 5-10 Minuten
  • Umfragen: 7–30 Tage

Nächste Schritte

– SMS-Nachrichten – Erfahren Sie mehr über SMS-Fallback – RCS-Nachrichten – Umfangreiche Kommunikationsdienste - Status prüfen – Verfolgen Sie den Lieferstatus