לדלג לתוכן

הודעות SMS

שלח הודעות טקסט רגילות באמצעות SMSBAT API. SMS הוא ערוץ ההודעות האוניברסלי ביותר עם שיעורי המסירה הגבוהים ביותר בכל המכשירים הניידים.

סקירה כללית

SMS (שירות הודעות קצרות) אידיאלי עבור:

  • הודעות קריטיות לזמן
  • חזרה להודעות Viber/RCS
  • הגעה למשתמשים ללא סמארטפונים
  • תאימות אוניברסלית בכל הרשתות הסלולריות
  • שיעורי משלוח גבוהים (95%+)

הודעת SMS בסיסית

בקשה

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

פרמטרים

פרמטר הקלד חובה תיאור
מ מחרוזת כן מזהה שולח אלפאנומרי (עד 11 תווים)
אל מחרוזת כן מספר הטלפון של הנמען בפורמט E.164
סוג מחרוזת כן הגדר ל-"sms"
טקסט מחרוזת כן תוכן ההודעה
customerMessageId מחרוזת לא מזהה המעקב הפנימי שלך
ttl מספר שלם לא זמן לחיות בשניות

דוגמאות

SMS פשוט

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS עם זיהוי לקוח

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS עם TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

קידוד תווים

קידוד GSM 7 סיביות

אלפבית GSM רגיל (160 תווים לכל SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

תווי GSM מורחבים

התווים האלה נחשבים ל-2 תווים:

| ^ € { } [ ] ~ \

קידוד Unicode (UCS-2).

הודעות עם תווים מיוחדים משתמשות בקידוד Unicode (70 תווים לכל SMS):

  • אימוג'י: 😀 🎉 ❤️
  • קירילית: А Б В Г Д Е Ж
  • סמלים מיוחדים: ✓ ✗ ★ ♥

אורך הודעה

SMS בודד

  • GSM 7-bit: 160 תווים
  • Unicode: 70 תווים

SMS מרובה חלקים

כאשר ההודעה שלך חורגת מהמגבלה, היא מחולקת למספר חלקים:

  • GSM 7-bit: 153 תווים לכל חלק
  • Unicode: 67 תווים לכל חלק

דוגמה

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

הודעה זו (201 תווים) תפוצל ל-2 חלקים.

תגובה

תגובת הצלחה

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

שדות תגובה

שדה תיאור
messageId מזהה ייחודי למעקב
סטטוס סטטוס הודעה (מקובל, נדחה)
חלקים מספר חלקי SMS
אל מספר טלפון של הנמען

מזהה השולח

שולח אלפאנומרי

השתמש בשם המותג שלך כשלוח (עד 11 תווים):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

הגבלות:

  • מקסימום 11 תווים
  • אותיות ומספרים בלבד
  • ללא רווחים או תווים מיוחדים
  • הנמען אינו יכול להשיב לשולחים אלפאנומריים

שולח מספרי

השתמש במספר טלפון כשלוח (עבור SMS דו-כיווני):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

מקרי שימוש

אימות OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

הודעות הזמנה

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

תזכורות לפגישה

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

אישורי תשלום

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

שיטות עבודה מומלצות

תוכן הודעה

  • ✅ שמרו על מסרים תמציתיים וברורים
  • ✅ כלול זיהוי השולח
  • ✅ הוסף קריאה לפעולה במידת הצורך
  • ✅ השתמש בדקדוק ובאיות נכונים
  • ❌ הימנעו מסימני פיסוק מוגזמים!!!
  • ❌ אל תשתמש בכל CAPS
  • ❌ הימנע מקצרי כתובות אתרים שנראים חשודים

שימוש בתווים

  • בדוק את ספירת התווים לפני השליחה
  • שימו לב לתווי GSM מורחבים (ספירה כ-2)
  • בדוק עם תווים מיוחדים לפני שליחה בכמות גדולה
  • שקול להשתמש בקידוד GSM עבור הודעות ארוכות יותר

מספרי טלפון

  • השתמש תמיד בפורמט E.164: +380XXXXXXXXX
  • אמת מספרי טלפון לפני השליחה
  • הסר מספרים לא חוקיים מהרשימה שלך
  • עדכן את רשימת אנשי הקשר שלך

תזמון

  • כבד את אזורי הזמן המקומיים
  • הימנע משליחה בלילה (22:00 - 8:00)
  • שקול שעות פעילות להודעות מסחריות
  • הגדר TTL מתאים להודעות רגישות לזמן

תאימות

  • השג הסכמה לפני שליחת הודעות שיווקיות
  • כלול הוראות לביטול הסכמה ל-SMS לקידום מכירות
  • פעל לפי התקנות המקומיות (GDPR וכו')
  • כבד את רשימות "נא לא להפריע".

טיפול בשגיאות

שגיאות נפוצות

שגיאה גורם פתרון
INVALID_RECIPIENT פורמט טלפון שגוי השתמש בפורמט E.164
INVALID_SENDER מזהה שולח לא חוקי בדוק את כללי מזהה השולח
MESSAGE_TOO_LONG חורג מהאורך המקסימלי פיצול או קיצור הודעה
INVALID_ENCODING תווים לא נתמכים השתמש ב-GSM או ביוניקוד

מיטוב עלויות

צמצם חלקי הודעה

  • שמור הודעות מתחת ל-160 תווים (GSM) או 70 (Unicode)
  • הימנע מתווים מיוחדים המפעילים את Unicode
  • השתמש בקיצורים כאשר מתאים
  • הסר רווחים מיותרים

אופטימיזציה לדוגמה

❌ לפני (171 תווים, 2 SMS): 

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ אחרי (156 תווים, 1 SMS): 

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

שליחה בכמות גדולה

שלח מספר הודעות בבקשה אחת:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

השלבים הבאים