Gå til indholdet

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

Tekst + billede + knap eksempel

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

Video + tekst + knap eksempel

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

Eksempel på kun billede

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

Kun tekst

Eksempel på kun tekst

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

Kun video

Eksempel på 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

Video + teksteksempel

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

Eksempel på 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

Tekst + PDF-eksempel

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

Kun PDF-eksempel

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

Viber-karruseleksempel

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

Viber-undersøgelseseksempel

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

Viber OTP-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