შიგთავსზე გადასვლა

Viber შეტყობინებები

SMSBAT API მხარს უჭერს Viber შეტყობინებების მრავალ ტიპს სხვადასხვა გამოყენების შემთხვევებისთვის, სარეკლამო კამპანიებიდან ტრანზაქციის შეტყობინებებამდე.

შეტყობინების ტიპების მიმოხილვა

ტიპი დანიშნულება მდიდარი მედია ინტერაქტიული
viber_promo მარკეტინგული კამპანიები ✅ სურათები, ვიდეო ✅ ღილაკები
viber_trans ტრანზაქციის შეტყობინებები ✅ PDFs ❌
viber_carousel პროდუქტის ვიტრინები ✅ სურათები ✅ მრავალი ღილაკი
viber_გამოკითხვა გამოკითხვები და გამოხმაურება ❌ ✅ მრავალი ვარიანტი
viber_otp ერთჯერადი პაროლები ❌ ❌

Viber-ის პრომო

სარეკლამო შეტყობინებები მდიდარი მედია მხარდაჭერით მარკეტინგული კამპანიებისთვის.

მხარდაჭერილი კონტენტი

  • მხოლოდ სურათი
  • მხოლოდ ტექსტი
  • ტექსტი + ღილაკი
  • სურათი + ტექსტი + ღილაკი
  • ვიდეო + ტექსტი
  • ვიდეო + ტექსტი + ღილაკი
  • მხოლოდ ვიდეო

პარამეტრები

პარამეტრი ტიპი საჭირო აღწერა
img სიმებიანი არა სურათის URL
ვიდეო სიმებიანი არა ვიდეო ფაილის URL
მინიატურა სიმებიანი არა ვიდეოს გადახედვის სურათი
buttonText სიმებიანი არა Call-to-action ღილაკის ეტიკეტი
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"
  }
}

მხოლოდ ტექსტი

მხოლოდ ტექსტის მაგალითი

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

ტრანზაქციის შეტყობინებები დროისადმი მგრძნობიარე ინფორმაციისთვის, როგორიცაა შეკვეთის დადასტურებები და ქვითრები.

მხარდაჭერილი კონტენტი

  • მხოლოდ ტექსტი
  • PDF ფაილი + ტექსტი
  • მხოლოდ PDF ფაილი

პარამეტრები

პარამეტრი ტიპი საჭირო აღწერა
fileUrl სიმებიანი არა PDF დოკუმენტის URL
ფაილის სახელი სიმებიანი არა საჩვენებელი სახელი დანართისთვის
ფაილის ტიპი სიმებიანი არა ფაილის ტიპი (გამოიყენეთ "pdf")

მაგალითები

მხოლოდ ტექსტი

მხოლოდ ტექსტის მაგალითი

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

ინტერაქტიული გამოკითხვები და გამოხმაურების შეგროვება მრავალჯერადი არჩევანის ვარიანტებით.

პარამეტრები

პარამეტრი ტიპი საჭირო აღწერა
გამოკითხვა ობიექტი დიახ კვლევის კონტეინერი
ოფციები მასივი დიახ 1-5 პასუხის არჩევანის მასივი

შეზღუდვები

  • პასუხის მაქსიმუმ 5 ვარიანტია მხარდაჭერილი
  • თითოეული ვარიანტი უნდა იყოს ლაკონური (რეკომენდირებულია: 30 სიმბოლოზე ნაკლები)

მაგალითი

Viber Survey Example

{
  "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 ენის კოდი
თარგიParams ობიექტი დიახ ცვლადების შესატყვისი შაბლონი

მაგალითი

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 გთავაზობთ წინასწარ განსაზღვრულ და მკაცრად კონტროლირებულ შაბლონებს. გადაცემული ცვლადების პარამეტრები უნდა შეესაბამებოდეს მონაცემთა სწორ ტიპებს.

მონაცემთა ტიპები: - NUMBER: მხოლოდ რიცხვები [0-9], +, - და .. სიმბოლოები, როგორიცაა / ან ცარიელი სივრცე მხარდაუჭერელია. - TEXT: ნებისმიერი ენის ანბანი, სიმბოლოები (@#$%^&*().,<>;:!\"+=-()[]{} \n ა.შ.). - რეგულარული გამოსახვა: <ასო> თანმიმდევრობა არ შეიძლება არსებობდეს <რიცხვი> თანმიმდევრობის გვერდით; ისინი საჭიროებენ უფსკრულის გამოყოფას. ორმაგი უფსკრული `` შაბლონების შიგნით ზოგადად აკრძალულია. ბმულებისთვის, მოერიდეთ სივრცეებს, თუ ისინი აღემატება ლიმიტს.

ქვემოთ მოცემულია 9 სტანდარტული ISO შაბლონი. შეცვალეთ პირადობის მოწმობები თქვენი რეგისტრაციის მოთხოვნების მიხედვით კონკრეტულ ქვეყნებში. დამატებითი ენების დამატების შემთხვევაში დაუკავშირდით მხარდაჭერას.

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} წუთის განმავლობაში."

(შენიშვნა: არის 9-მდე წინასწარ განსაზღვრული სტრუქტურული ბლოკი Viber-ის სტანდარტული OTP წესებისთვის, რომელიც ეფუძნება პინის~,ბიზნეს_პლატფორმის_სახელის~ და `კოდის_ვალიდობის_დროის~ გამოყენების კომბინაციებს).

ზოგადი მოთხოვნები

Viber შეტყობინების ყველა ტიპი მოითხოვს:

  • from: ალფანუმერული გამგზავნის ID
  • to: ტელეფონის ნომერი E.164 ფორმატში
  • type: შეტყობინების ტიპის იდენტიფიკატორი
  • ttl: შეტყობინების ვადის გასვლის დრო წამებში (რეკომენდებულია)

დაბრუნება SMS-ზე

Viber შეტყობინებების ყველა ტიპი მხარს უჭერს SMS სარეზერვო მასივის ბლოკის გამოყენებით. თუ Viber-ის მიწოდება ვერ მოხერხდა, შეტყობინება ავტომატურად ბრუნდება ალტერნატიულ კონფიგურირებულ არხებზე.

Viber-ის პრომო -> SMS გამობრუნება

{
  "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 დღე

შემდეგი ნაბიჯები