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 दिन

अर्को चरणहरू

SMS Messages - SMS फलब्याक बारे जान्नुहोस्
RCS Messages - रिच कम्युनिकेशन सेवाहरू
स्थिति जाँच गर्नुहोस् - डेलिभरी स्थिति ट्र्याक गर्नुहोस्