Viber-meddelanden

SMSBAT API stöder flera typer av Viber-meddelanden för olika användningsfall, från reklamkampanjer till transaktionsmeddelanden.

Meddelandetyper Översikt

Skriv	Syfte	Rich Media	Interaktiv
viber_promo	Marknadsföringskampanjer	✅ Bilder, videor	✅ Knappar
viber_trans	Transaktionsmeddelanden	✅ PDF-filer	❌
viber_carousel	Produktutställningar	✅ Bilder	✅ Flera knappar
viber_survey	Omröstningar och feedback	❌	✅ Flera alternativ
viber_otp	Engångslösenord	❌	❌

Viber-kampanj

Marknadsföringsmeddelanden med stöd för rich media för marknadsföringskampanjer.

Innehåll som stöds

• Endast bild
• Endast text
• Text + knapp
• Bild + text + knapp
• Video + text
• Video + text + knapp
• Endast video

Parametrar

Parameter	Skriv	Krävs	Beskrivning
img	sträng	Nej	Bild URL
video	sträng	Nej	Videofil URL
thumbnail	sträng	Nej	Video förhandsgranskning bild
buttonText	sträng	Nej	Uppmaningsknappetikett
buttonAction	sträng	Nej	Knappklick URL destination
filstorlek	heltal	Nej	Videofilstorlek i byte
varaktighet	heltal	Nej	Videolängd i sekunder

Exempel

Text + Bild + Knapp

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

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

Endast bild

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

Endast text

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

Endast 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 + text

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

Transaktionsmeddelanden för tidskänslig information som orderbekräftelser och kvitton.

Innehåll som stöds

• Endast text
• PDF-fil + text
• Endast PDF-fil

Parametrar

Parameter	Skriv	Krävs	Beskrivning
fileUrl	sträng	Nej	PDF-dokument URL
filnamn	sträng	Nej	Visningsnamn för bilaga
filtyp	sträng	Nej	Filtyp (använd “pdf”)

Exempel

Endast text

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

Text + 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
}

Endast PDF

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

Viberkarusell

Bläddringsbar med flera objekt för produkter eller innehåll.

Struktur

En rad karusellföremål, som var och en innehåller:

• Titel
• Bild
• Primär knapp (huvudfunktion)
• Sekundär knapp (alternativ åtgärd)

Parametrar

Parameter	Skriv	Krävs	Beskrivning
karusell	array	Ja	Uppsättning av karusellartiklar
artiklar	array	Ja	Individuella kortobjekt

Exempel

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

Interaktiva omröstningar och insamling av feedback med flervalsalternativ.

Parametrar

Parameter	Skriv	Krävs	Beskrivning
enkät	objekt	Ja	Undersökningsbehållare
alternativ	array	Ja	Uppsättning av 1-5 svarsalternativ

Begränsningar

• Maximalt 5 svarsalternativ stöds
• Varje alternativ bör vara kortfattat (rekommenderas: under 30 tecken)

Exempel

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

Engångslösenordsleverans med fördefinierade mallar.

Nyckelfunktioner

• 9 fördefinierade mallar
• Parametervalidering (TEXT, NUMBER typer)
• Stöd för flera språk (19 språk)
• Skiftlägeskänsliga variabelnamn

Språk som stöds

ukrainska, engelska, ryska, polska, rumänska, spanska, franska, italienska, portugisiska, holländska, turkiska, arabiska, hebreiska, hindi, kinesiska, japanska, koreanska, vietnamesiska

Parametrar

Parameter	Skriv	Krävs	Beskrivning
mallId	sträng (UUID)	Ja	Mallidentifierare
templateLang	sträng	Ja	ISO språkkod
templateParams	objekt	Ja	Variabler matchande mall

Exempel

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

Mallexempel: “Din kod: 123456. Gäller i 10 minuter. Dela aldrig den här koden.”

Mallar och valideringar som stöds

Viber erbjuder fördefinierade och strikt kontrollerade mallar. Variabelparametrarna som skickas måste motsvara de korrekta datatyperna.

Datatyper:

• NUMMER: Endast siffror [0-9], +, - och .. Symboler som / eller blanksteg stöds inte.
• TEXT: Alla språkalfabet, symboler (@#$%^&*().,<>;:!\"'+=-()[]{} \n etc).
• Vanlig mappning: En sekvens med <bokstäver> kan inte existera intill en <nummer>-sekvens; de kräver separation av blanksteg. Dubbla blanksteg inuti mallar är generellt förbjudna. För länkar, undvik mellanslag om de överskrider gränserna.

Nedan finns de 9 standard ISO-mallarna. Ersätt ID:n baserat på dina registreringskrav i specifika länder. Kontakta support om du lägger till ytterligare språk.

1. “ENDAST kod (valfri PIN-kod)”

Krav: Stöder PIN-koder med siffror och engelska bokstäver, symboler ”-” eller ”.”. Mallen kräver formatering för att visa ditt varumärke korrekt tillsammans med verifierings-PIN-koden.

2. “Åtgärd: Använd den här koden”

Parametrar: {pin} (NUMMER eller TEXT) Exempelformat: “Vänligen använd den här koden {pin} för verifiering.”

3. “Varumärkesregistrering/åtkomst”

Parametrar: {business_platform_name} (TEXT), {pin} (NUMBER eller TEXT) Exempelformat: “Din kod för {business_platform_name} är {pin}.“

4. “Kodvalideringstidpunkt”

Parametrar: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Exempelformat: “Din verifieringskod är {pin}. Den är giltig i {code_validity_time} minuter.”

5. “Varumärkesåtkomst och kodvalidering”

Parametrar: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Exempelformat: “verifieringskoden för {business_platform_name} är {pin} giltig i {code_validity_time} minuter.”

(Obs: Det finns upp till 9 fördefinierade strukturella block för Viber-standard OTP-regler baserade på kombinationer av “pin”, “business_platform_name” och “code_validity_time” användning).

Allmänna krav

Alla Viber-meddelandetyper kräver:

• from: Alfanumeriskt avsändar-ID
• till: Telefonnummer i E.164-format
• typ: Meddelandetypsidentifierare
• ttl: Meddelandets utgångstid i sekunder (rekommenderas)

Alternativ till SMS

Alla Viber-meddelandetyper stöder SMS-fallback med hjälp av “fallbacks”-arrayblocket. Om Viber-leverans misslyckas, faller meddelandet automatiskt tillbaka till alternativa konfigurerade 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
        }
      ]
    }
  ]
}

Bästa metoder

Bilder

• Använd JPG- eller PNG-format
• Rekommenderad storlek: 800x600 pixlar
• Håll filstorleken under 1 MB
• Använd HTTPS-URL:er

Videor

• Använd MP4-format
• Håll filstorleken under 10 MB
• Inkludera miniatyrbild
• Ange varaktighet och filstorlek

Knappar

• Håll knapptexten kort (2-3 ord)
• Använd tydliga uppmaningsfraser
• Använd alltid HTTPS-URL:er
• Testa webbadresser innan du skickar

TTL (Time-to-Live)

• Reklammeddelanden: 24-72 timmar
• Transaktionsmeddelanden: 24 timmar
• OTP-meddelanden: 5-10 minuter
• Undersökningar: 7-30 dagar

Nästa steg

• SMS-meddelanden - Lär dig mer om alternativa SMS
• RCS-meddelanden - Rich Communication Services
• Kontrollera status - Spåra leveransstatus