Pāriet uz saturu

Viber ziņojumi

SMSBAT API atbalsta vairākus Viber ziņojumu veidus dažādiem lietošanas gadījumiem, sākot no reklāmas kampaņām un beidzot ar darījumu paziņojumiem.

Ziņojumu veidu pārskats

Tips Mērķis Bagātināta multivide Interaktīvs
viber_promo Mārketinga kampaņas ✅ Attēli, video ✅ Pogas
viber_trans Paziņojumi par darījumiem ✅ PDF ❌
viber_carousel Produktu vitrīnas ✅ Attēli ✅ Vairākas pogas
viber_survey Aptaujas un atsauksmes ❌ ✅ Vairākas iespējas
viber_otp Vienreizējās paroles ❌ ❌

Viber Promo

Reklāmas ziņojumi ar bagātinātas multivides atbalstu mārketinga kampaņām.

Atbalstītais saturs

  • Tikai attēls
  • tikai teksts
  • Teksta + poga
  • Attēls + teksts + poga
  • Video + teksts
  • Video + teksts + poga
  • Tikai video

Parametri

Parametrs Tips Nepieciešams Apraksts
"img" stīga Nē Attēla URL
video stīga Nē Video faila URL
"sīktēls" stīga Nē Video priekšskatījuma attēls
"pogas teksts" stīga Nē Aicinājuma uz darbību pogas etiķete
"buttonAction" stīga Nē Noklikšķiniet uz pogas URL galamērķis
faila izmērs vesels skaitlis Nē Video faila lielums baitos
"ilgums" vesels skaitlis Nē Videoklipa garums sekundēs

Piemēri

Teksts + attēls + poga

Teksts + attēls + pogas piemērs

{
  "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 + teksts + poga

Video + teksts + pogas piemērs

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

Tikai attēls

Piemērs tikai attēlam

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

Tikai teksts

Tikai teksta piemērs

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

Tikai video

Piemērs tikai 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 + teksts

Video + teksta piemērs

{
  "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 darījums

Paziņojumi par darījumiem, lai iegūtu informāciju, kas ir svarīga laika ziņā, piemēram, pasūtījumu apstiprinājumi un kvītis.

Atbalstītais saturs

  • tikai teksts
  • PDF fails + teksts
  • tikai PDF fails

Parametri

Parametrs Tips Nepieciešams Apraksts
fileUrl stīga Nē PDF dokumenta URL
faila nosaukums stīga Nē Pielikuma parādāmais nosaukums
fileType stīga Nē Faila tips (izmantojiet "pdf")

Piemēri

Tikai teksts

Tikai teksta piemērs

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

Teksts + PDF

Teksts + PDF piemērs

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

Tikai PDF

Tikai PDF piemērs

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

Viber karuselis

Vairāku vienumu pārlūkojama vitrīna produktiem vai saturam.

Struktūra

Karuseļa vienumu klāsts, katrs satur:

  • Nosaukums
  • Attēls
  • Galvenā poga (galvenā darbība)
  • Sekundārā poga (alternatīva darbība)

Parametri

Parametrs Tips Nepieciešams Apraksts
karuselis masīvs Jā Karuseļa priekšmetu klāsts
"preces" masīvs Jā Atsevišķi karšu objekti

Piemērs

Viber karuseļa piemērs

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

Interaktīvas aptaujas un atsauksmju apkopošana ar atbilžu variantiem.

Parametri

Parametrs Tips Nepieciešams Apraksts
"aptauja" objekts Jā Aptaujas konteiners
"iespējas" masīvs Jā 1–5 atbilžu variantu masīvs

Ierobežojumi

  • Tiek atbalstītas ne vairāk kā 5 atbildes iespējas
  • Katrai opcijai jābūt kodolīgai (ieteicams: mazāk nekā 30 rakstzīmes)

Piemērs

Viber aptaujas piemērs

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

Vienreizēja paroles piegāde ar iepriekš definētām veidnēm.

Galvenās funkcijas

  • 9 iepriekš definētas veidnes
  • Parametru pārbaude (TEXT, NUMBER veidi)
  • Vairāku valodu atbalsts (19 valodas)
  • reģistrjutīgi mainīgo nosaukumi

Atbalstītās valodas

Ukraiņu, angļu, krievu, poļu, rumāņu, spāņu, vācu, franču, itāļu, portugāļu, holandiešu, turku, arābu, ebreju, hindi, ķīniešu, japāņu, korejiešu, vjetnamiešu

Parametri

Parametrs Tips Nepieciešams Apraksts
templateId virkne (UUID) Jā Veidnes identifikators
templateLang stīga Jā ISO valodas kods
templateParams objekts Jā Mainīgie, kas atbilst veidnei

Piemērs

Viber OTP piemērs

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

Veidnes piemērs: "Jūsu kods: 123456. Derīgs 10 minūtes. Nekad nekoplietojiet šo kodu."

Atbalstītās veidnes un validācijas

Viber piedāvā iepriekš noteiktas un stingri kontrolētas veidnes. Nodotajiem mainīgo parametriem jāatbilst pareizajiem datu tipiem.

Datu veidi: - NUMBER: tikai cipari [0-9], +, - un .. Simboli, piemēram, / vai atstarpes, netiek atbalstīti. - TEKSTS: jebkuras valodas alfabēts, simboli (@#$%^&*().,<>;:!\"'+=-()[]{} \n utt.). - Regulāra kartēšana: “” secība nevar pastāvēt blakus secībai “”. tiem nepieciešams atstarpju atdalīšana. Dubultās atstarpes `` veidņu iekšpusē parasti ir aizliegtas. Saitēm izvairieties no atstarpēm, ja tās pārsniedz ierobežojumus.

Zemāk ir 9 standarta ISO veidnes. Nomainiet ID, pamatojoties uz jūsu reģistrācijas prasībām noteiktās valstīs. Ja pievienojat papildu valodas, sazinieties ar atbalsta dienestu.

1. "TIKAI kods (jebkurš PIN)"

Prasības: atbalsta PIN kodus ar cipariem un angļu valodas burtiem, simboliem - vai .. Veidne ir jāformatē, lai jūsu zīmols tiktu pareizi attēlots līdzās verifikācijas PIN.

2. "Darbība: lūdzu, izmantojiet šo kodu"

Parametri: {pin} (SKAITS vai TEKSTS) Formāta piemērs: "Lūdzu, izmantojiet šo kodu {pin} verifikācijai."

3. "Zīmola reģistrācija/piekļuve"

Parametri: {business_platform_name} (TEXT), {pin} (NUMBER vai TEXT) Formāta piemērs: "Jūsu {business_platform_name} kods ir {pin}."

4. "Koda apstiprināšanas laiks"

Parametri: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Formāta piemērs: “Jūsu verifikācijas kods ir {pin}. Tas ir derīgs {code_validity_time} minūtes."

5. "Zīmola piekļuve un koda apstiprināšana"

Parametri: "{business_platform_name}" (TEKSTS), "{pin}" (NUMBER/TEXT), "{code_validity_time}" (NUMBER) Formāta piemērs: "{business_platform_name} verifikācijas kods ir {pin} derīgs {code_validity_time} minūtes."

(Piezīme. Viber standarta OTP kārtulām ir līdz 9 iepriekš definētiem strukturālajiem blokiem, kuru pamatā ir PIN, biznesa_platformas_nosaukums un koda_validitātes_laika lietojuma kombinācijas).

Vispārīgās prasības

Visiem Viber ziņojumu veidiem ir nepieciešams:

  • "no": burtciparu sūtītāja ID
  • "uz": tālruņa numurs E.164 formātā
  • Tips: ziņojuma veida identifikators
  • ttl: ziņojuma derīguma termiņš sekundēs (ieteicams)

Atkāpšanās uz SMS

Visi Viber ziņojumu veidi atbalsta īsziņu atkāpšanos, izmantojot masīva bloku "atkāpšanās". Ja Viber piegāde neizdodas, ziņojums automātiski tiek nosūtīts atpakaļ uz alternatīviem konfigurētiem kanāliem.

Viber Promo -> SMS atkāpšanās

{
  "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 aptauja -> SMS atkāpšanās

{
  "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 atkāpšanās

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

Labākā prakse

Attēli

  • Izmantojiet JPG vai PNG formātu
  • Ieteicamais izmērs: 800x600 pikseļi
  • Saglabājiet faila lielumu zem 1 MB
  • Izmantojiet HTTPS URL

Videoklipi

  • Izmantojiet MP4 formātu
  • Saglabājiet faila lielumu zem 10 MB
  • Iekļaut sīktēlu
  • Norādiet ilgumu un faila lielumu

Pogas

  • Saglabājiet pogas tekstu īsu (2-3 vārdi)
  • Izmantojiet skaidras frāzes, kas aicina uz darbību
  • Vienmēr izmantojiet HTTPS URL
  • Pirms nosūtīšanas pārbaudiet URL

TTL (dzīves laiks)

  • Reklāmas ziņas: 24-72 stundas
  • Darījumu ziņojumi: 24 stundas
  • OTP ziņojumi: 5-10 minūtes
  • Aptaujas: 7-30 dienas

Nākamie soļi