Gå till innehållet

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

Text + bild + knappexempel

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

Video + text + knappexempel

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

Exempel endast bild

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

Endast text

Exempel endast text

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

Endast video

Endast videoexempel

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

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

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

Text + PDF-exempel

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

Endast PDF-exempel

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

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

Viber-undersökningsexempel

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

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