Help Center Viber सन्देशहरू

Viber सन्देशहरू

SMSBAT API ले प्रचार अभियानदेखि लेनदेन सूचनाहरू सम्म विभिन्न प्रकारका भाइबर सन्देशहरूलाई विभिन्न प्रयोगका अवस्थामा समर्थन गर्दछ।

सन्देशका प्रकारहरू अवलोकन

प्रकारउद्देश्यरिच मिडियाअन्तरक्रियात्मक
viber_promoमार्केटिङ अभियान✅ तस्विर, भिडियो✅ बटन
viber_transलेनदेन सूचनाहरू✅ PDF हरू❌
viber_carouselउत्पादन प्रदर्शनी✅ छविहरू✅ धेरै बटनहरू
viber_surveyपोल र प्रतिक्रिया❌✅ बहु विकल्प
viber_otpएक पटकको पासवर्ड❌❌

भाइबर प्रोमो

मार्केटिङ अभियानहरूको लागि रिच मिडिया समर्थनको साथ प्रचार सन्देशहरू।

समर्थित सामग्री

  • छवि मात्र
  • पाठ मात्र
  • पाठ + बटन
  • छवि + पाठ + बटन
  • भिडियो + पाठ
  • भिडियो + पाठ + बटन
  • भिडियो मात्र

प्यारामिटरहरू

प्यारामिटरप्रकारआवश्यकविवरण
imgस्ट्रिङछैनछवि URL
’भिडियो’स्ट्रिङछैनभिडियो फाइल URL
थम्बनेलस्ट्रिङछैनभिडियो पूर्वावलोकन छवि
बटनपाठस्ट्रिङछैनकल-टू-एक्शन बटन लेबल
’बटन कार्य’स्ट्रिङछैनबटन क्लिक 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
  }
}

भाइबर लेनदेन

समय-संवेदनशील जानकारीको लागि लेनदेन सूचनाहरू जस्तै अर्डर पुष्टिकरणहरू र रसिदहरू।

समर्थित सामग्री

  • पाठ मात्र
  • 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
}

भाइबर क्यारोसेल

उत्पादन वा सामग्रीको लागि बहु-वस्तु ब्राउजयोग्य प्रदर्शन।

संरचना

क्यारोसेल वस्तुहरूको एर्रे, प्रत्येक समावेश:

  • शीर्षक
  • छवि
  • प्राथमिक बटन (मुख्य कार्य)
  • माध्यमिक बटन (वैकल्पिक कार्य)

प्यारामिटरहरू

प्यारामिटरप्रकारआवश्यकविवरण
’क्यारोसेल’arrayहोक्यारोसेल वस्तुहरूको एरे
वस्तुarrayहोव्यक्तिगत कार्ड वस्तुहरू

उदाहरण

Viber Carousel उदाहरण

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

भाइबर सर्वेक्षण

अन्तर्क्रियात्मक मतदान र बहुविध विकल्प विकल्पहरूको साथ प्रतिक्रिया संग्रह।

प्यारामिटरहरू

प्यारामिटरप्रकारआवश्यकविवरण
सर्वेक्षणवस्तुहोसर्वेक्षण कन्टेनर
विकल्पarrayहो1-5 उत्तर विकल्पहरूको एरे

बाधाहरू

  • अधिकतम 5 प्रतिक्रिया विकल्पहरू समर्थित
  • प्रत्येक विकल्प संक्षिप्त हुनुपर्छ (सिफारिस गरिएको: 30 वर्णहरू भन्दा कम)

उदाहरण

Viber सर्वेक्षण उदाहरण

{
  "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 प्रकारहरू)
  • बहु-भाषा समर्थन (१९ भाषाहरू)
  • केस-संवेदनशील चर नामहरू

समर्थित भाषाहरू

युक्रेनी, अंग्रेजी, रुसी, पोलिश, रोमानियाली, स्पेनिश, जर्मन, फ्रान्सेली, इटालियन, पोर्चुगिज, डच, टर्की, अरबी, हिब्रू, हिन्दी, चिनियाँ, जापानी, कोरियाली, भियतनामी

प्यारामिटरहरू

प्यारामिटरप्रकारआवश्यकविवरण
टेम्प्लेटआईडीस्ट्रिङ (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 मिनेटको लागि मान्य। यो कोड कहिल्यै साझा नगर्नुहोस्।“

समर्थित टेम्प्लेट र प्रमाणीकरणहरू

भाइबरले पूर्वनिर्धारित र कडाइका साथ नियन्त्रित टेम्प्लेटहरू प्रदान गर्दछ। पास गरिएका चर प्यारामिटरहरू सही डेटा प्रकारहरूसँग मेल खानुपर्छ।

डेटा प्रकार:

  • NUMBER: केवल अंकहरू [0-9], +, -, र .। / वा व्हाइटस्पेस जस्ता प्रतीकहरू असमर्थित छन्।
  • TEXT: कुनै पनि भाषा वर्णमाला, प्रतीकहरू (@#$%^&*().,<>;:!\"'+=-()[]{} \n आदि)।
  • नियमित म्यापिङ: <अक्षर> को अनुक्रम <number> अनुक्रमको छेउमा अवस्थित हुन सक्दैन; तिनीहरूले सेतोस्पेस विभाजन आवश्यक छ। डबल ह्वाइटस्पेस “ भित्र टेम्प्लेटहरू सामान्यतया निषेधित छन्। लिङ्कहरूको लागि, यदि तिनीहरूले सीमा नाघ्यो भने खाली ठाउँहरू बेवास्ता गर्नुहोस्।

तल 9 मानक ISO टेम्प्लेटहरू छन्। विशेष देशहरूमा तपाईंको दर्ता आवश्यकताहरूको आधारमा आईडीहरू बदल्नुहोस्। यदि थप भाषाहरू थप्दै हुनुहुन्छ भने समर्थनलाई सम्पर्क गर्नुहोस्।

१. “कोड मात्र (कुनै पनि पिन)”

आवश्यकताहरू: अंक र अंग्रेजी अक्षर, प्रतीक - वा . मा PIN लाई समर्थन गर्दछ। टेम्प्लेटलाई प्रमाणिकरण पिनको साथमा तपाईंको ब्रान्ड ठीकसँग प्रदर्शन गर्न ढाँचा चाहिन्छ।

२. “कार्य: कृपया यो कोड प्रयोग गर्नुहोस्”

प्यारामिटरहरू: {pin} (NUMBER वा TEXT) उदाहरण ढाँचा: “प्रमाणीकरणको लागि कृपया यो कोड {pin} प्रयोग गर्नुहोस्।“

३. “ब्रान्ड दर्ता/पहुँच”

प्यारामिटरहरू: {business_platform_name} (TEXT), {pin} (NUMBER वा TEXT) उदाहरण ढाँचा: “तपाईंको {business_platform_name} को कोड {pin} हो।“

४. “कोड प्रमाणीकरण समय”

पैरामिटरहरू: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) उदाहरण ढाँचा: “तपाईँको प्रमाणिकरण कोड {pin} हो। यो {code_validity_time} मिनेटको लागि मान्य छ।“

५. “ब्रान्ड पहुँच र कोड प्रमाणीकरण”

प्यारामिटरहरू: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) उदाहरण ढाँचा: “{business_platform_name} प्रमाणीकरण कोड {pin} {code_validity_time} मिनेटको लागि मान्य छ।”

(नोट: Viber मानक OTP नियमहरूको लागि pin, business_platform_name, र code_validity_time प्रयोगको संयोजनमा आधारित ९ सम्म पूर्वनिर्धारित संरचनात्मक ब्लकहरू छन्।

सामान्य आवश्यकताहरू

सबै Viber सन्देश प्रकारहरू आवश्यक छ:

  • बाट: अल्फान्यूमेरिक प्रेषक ID
  • to: फोन नम्बर E.164 ढाँचामा
  • प्रकार: सन्देश प्रकार पहिचानकर्ता
  • ttl: सन्देशको म्याद सकिने समय सेकेन्डमा (सिफारिस गरिएको)

SMS मा फर्कनुहोस्

सबै भाइबर सन्देश प्रकारहरूले ‘फलब्याक’ एरे ब्लक प्रयोग गरेर एसएमएस फलब्याक समर्थन गर्दछ। यदि भाइबर डेलिभरी असफल भयो भने, सन्देश स्वतः वैकल्पिक कन्फिगर गरिएका च्यानलहरूमा फर्किन्छ।

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

भाइबर सर्वेक्षण -> एसएमएस फलब्याक

{
  "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 पिक्सेल
  • फाइल साइज १ एमबी भन्दा कम राख्नुहोस्
  • HTTPS URL हरू प्रयोग गर्नुहोस्

भिडियोहरू

  • MP4 ढाँचा प्रयोग गर्नुहोस्
  • फाइल साइज १० एमबी भन्दा कम राख्नुहोस्
  • थम्बनेल छवि समावेश गर्नुहोस्
  • अवधि र फाइल साइज निर्दिष्ट गर्नुहोस्

बटनहरू

  • बटन पाठ छोटो राख्नुहोस् (2-3 शब्दहरू)
  • स्पष्ट कल-टु-एक्शन वाक्यांशहरू प्रयोग गर्नुहोस्
  • सधैं HTTPS URL हरू प्रयोग गर्नुहोस्
  • पठाउनु अघि URL हरू परीक्षण गर्नुहोस्

TTL (समय-टु-लाइभ)

  • प्रचार सन्देशहरू: 24-72 घण्टा
  • लेनदेन सन्देशहरू: 24 घण्टा
  • OTP सन्देशहरू: 5-10 मिनेट
  • सर्वेक्षणहरू: 7-30 दिन

अर्को चरणहरू