Viber-berichten

SMSBAT API ondersteunt meerdere soorten Viber-berichten voor verschillende gebruiksscenario's, van promotiecampagnes tot transactiemeldingen.

Overzicht berichttypen

Typ	Doel	Rijke media	Interactief
`viber_promo`	Marketingcampagnes	✅ Afbeeldingen, video's	✅ Knoppen
`viber_trans`	Transactionele meldingen	✅ PDF's	❌
`viber_carrousel`	Productvitrines	✅ Afbeeldingen	✅ Meerdere knoppen
`viber_enquête`	Opiniepeilingen en feedback	❌	✅ Meerdere opties
`viber_otp`	Eenmalige wachtwoorden	❌	❌

Viber-promotie

Promotionele berichten met rijke media-ondersteuning voor marketingcampagnes.

Ondersteunde inhoud

-Alleen afbeelding - Alleen tekst - Tekst + knop - Afbeelding + tekst + knop - Video + tekst - Video + tekst + knop - Alleen video

Parameters

Parameter	Typ	Vereist	Beschrijving
`img`	tekenreeks	Nee	Afbeeldings-URL
`video`	tekenreeks	Nee	URL van videobestand
`miniatuur`	tekenreeks	Nee	Videovoorbeeldafbeelding
`knopTekst`	tekenreeks	Nee	Label met call-to-action-knop
`knopActie`	tekenreeks	Nee	Knop-klik-URL-bestemming
`bestandsgrootte`	geheel getal	Nee	Videobestandsgrootte in bytes
`duur`	geheel getal	Nee	Videolengte in seconden

Voorbeelden

Tekst + afbeelding + knop

{
  "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 + Tekst + Knop

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

Alleen afbeelding

Alleen afbeelding voorbeeld

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

Alleen tekst

Alleen tekstvoorbeeld

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

Alleen video

Alleen videovoorbeeld

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

Video + tekstvoorbeeld

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

Transactiemeldingen voor tijdgevoelige informatie zoals orderbevestigingen en ontvangstbewijzen.

Ondersteunde inhoud

Alleen tekst -PDF-bestand + tekst -Alleen PDF-bestand

Parameters

Parameter	Typ	Vereist	Beschrijving
`bestandUrl`	tekenreeks	Nee	PDF-document-URL
`bestandsnaam`	tekenreeks	Nee	Weergavenaam voor bijlage
`bestandstype`	tekenreeks	Nee	Bestandstype (gebruik "pdf")

Voorbeelden

Alleen tekst

Alleen tekstvoorbeeld

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

Tekst + PDF

Tekst + PDF-voorbeeld

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

Alleen PDF

Alleen PDF-voorbeeld

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

Viber-carrousel

Doorzoekbare showcase met meerdere items voor producten of inhoud.

Structuur

Een reeks carrouselitems, elk met:

Titel
Afbeelding
Primaire knop (hoofdactie)
Secundaire knop (alternatieve actie)

Parameters

Parameter	Typ	Vereist	Beschrijving
`carrousel`	array	Ja	Array van carrouselartikelen
`artikelen`	array	Ja	Individuele kaartobjecten

Voorbeeld

Viber-carrouselvoorbeeld

{
  "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-enquête

Interactieve peilingen en feedbackverzameling met meerkeuzemogelijkheden.

Parameters

Parameter	Typ	Vereist	Beschrijving
`enquête`	voorwerp	Ja	Enquêtecontainer
`opties`	array	Ja	Array van 1-5 antwoordkeuzes

Beperkingen

Maximaal 5 antwoordopties ondersteund
Elke optie moet beknopt zijn (aanbevolen: minder dan 30 tekens)

Voorbeeld

Viber-enquêtevoorbeeld

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

Eenmalige wachtwoordlevering met vooraf gedefinieerde sjablonen.

Belangrijkste kenmerken

9 vooraf gedefinieerde sjablonen
Parametervalidatie (TEXT, NUMBER typen)
Meertalige ondersteuning (19 talen)
Hoofdlettergevoelige namen van variabelen

Ondersteunde talen

Oekraïens, Engels, Russisch, Pools, Roemeens, Spaans, Duits, Frans, Italiaans, Portugees, Nederlands, Turks, Arabisch, Hebreeuws, Hindi, Chinees, Japans, Koreaans, Vietnamees

Parameters

Parameter	Typ	Vereist	Beschrijving
`sjabloonId`	tekenreeks (UUID)	Ja	Sjabloon-ID
`sjabloonLang`	tekenreeks	Ja	ISO-taalcode
`templateParams`	voorwerp	Ja	Variabelen die overeenkomen met sjabloon

Voorbeeld

Viber OTP-voorbeeld

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

Sjabloonvoorbeeld: 'Uw code: 123456. 10 minuten geldig. Deel deze code nooit.'

Ondersteunde sjablonen en validaties

Viber biedt vooraf gedefinieerde en strikt gecontroleerde sjablonen. De doorgegeven variabelenparameters moeten overeenkomen met de juiste gegevenstypen.

Gegevenstypen: - NUMBER: alleen cijfers [0-9], +, - en .. Symbolen zoals / of witruimte worden niet ondersteund. - TEKST: elk taalalfabet, symbolen (@#$%^&*().,<>;:!\"'+=-()[]{} \n enz.). - Reguliere toewijzing: een reeks <letters> kan niet naast een reeks <nummer> bestaan; ze vereisen scheiding van witruimte. Dubbele spaties binnen sjablonen zijn over het algemeen verboden. Vermijd spaties bij koppelingen als deze de limiet overschrijden.

Hieronder staan de 9 standaard ISO-sjablonen. Vervang ID's op basis van uw registratievereisten in specifieke landen. Neem contact op met de ondersteuning als u extra talen toevoegt.

1. "ALLEEN code (elke pincode)"

Vereisten: Ondersteunt pincodes in cijfers en Engelse letters, symbolen - of .. De sjabloon vereist opmaak om uw merk correct weer te geven naast de verificatiepincode.

2. "Actie: gebruik deze code"

Parameters: {pin} (NUMMER of TEKST) Voorbeeldformaat: 'Gebruik deze code {pin} ter verificatie.'

3. "Merkregistratie/toegang"

Parameters: {business_platform_name} (TEKST), {pin} (NUMBER of TEKST) Voorbeeldformaat: "Uw code voor {business_platform_name} is {pin}."

4. "Tijd voor codevalidatie"

Parameters: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Voorbeeldformaat: 'Uw verificatiecode is {pin}. Het is geldig voor {code_validity_time} minuten."

5. "Merktoegang en codevalidatie"

Parameters: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Voorbeeldnotatie: "{business_platform_name} verificatiecode is {pin} geldig gedurende {code_validity_time} minuten."

(Opmerking: er zijn maximaal 9 vooraf gedefinieerde structurele blokken voor de standaard OTP-regels van Viber, gebaseerd op combinaties van het gebruik van pin, business_platform_name en code_validity_time).

Algemene vereisten

Voor alle Viber-berichttypen is het volgende vereist:

van: alfanumerieke afzender-ID
naar: Telefoonnummer in E.164-formaat
type: Identificatie van het berichttype
ttl: vervaltijd van bericht in seconden (aanbevolen)

Terugval op sms

Alle Viber-berichttypen ondersteunen SMS-fallback met behulp van het 'fallbacks'-arrayblok. Als de bezorging van Viber mislukt, valt het bericht automatisch terug naar alternatief geconfigureerde kanalen.

Viber-promotie -> SMS-terugval

{
  "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-enquête -> SMS-terugval

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

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

Beste praktijken

Afbeeldingen

Gebruik het JPG- of PNG-formaat
Aanbevolen formaat: 800x600 pixels
Houd de bestandsgrootte onder de 1 MB
Gebruik HTTPS-URL's

Video's

Gebruik het MP4-formaat
Houd de bestandsgrootte onder de 10 MB
Inclusief miniatuurafbeelding
Geef de duur en bestandsgrootte op

Knoppen

Houd de knoptekst kort (2-3 woorden)
Gebruik duidelijke call-to-action-zinnen
Gebruik altijd HTTPS-URL's
Test URL's voordat u ze verzendt

TTL (Time-to-Live)

Promotionele berichten: 24-72 uur
Transactionele berichten: 24 uur
OTP-berichten: 5-10 minuten
Enquêtes: 7-30 dagen

Volgende stappen

SMS-berichten - Meer informatie over sms-fallback
RCS-berichten - Rijke communicatiediensten
Status controleren - Volg de leveringsstatus