Help Center Viber-Nachrichten

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

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

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

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

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

Search Results

Viber-Nachrichten

Übersicht über Nachrichtentypen

Viber-Promo

Unterstützte Inhalte

Parameter

Beispiele

Text + Bild + Schaltfläche

Video + Text + Schaltfläche

Nur Bild

Nur Text

Nur Video

Video + Text

Viber-Transaktional

Unterstützte Inhalte

Parameter

Beispiele

Nur Text

Text + PDF

Nur PDF

Viber-Karussell

Struktur

Parameter

Beispiel

Viber-Umfrage

Parameter

Einschränkungen

Beispiel

Viber OTP

Hauptmerkmale

Unterstützte Sprachen

Parameter

Beispiel

Unterstützte Vorlagen und Validierungen

1. „NUR Code (beliebige PIN)“

2. „Aktion: Bitte verwenden Sie diesen Code“

3. „Markenregistrierung/Zugriff“

4. „Zeitpunkt der Codevalidierung“

5. „Markenzugriff und Codevalidierung“

Allgemeine Anforderungen

Rückfall auf SMS

Viber Promo -> SMS-Fallback

Viber-Umfrage -> SMS-Fallback

Viber Trans -> SMS-Fallback

Best Practices

Bilder

Videos

Schaltflächen

TTL (Time-to-Live)

Nächste Schritte