לדלג לתוכן

API של SMSBAT

SMSBAT היא פלטפורמת API RESTful לשליחת הודעות מסוגים שונים, כולל קרוסלת Viber, דיאלוג דעה של Viber, פרומו של Viber (תמונות, וידאו), צ'אט עסקי של Viber, התראות OTP (Viber OTP, Flash Call) וגרסאות החזר שלהם.

כתובת האתר הבסיסית

בקשות ל-SMSBAT API מועברות לנקודת קצה עם לוקליזציה. בקש את הכתובת מהמנהל שלך מראש.

דוגמה: https://restapi.smsbat.com (כתובת האתר בפועל עשויה להשתנות בהתאם לאזור שלך)

אימות

SMSBAT API תומך בשלוש שיטות אימות:

שיטה 1: HTTP Basic Auth

השתמש בשם המשתמש והסיסמה שלך:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

שיטה 2: כותרת מפתח API

השתמש בכותרת 'X-Authorization-Key':

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

שיטה 3: מפתח API כסיסמה

השתמש ב-'@' בתור שם משתמש ובמפתח ה-API שלך כסיסמה:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

נקודות קצה זמינות

שיטה נקודת קצה תיאור
פוסט /bat/messagelist שלח הודעות
קבל /bat/message/{messageId} בדוק את מצב ההודעה

סוגי הודעות

SMSBAT API תומך בסוגי ההודעות הבאים:

  • SMS - הודעות טקסט רגילות
  • Viber Promo - הודעות קידום מכירות עם מדיה עשירה
  • Viber Transactional - הודעות על עסקה
  • Viber Carousel - הודעות קרוסלה אינטראקטיביות
  • סקר Viber - הודעות דו-שיח של דעות
  • Viber OTP - הודעות סיסמה חד פעמיות
  • RCS - הודעות עשירות בשירותי תקשורת
  • שיחת פלאש - אימות שיחה שקטה

תכונות עיקריות

הודעות סתירה

כאשר המסירה הראשית נכשלת, SMSBAT חוזר אוטומטית לערוצים חלופיים:

Viber → SMS → Email

תמיכה במדיה עשירה

שלח הודעות עם:

  • תמונות (JPG, PNG)
  • סרטונים (MP4)
  • קובצי PDF
  • כפתורים וקישורי פעולה

מעקב אחר סטטוס הודעה

עקוב אחר מצב המסירה בזמן אמת:

  • נשלח
  • נמסר
  • קרא
  • נכשל
  • פג תוקף

התקשרויות חוזרות

קבל התקשרויות נכנסות להודעות Viber לתקשורת דו-כיוונית.

התחלה מהירה

  1. שלח הודעה - למד כיצד לשלוח את ההודעה הראשונה שלך
  2. בדוק סטטוס - עקוב אחר מצב מסירת ההודעות
  3. סוגי הודעות - חקור סוגי הודעות שונים

פורמט בקשה

כל הבקשות משתמשות בפורמט JSON עם המבנה הבא:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

פורמט תגובה

תגובות מוצלחות חוזרות:

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

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

קודי מצב HTTP:

  • 200 בסדר - הבקשה הצליחה
  • 400 בקשה שגויה - פורמט בקשה לא חוקי
  • 401 לא מורשה - האימות נכשל
  • 429 בקשות רבות מדי - חרגת ממגבלת התעריף
  • 500 שגיאת שרת פנימית - שגיאת שרת

השלבים הבאים