ממשק API לשליחת SMS (סמס) מאפשר לחבר את מערכות העסק שלכם ישירות לשירות הודעות הטקסט. API סמס של TextMe תומך בשפות תכנות מרובות ומספק תיעוד מפורט.

מה זה SMS API?

SMS API (ממשק תכנות יישומים) הוא דרך לשלוח הודעות SMS באופן תכנותי מתוך אפליקציה, אתר או מערכת עסקית. במקום לשלוח הודעות ידנית דרך ממשק, ה-API מאפשר לאוטומט את כל התהליך.

עם SMS API, המערכת שלכם שולחת בקשה לשרת ה-SMS, והשרת דואג לשלוח את ההודעה לנמען. התהליך כולו לוקח שניות ספורות, מה שהופך את SMS API לפתרון אידיאלי לשליחת הודעות אוטומטיות בזמן אמת.

למה להשתמש ב-SMS API?

SMS API מאפשר לעסקים להטמיע שליחת הודעות כחלק אינטגרלי מהמערכות שלהם:

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

שימושים נפוצים ל-SMS API

אימות דו-שלבי (OTP)

אחד השימושים הנפוצים ביותר ב-SMS API הוא שליחת קודי אימות חד-פעמיים (OTP). כשמשתמש מתחבר לאפליקציה או מבצע פעולה רגישה, המערכת שולחת SMS עם קוד לאימות זהותו.

  • אימות הרשמה למערכת
  • אישור עסקאות כספיות
  • שחזור סיסמה
  • אימות דו-שלבי (2FA)

התראות אוטומטיות

שלחו התראות אוטומטיות ללקוחות על אירועים חשובים:

  • אישור הזמנה
  • עדכון סטטוס משלוח
  • תזכורת לתור
  • התראת תשלום
  • שינוי בלוח זמנים

שיווק אוטומטי

הפעילו קמפיינים שיווקיים אוטומטיים על בסיס התנהגות הלקוח:

  • ברכת יום הולדת עם קופון
  • תזכורת עגלה נטושה
  • הפעלה מחדש של לקוח רדום
  • המלצת מוצרים משלימים

SMS API של TextMe

ה-API של TextMe תוכנן להיות פשוט, מהיר ואמין:

REST API

ה-API מבוסס REST ומחזיר תשובות ב-JSON. קל לשלב עם כל שפת תכנות: PHP, Python, Node.js, Java, C#, Ruby ועוד.

תכונות ה-API

  • שליחת SMS יחיד – שלחו הודעה למספר בודד
  • שליחה המונית – שלחו לרשימה שלמה בקריאה אחת
  • סטטוס מסירה – בדקו אם ההודעה נמסרה
  • Webhooks – קבלו התראה אוטומטית על שינוי סטטוס
  • ניהול אנשי קשר – הוסיפו, עדכנו ומחקו אנשי קשר דרך ה-API
  • 201 תווים – כל הודעה תומכת בעד 201 תווים בעברית

אבטחה

ה-API מאובטח עם:

  • הצפנת SSL/TLS
  • אימות באמצעות API Key
  • Rate limiting למניעת שימוש לרעה
  • IP whitelisting (אופציונלי)

אינטגרציות ללא קוד

לא צריכים לכתוב קוד? TextMe משתלבת עם פלטפורמות אוטומציה פופולריות:

Zapier

חברו את TextMe ל-5,000+ אפליקציות דרך Zapier. צרו "Zaps" שמפעילים שליחת SMS אוטומטית כשמתרחש אירוע באפליקציה אחרת:

  • הזמנה חדשה ב-Shopify → SMS אישור
  • טופס חדש ב-Google Forms → SMS תודה
  • תשלום ב-Stripe → SMS קבלה

Make (Integromat)

צרו תרחישי אוטומציה מורכבים עם Make. שלבו שליחת SMS בתהליכי עבודה מתקדמים עם לוגיקה מותנית, עיבוד נתונים, ושילוב מספר מערכות.

שפות תכנות נתמכות

ה-API של TextMe עובד עם כל שפת תכנות שתומכת בבקשות HTTP:

  • PHP – ספריית SDK מוכנה
  • Python – שימוש ב-requests
  • Node.js – שימוש ב-axios/fetch
  • Java – שימוש ב-HttpClient
  • C# / .NET – שימוש ב-HttpClient
  • cURL – לבדיקות ולסקריפטים

מדריך למפתחים: איך עובדים עם ה-API

איך SMS API עובד בפועל

  1. המערכת שלכם שולחת בקשת POST לכתובת https://my.textme.co.il/api, בפורמט JSON או XML.
  2. השרת מאמת את ה-Token שנשלח בכותרת Authorization: Bearer.
  3. ההודעה נשלחת לנמענים, והשרת מחזיר תשובה באותו פורמט שבו נשלחה הבקשה.
  4. דוח המסירה והתשובות של הנמענים מגיעים אליכם ב-Webhook, או שאפשר למשוך אותם בקריאת דוחות.

לבדיקות יש סביבת ניסיון בכתובת https://my.textme.co.il/api/test, כך שאפשר לפתח בלי לשלוח הודעות אמיתיות.

קבלת Token

  • את ה-Token הראשון יוצרים בממשק החשבון, במסך "ניהול Token API". את הבאים אפשר ליצור גם דרך ה-API.
  • ה-Token מוצג פעם אחת בלבד, ולכן שמרו אותו במקום בטוח.
  • אפשר להחזיק עד 5 Tokens פעילים במקביל.
  • לעולם אל תחשפו את ה-Token בקוד צד לקוח (בדפדפן או באפליקציה). השתמשו בו רק בצד השרת.

Webhooks: קבלת עדכונים בזמן אמת

במקום לשאול את השרת שוב ושוב אם ההודעה נמסרה, מגדירים בממשק החשבון כתובת URL, ו-TextMe שולחת אליה בקשת POST בכל פעם שמתרחש אירוע:

  • הודעה נכנסת – נמען השיב להודעה. מקבלים את תוכן ההודעה, מספר השולח והתאריך, כך שהתשובות נכנסות ישירות ל-CRM או למערכת שלכם.
  • דוח מסירה (DLR) – סטטוס המסירה של כל הודעה, עם המזהה החיצוני ששלחתם, כדי לשייך אותו לרשומה אצלכם.
  • חסימה או הסרה – נמען חסם את קבלת ההודעות.

הכתובת שלכם צריכה להחזיר 200 OK. אם היא מחזירה תשובה אחרת, המערכת מנסה שוב במשך זמן מה ואז מפסיקה.

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

  • אבטחה – שמרו את ה-Token במשתני סביבה ולא בקוד, ועבדו רק ב-HTTPS.
  • טיפול בשגיאות – בדקו את הסטטוס שחוזר בכל תשובה, הוסיפו ניסיון חוזר עם המתנה הולכת וגדלה, ותעדו שגיאות בלוג.
  • ביצועים – בשליחה לרשימה, שלחו לכמה נמענים בקריאה אחת במקום קריאה נפרדת לכל נמען, וכבדו את מגבלת הבקשות.
  • מעקב – שלחו מזהה חיצוני לכל נמען, כדי שתוכלו לחבר את דוח המסירה לרשומה המתאימה אצלכם.

דוגמאות קוד מלאות ב-cURL, PHP, Python ו-Node.js נמצאות בעמוד המפתחים, והתיעוד המלא ב-docs.textme.co.il.

איך מתחילים?

  • שלב 1 – פתחו חשבון TextMe
  • שלב 2 – צרו Token במסך "ניהול Token API" בממשק החשבון
  • שלב 3 – קראו את התיעוד
  • שלב 4 – שלחו את ההודעה הראשונה

כל התהליך לוקח דקות ספורות. התיעוד כולל דוגמאות קוד מוכנות לכל שפה.

מפתחים? עברו לעמוד API לשליחת SMS למפתחים עם דוגמאות קוד מוכנות ב-cURL, PHP, Python ו-Node.js, כולל חיבור API לסמס וקבלת הודעות נכנסות (webhook).