Help Center הודעות SMS

הודעות 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"
    }
  ]
}

השלבים הבאים