לדלג לתוכן

הודעות Viber

SMSBAT API תומך במספר סוגים של הודעות Viber עבור מקרי שימוש שונים, מקמפיינים פרסומיים ועד הודעות עסקאות.

סקירה כללית של סוגי הודעות

הקלד מטרה מדיה עשירה אינטראקטיבי
viber_promo קמפיינים שיווקיים ✅ תמונות, סרטונים ✅ כפתורים
viber_trans הודעות עסקה ✅ קובצי PDF ❌
viber_carousel ויטרינות מוצרים ✅ תמונות ✅ כפתורים מרובים
viber_survey סקרים ומשוב ❌ ✅ אפשרויות מרובות
viber_otp סיסמאות חד פעמיות ❌ ❌

פרומו של Viber

מסרים פרסומיים עם תמיכה במדיה עשירה בקמפיינים שיווקיים.

תוכן נתמך

  • תמונה בלבד
  • טקסט בלבד
  • כפתור טקסט +
  • תמונה + טקסט + כפתור
  • וידאו + טקסט
  • וידאו + טקסט + כפתור
  • וידאו בלבד

פרמטרים

פרמטר הקלד חובה תיאור
img מחרוזת לא כתובת אתר של תמונה
וידאו מחרוזת לא כתובת אתר של קובץ וידאו
תמונה ממוזערת מחרוזת לא תמונה מקדימה של וידאו
כפתורטקסט מחרוזת לא תווית לחצן קריאה לפעולה
buttonAction מחרוזת לא לחץ על לחצן יעד כתובת אתר
גודל קובץ מספר שלם לא גודל קובץ וידאו בבתים
משך מספר שלם לא אורך הסרטון בשניות

דוגמאות

טקסט + תמונה + לחצן

דוגמה של טקסט + תמונה + לחצן

{
  "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 עסקה

הודעות עסקאות עבור מידע רגיש לזמן כמו אישורי הזמנה וקבלות.

תוכן נתמך

  • טקסט בלבד
  • קובץ PDF + טקסט
  • קובץ PDF בלבד

פרמטרים

פרמטר הקלד חובה תיאור
fileUrl מחרוזת לא כתובת אתר של מסמך PDF
שם קובץ מחרוזת לא שם תצוגה לקובץ מצורף
fileType מחרוזת לא סוג קובץ (השתמש ב-"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

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

{
  "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 מציעה תבניות מוגדרות מראש ובשליטה קפדנית. פרמטרי המשתנים המועברים חייבים להתאים לסוגי הנתונים הנכונים.

סוגי נתונים: - NUMBER: רק ספרות [0-9], +, - ו-.. סמלים כמו / או רווח לבן אינם נתמכים. - TEXT: כל אלפבית בשפה, סמלים (@#$%^&*().,<>;:!\"'+=-()[]{} \n וכו'). - מיפוי רגיל: רצף של <אותיות> אינו יכול להתקיים בצמוד לרצף <number>; הם דורשים הפרדת רווחים לבנים. רווחים כפולים בתוך תבניות אסורים בדרך כלל. עבור קישורים, הימנע מרווחים אם הם חורגים מהמגבלות.

להלן 9 תבניות ISO סטנדרטיות. החלף מזהים על סמך דרישות הרישום שלך במדינות ספציפיות. צור קשר עם התמיכה אם אתה מוסיף שפות נוספות.

1. "קוד בלבד (כל 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 בלוקים מבניים מוגדרים מראש עבור כללי OTP סטנדרטיים של Viber המבוססים על שילובים של השימוש ב-'pin', 'business_platform_name' ו-'code_validity_time').

דרישות כלליות

כל סוגי הודעות Viber דורשים:

  • מאת: מזהה שולח אלפאנומרי
  • אל: מספר טלפון בפורמט E.164
  • סוג: מזהה סוג הודעה
  • ttl: זמן תפוגת ההודעה בשניות (מומלץ)

חזרה ל-SMS

כל סוגי הודעות Viber תומכים ב-SMS fallback תוך שימוש בגוש מערך ה-'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 פיקסלים
  • שמור על גודל קובץ מתחת ל-1MB
  • השתמש בכתובות URL של HTTPS

סרטונים

  • השתמש בפורמט MP4
  • שמור על גודל קובץ מתחת ל-10MB
  • כלול תמונה ממוזערת
  • ציין משך וגודל קובץ

כפתורים

  • הקפד על טקסט כפתור קצר (2-3 מילים)
  • השתמש בביטויי קריאה לפעולה ברורים
  • השתמש תמיד בכתובות URL של HTTPS
  • בדוק כתובות אתרים לפני השליחה

TTL (זמן לחיות)

  • הודעות קידום מכירות: 24-72 שעות
  • הודעות עסקה: 24 שעות
  • הודעות OTP: 5-10 דקות
  • סקרים: 7-30 ימים

השלבים הבאים