Viber-beskeder

SMSBAT API understøtter flere typer af Viber-beskeder til forskellige brugstilfælde, fra salgsfremmende kampagner til transaktionsmeddelelser.

Oversigt over meddelelsestyper

Skriv	Formål	Rich Media	Interaktiv
viber_promo	Marketingkampagner	✅ Billeder, videoer	✅ Knapper
viber_trans	Transaktionsmeddelelser	✅ PDF’er	❌
viber_karrusel	Produktfremvisninger	✅ Billeder	✅ Flere knapper
viber_survey	Afstemninger og feedback	❌	✅ Flere muligheder
viber_otp	Engangsadgangskoder	❌	❌

Viber-kampagne

Salgsfremmende budskaber med rich media support til marketingkampagner.

Understøttet indhold

• Kun billede
• Kun tekst
• Tekst + knap
• Billede + tekst + knap
• Video + tekst
• Video + tekst + knap
• Kun video

Parametre

Parameter	Skriv	Påkrævet	Beskrivelse
img	streng	Nej	Billed-URL
video	streng	Nej	Videofil URL
thumbnail	streng	Nej	Video preview-billede
knaptekst	streng	Nej	Opfordring til handling knap etiket
buttonAction	streng	Nej	Knap klik URL destination
filstørrelse	heltal	Nej	Videofilstørrelse i bytes
varighed	heltal	Nej	Videolængde i sekunder

Eksempler

Tekst + Billede + Knap

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

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

Kun billede

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

Kun tekst

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

Kun 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 + tekst

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

Transaktionsmeddelelser for tidsfølsomme oplysninger som ordrebekræftelser og kvitteringer.

Understøttet indhold

• Kun tekst
• PDF-fil + tekst
• Kun PDF-fil

Parametre

Parameter	Skriv	Påkrævet	Beskrivelse
filUrl	streng	Nej	PDF-dokument URL
filnavn	streng	Nej	Vist navn for vedhæftet fil
filtype	streng	Nej	Filtype (brug “pdf”)

Eksempler

Kun tekst

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

Tekst + PDF

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

Kun PDF

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

Viber-karrusel

Udstillingsvindue for produkter eller indhold, der kan gennemses med flere elementer.

Struktur

Array af karruselartikler, som hver indeholder:

• Titel
• Billede
• Primær knap (hovedfunktion)
• Sekundær knap (alternativ handling)

Parametre

Parameter	Skriv	Påkrævet	Beskrivelse
karrusel	række	Ja	Udvalg af karruselartikler
varer	række	Ja	Individuelle kortobjekter

Eksempel

{
  "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-undersøgelse

Interaktive afstemninger og feedbackindsamling med flere valgmuligheder.

Parametre

Parameter	Skriv	Påkrævet	Beskrivelse
undersøgelse	objekt	Ja	Opmålingsbeholder
indstillinger	række	Ja	Række af 1-5 svarvalg

Begrænsninger

• Maksimalt 5 svarmuligheder understøttes
• Hver mulighed skal være kortfattet (anbefalet: under 30 tegn)

Eksempel

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

Engangsadgangskodelevering med foruddefinerede skabeloner.

Nøglefunktioner

• 9 foruddefinerede skabeloner
• Parametervalidering (TEKST, NUMBER typer)
• Understøttelse af flere sprog (19 sprog)
• Versalfølsomme variabelnavne

Understøttede sprog

ukrainsk, engelsk, russisk, polsk, rumænsk, spansk, tysk, fransk, italiensk, portugisisk, hollandsk, tyrkisk, arabisk, hebraisk, hindi, kinesisk, japansk, koreansk, vietnamesisk

Parametre

Parameter	Skriv	Påkrævet	Beskrivelse
skabelonId	streng (UUID)	Ja	Skabelon-id
templateLang	streng	Ja	ISO sprogkode
templateParams	objekt	Ja	Variable matchende skabelon

Eksempel

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

Skabeloneksempel: “Din kode: 123456. Gyldig i 10 minutter. Del aldrig denne kode.”

Understøttede skabeloner og valideringer

Viber tilbyder foruddefinerede og strengt kontrollerede skabeloner. Variableparametrene, der sendes, skal svare til de korrekte datatyper.

Datatyper:

• NUMMER: Kun tal [0-9], +, - og .. Symboler som ”/” eller mellemrum understøttes ikke.
• TEKST: Ethvert sprogalfabet, symboler (@#$%^&*().,<>;:!\"'+=-()[]{} \n osv.).
• Regelmæssig mapping: En sekvens af <bogstaver> kan ikke eksistere ved siden af en <nummer>-sekvens; de kræver adskillelse af mellemrum. Dobbelte mellemrum inde i skabeloner er generelt forbudt. For links skal du undgå mellemrum, hvis de overskrider grænserne.

Nedenfor er de 9 standard ISO-skabeloner. Erstat ID’er baseret på dine registreringskrav i specifikke lande. Kontakt support, hvis du tilføjer yderligere sprog.

1. “KUN Kode (enhver PIN-kode)”

Krav: Understøtter PIN-koder med tal og engelske bogstaver, symboler - eller .. Skabelonen kræver formatering for at vise dit brand korrekt sammen med bekræftelses-PIN-koden.

2. “Handling: Brug venligst denne kode”

Parametre: {pin} (NUMMER eller TEKST) Eksempelformat: “Brug venligst denne kode {pin} til bekræftelse.”

3. “Mærkeregistrering/adgang”

Parametre: {business_platform_name} (TEXT), {pin} (NUMBER eller TEXT) Eksempelformat: “Din kode for {business_platform_name} er {pin}.“

4. “Code Validation Timing”

Parametre: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Eksempelformat: “Din bekræftelseskode er {pin}. Den er gyldig i {code_validity_time} minutter.”

5. “Mærkeadgang og kodevalidering”

Parametre: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Eksempelformat: “Bekræftelseskoden for {business_platform_name} er {pin} gyldig i {code_validity_time} minutter.”

(Bemærk: Der er op til 9 foruddefinerede strukturelle blokke til Viber-standard OTP-regler baseret på kombinationer af “pin”, “business_platform_name” og “code_validity_time” brug).

Generelle krav

Alle Viber-meddelelsestyper kræver:

• fra: Alfanumerisk afsender-id
• til: Telefonnummer i E.164-format
• type: Meddelelsestype-id
• ttl: Beskedens udløbstid i sekunder (anbefales)

Tilbage til SMS

Alle Viber-meddelelsestyper understøtter SMS-faldback ved at bruge “fallbacks”-array-blokken. Hvis Viber-levering mislykkes, falder beskeden automatisk tilbage til alternative konfigurerede kanaler.

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

Bedste praksis

Billeder

• Brug JPG- eller PNG-format
• Anbefalet størrelse: 800x600 pixels
• Hold filstørrelsen under 1 MB
• Brug HTTPS URL’er

Videoer

• Brug MP4-format
• Hold filstørrelsen under 10 MB
• Inkluder miniaturebillede
• Angiv varighed og filstørrelse

Knapper

• Hold knaptekst kort (2-3 ord)
• Brug klare opfordringer til handling
• Brug altid HTTPS URL’er
• Test URL’er før afsendelse

TTL (Time-to-Live)

• Salgsfremmende beskeder: 24-72 timer
• Transaktionsmeddelelser: 24 timer
• OTP-beskeder: 5-10 minutter
• Undersøgelser: 7-30 dage

Næste trin

• SMS-beskeder - Få mere at vide om SMS-faldback
• RCS-meddelelser - Rich Communication Services
• Kontroller status - Spor leveringsstatus