Անցնել պարունակությանը

Viber հաղորդագրություններ

SMSBAT API-ն աջակցում է Viber հաղորդագրությունների մի քանի տեսակների օգտագործման տարբեր դեպքերի համար՝ սկսած գովազդային արշավներից մինչև գործարքների ծանուցումներ:

Հաղորդագրության տեսակների ակնարկ

Տեսակ Նպատակը Rich Media Ինտերակտիվ
«viber_promo» Մարքեթինգային արշավներ ✅ Նկարներ, տեսանյութեր ✅ Կոճակներ
«viber_trans» Գործարքների ծանուցումներ ✅ PDF ֆայլեր ❌
«viber_carousel» Ապրանքի ցուցափեղկեր ✅ Նկարներ ✅ Բազմաթիվ կոճակներ
«viber_survey» Հարցումներ և արձագանքներ ❌ ✅ Բազմաթիվ տարբերակներ
«viber_otp» Միանվագ գաղտնաբառեր ❌ ❌

Viber Promo

Գովազդային հաղորդագրություններ՝ հարուստ մեդիա աջակցությամբ մարքեթինգային արշավների համար:

Աջակցվող բովանդակություն

  • Միայն պատկեր
  • Միայն տեքստ
  • Տեքստ + կոճակ
  • Պատկեր + տեքստ + կոճակ
  • Տեսանյութ + տեքստ
  • Տեսանյութ + տեքստ + կոճակ
  • Միայն տեսանյութ

Պարամետրեր

Պարամետր Տեսակ Պահանջվում է Նկարագրություն
«img» լարային Ոչ Պատկերի URL
«տեսանյութ» լարային Ոչ Տեսանյութի ֆայլի URL
«մանրապատկեր» լարային Ոչ Տեսանյութի նախադիտման պատկեր
«buttonText» լարային Ոչ Գործողության կոչի կոճակի պիտակ
«buttonAction» լարային Ոչ Կոճակը սեղմեք URL նպատակակետ
«ֆայլի չափը» ամբողջ թիվ Ոչ Վիդեո ֆայլի չափը բայթերով
«տեւողություն» ամբողջ թիվ Ոչ Տեսանյութի տևողությունը վայրկյաններով

Օրինակներ

Տեքստ + Պատկեր + Կոճակ

Տեքստ + պատկեր + կոճակի օրինակ

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

Տեսանյութ + Տեքստ + Կոճակ

Տեսանյութ + տեքստ + կոճակի օրինակ

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

Միայն պատկեր

Միայն պատկերի օրինակ

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

Միայն տեքստ

Text Only Example

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

Միայն տեսանյութ

Միայն տեսանյութի օրինակ

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Տեսանյութ + Տեքստ

Տեսանյութ + տեքստային օրինակ

{
  "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 գործարք

Գործարքների մասին ծանուցումներ ժամանակին զգայուն տեղեկատվության համար, ինչպիսիք են պատվերի հաստատումները և ստացականները:

Աջակցվող բովանդակություն

  • Միայն տեքստ
  • PDF ֆայլ + տեքստ
  • Միայն PDF ֆայլ

Պարամետրեր

Պարամետր Տեսակ Պահանջվում է Նկարագրություն
«fileUrl» լարային Ոչ PDF փաստաթղթի URL
«ֆայլի անուն» լարային Ոչ Ցուցադրվող անունը հավելվածի համար
«fileType» լարային Ոչ Ֆայլի տեսակը (օգտագործեք «pdf»)

Օրինակներ

Միայն տեքստ

Text Only Example

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

Տեքստ + PDF

Տեքստ + 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
}

Միայն PDF

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 կարուսել

Ապրանքների կամ բովանդակության համար բազմաբնույթ զննարկվող ցուցափեղկ:

Կառուցվածք

Կարուսելի իրերի զանգված, որոնցից յուրաքանչյուրը պարունակում է.

  • Կոչում
  • Պատկեր
  • Հիմնական կոճակ (հիմնական գործողություն)
  • Երկրորդական կոճակ (այլընտրանքային գործողություն)

Պարամետրեր

Պարամետր Տեսակ Պահանջվում է Նկարագրություն
«կարուսել» զանգված Այո Կարուսելի իրերի զանգված
«իրեր» զանգված Այո Առանձին քարտի օբյեկտներ

Օրինակ

Viber Carousel Example

{
  "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 Հարցում

Ինտերակտիվ հարցումներ և հետադարձ կապի հավաքագրում՝ բազմակի ընտրությամբ:

Պարամետրեր

Պարամետր Տեսակ Պահանջվում է Նկարագրություն
«հարցում» օբյեկտ Այո Հարցման տարա
«տարբերակներ» զանգված Այո 1-5 պատասխանների ընտրանի

Սահմանափակումներ

  • Աջակցվում է առավելագույնը 5 պատասխանի տարբերակ
  • Յուրաքանչյուր տարբերակ պետք է լինի հակիրճ (խորհուրդ է տրվում՝ մինչև 30 նիշ)

Օրինակ

Viber Survey Օրինակ

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

Գաղտնաբառի մեկանգամյա առաքում նախապես սահմանված ձևանմուշներով:

Հիմնական հատկանիշները

  • 9 նախապես սահմանված ձևանմուշներ
  • Պարամետրերի վավերացում (TEXT, NUMBER տեսակներ)
  • Բազմալեզու աջակցություն (19 լեզու)
  • Մեծատառերի զգայուն փոփոխականների անուններ

Աջակցվող լեզուներ

ուկրաիներեն, անգլերեն, ռուսերեն, լեհերեն, ռումիներեն, իսպաներեն, գերմաներեն, ֆրանսերեն, իտալերեն, պորտուգալերեն, հոլանդերեն, թուրքերեն, արաբերեն, եբրայերեն, հինդի, չինարեն, ճապոներեն, կորեերեն, վիետնամերեն

Պարամետրեր

Պարամետր Տեսակ Պահանջվում է Նկարագրություն
«templateId» տող (UUID) Այո Կաղապարի նույնացուցիչ
«templateLang» լարային Այո ISO լեզվի կոդը
«templateParams» օբյեկտ Այո Կաղապարի համապատասխան փոփոխականներ

Օրինակ

Viber OTP Օրինակ

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

Կաղապարի օրինակ՝ «Ձեր կոդը՝ 123456։ Վավերական է 10 րոպե։ Երբեք մի՛ տարածեք այս կոդը»։

Աջակցվող կաղապարներ և վավերացումներ

Viber-ն առաջարկում է նախապես սահմանված և խիստ վերահսկվող կաղապարներ։ Անցած փոփոխականների պարամետրերը պետք է համապատասխանեն տվյալների ճիշտ տեսակներին:

Տվյալների տեսակները: - ԹԻՎ. Միայն «[0-9]», «+», «-» և «.» թվերը: Խորհրդանիշները, ինչպիսիք են /-ն կամ բացատը, չեն աջակցվում: - TEXT. ցանկացած լեզվի այբուբեն, նշաններ (@#$%^&*().,<>;:!\"'+=-()[]{} \n և այլն): - Կանոնավոր քարտեզագրում. «<տառերի>» հաջորդականությունը չի կարող գոյություն ունենալ «<համար» հաջորդականությանը կից; նրանք պահանջում են բացատների տարանջատում: Կաղապարների ներսում կրկնակի բացատները սովորաբար արգելված են: Հղումների համար խուսափեք բացատներից, եթե դրանք գերազանցում են սահմանները:

Ստորև ներկայացված են 9 ստանդարտ ISO ձևանմուշները: Փոխարինեք ID-ները՝ հիմնվելով որոշակի երկրներում գրանցման ձեր պահանջների վրա: Լրացուցիչ լեզուներ ավելացնելու դեպքում կապվեք աջակցության հետ:

1. «ՄԻԱՅՆ Կոդ (ցանկացած PIN)»

Պահանջներ. Աջակցում է թվերով և անգլերեն տառերով PIN-երը, «-» կամ «.» նշանները: Կաղապարը պահանջում է ֆորմատավորում՝ ստուգման PIN-ի կողքին ձեր ապրանքանիշը պատշաճ կերպով ցուցադրելու համար:

2. «Գործողություն. խնդրում ենք օգտագործել այս կոդը»

Պարամետրեր՝ «{pin}» (NUMBER կամ TEXT) Օրինակի ձևաչափ. «Խնդրում ենք օգտագործել այս կոդը {pin} հաստատման համար»:

3. «Բրենդի գրանցում/մուտք»

Պարամետրեր՝ «{business_platform_name}» (TEXT), «{pin}» (NUMBER կամ TEXT) Օրինակի ձևաչափ. «{business_platform_name}-ի ձեր կոդը {pin} է»:

4. «Կոդերի վավերացման ժամկետներ»

Պարամետրեր՝ «{pin}» (NUMBER/TEXT), «{code_validity_time}» (NUMBER) Օրինակի ձևաչափ. «Ձեր հաստատման կոդը {pin} է: Այն վավեր է {code_validity_time} րոպե։

5. «Բրենդի մուտք և կոդի վավերացում»

Պարամետրեր՝ «{business_platform_name}» (TEXT), «{pin}» (NUMBER/TEXT), «{code_validity_time}» (NUMBER) Օրինակ ձևաչափ. «{business_platform_name} հաստատման կոդը {pin} վավեր է {code_validity_time} րոպե»:

(Նշում․ Viber-ի ստանդարտ OTP կանոնների համար կան մինչև 9 նախապես սահմանված կառուցվածքային բլոկներ՝ հիմնված «pin»-ի, «business_platform_name»-ի և «code_validity_time»-ի օգտագործման համակցությունների վրա):

Ընդհանուր պահանջներ

Viber հաղորդագրությունների բոլոր տեսակները պահանջում են.

  • «from»՝ այբբենական թվային ուղարկողի ID
  • «to»՝ հեռախոսահամար E.164 ձևաչափով
  • «տեսակ». Հաղորդագրության տեսակի նույնացուցիչ
  • ttl. հաղորդագրության ժամկետը վայրկյաններով (խորհուրդ է տրվում)

Հետադարձ SMS-ին

Viber-ի բոլոր հաղորդագրությունների տեսակներն աջակցում են SMS-ի հետադարձ՝ օգտագործելով «fallbacks» զանգվածի բլոկը: Եթե Viber-ի առաքումը ձախողվի, հաղորդագրությունն ավտոմատ կերպով վերադառնում է այլընտրանքային կազմաձևված ալիքներ:

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

Լավագույն պրակտիկա

Պատկերներ

  • Օգտագործեք JPG կամ PNG ձևաչափ
  • Առաջարկվող չափսը՝ 800x600 պիքսել
  • Պահպանեք ֆայլի չափը 1 ՄԲ-ից ցածր
  • Օգտագործեք HTTPS URL-ներ

Տեսանյութեր

  • Օգտագործեք MP4 ձևաչափը
  • Պահպանեք ֆայլի չափը 10 ՄԲ-ից ցածր
  • Ներառեք մանրապատկերի պատկերը
  • Նշեք տեւողությունը և ֆայլի չափը

կոճակներ

  • Կոճակի տեքստը կարճ պահեք (2-3 բառ)
  • Գործողության կոչի հստակ արտահայտություններ օգտագործեք
  • Միշտ օգտագործեք HTTPS URL-ներ
  • Ստուգեք URL-ները նախքան ուղարկելը

TTL (Ապրելու ժամանակը)

  • Գովազդային հաղորդագրություններ՝ 24-72 ժամ
  • Գործարքային հաղորդագրություններ՝ 24 ժամ
  • OTP հաղորդագրություններ՝ 5-10 րոպե
  • Հարցումներ՝ 7-30 օր

Հաջորդ քայլերը