API לשליחת SMS
המערכת שלכם כבר יודעת מתי לשלוח: הזמנה שאושרה, תור שנקבע, קוד שצריך לאמת. ה-API מוציא את המסרון בפועל, מהמספר או משם השולח המאומת שלכם.
curl -X POST https://api.exm.co.il/v1/sms/send/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sender": "052-7654321",
"destination": "050-1234567",
"message": "הקוד שלכם: 4821"
}'מה שולחים דרך ה-API
תזכורות ועדכונים
תזכורת לפגישה, אישור הזמנה, עדכון על משלוח שיצא לדרך. מסרון קצר במקום שיחת טלפון שאף אחד לא רוצה לעשות.
תגובה לאירוע במערכת
הזמנה שהוכנה לאיסוף, תשלום שנקלט, פנייה שנסגרה. האירוע קורה אצלכם והמסרון יוצא באותו רגע, בלי שאף אחד צריך לזכור.
קודי אימות
קוד חד-פעמי (OTP) יוצא מהשרת שלכם ברגע שהמשתמש מבקש להתחבר, והתשובה חוזרת מיד עם מזהה ההודעה.
מבצעים וברכות
ברכה לחג, מבצע שמותאם ללקוח מסוים, עדכון שמוצר חזר למלאי - עם השם והפרטים שכבר יושבים אצלכם במערכת.
איך שולחים בפועל
אותה יכולת, שלוש דרכים להגיע אליה. בוחרים אחת.
-
לתיעוד המתודה
בקוד למפתחים
בקשת HTTP מכל שפה - PHP, Python, Node או כל דבר אחר שיודע לפנות לכתובת.
-
למודול אקסטרה ב-Make
במודול Make לאנשי אוטומציה
למודול אקסטרה ב-Make יש פעולת שליחת SMS מוכנה. גוררים אותה לתרחיש ומחברים לטופס, לגיליון או למערכת ניהול הלקוחות.
-
ליומן ההודעות
ידנית מהאיזור האישי לכל אחד
כותבים ושולחים מיומן ההודעות, בלי שום כלי. נוח לבדיקה מהירה של המזהה והנוסח לפני שמחברים מערכת.
הבקשה והתשובה
שדות הבקשה
| שדה | מה מכניסים |
|---|---|
message |
תוכן ההודעה. עברית, אנגלית או שילוב. |
destination |
מספר הנייד של מי שאמור לקבל את ההודעה. |
sender |
המספר או השם שמהם ההודעה יוצאת, מתוך המזהים המאומתים של החשבון שלכם. |
התשובה
{
"success": true,
"id": "3yEIZ4jLcT5",
"messages_count": {
"sent": 1,
"charged": 1
}
}וכשמשהו משתבש
{
"success": false,
"errors": [
{
"id": "destination",
"code": 7526,
"description": "Missing destination number, or invalid"
}
]
}מה צריך כדי להתחיל
-
חשבון אקסטרה
ה-API עובד מעל כל חשבון אקסטרה, ולא משנה אילו שירותים פעילים בו.
-
מפתח API
מפיקים אותו לבד באיזור האישי, בעמוד מפתחות ה-API. אותו מפתח פותח את כל מתודות ה-API, ולא רק את שליחת המסרונים - כך שולחים אותו בכל בקשה.
-
מזהה שולח מאומת
המסרון יוצא ממזהה שאימתתם מראש בעמוד המזהים המאומתים: כל מספר שלכם, או שם שולח באותיות לועזיות. כך הנמען רואה מי פנה אליו, ולא מספר אקראי.
-
הפעלת שליחת SMS ב-API
השלב האחרון נפתח מולנו: מאשרים את התנאים, אנחנו מפעילים את השירות בחשבון, ומאותו רגע הבקשות עוברות.
שאלות על API לשליחת SMS
-
כמה זמן לוקח להתחיל לשלוח?
אחרי שהחשבון פעיל, ההגדרה עצמה קצרה: מפיקים מפתח API בעמוד המפתחות, מאמתים את מזהה השולח שממנו ההודעות ייצאו, ומבקשים מאיתנו להפעיל את שליחת ה-SMS ב-API. האימות של מזהה השולח הוא בדרך כלל מה שקובע את הקצב.
-
אפשר לשלוח מהשם של העסק במקום ממספר טלפון?
כן. מזהה השולח יכול להיות מספר טלפון או שם שולח באותיות לועזיות, ובלבד שאימתתם אותו מראש בעמוד המזהים המאומתים ואישרנו לו הרשאת שליחת מסרונים. לשם שולח יש מגבלה אחת שכדאי להכיר: הנמען לא יכול להשיב להודעה, כי אין מספר לחזור אליו.
-
ההודעה נשלחה אבל חויבנו על שני חלקים. למה?
מסרון נמדד בחלקים, ובעברית כל חלק קצר בהרבה מאשר באנגלית. השדה messages_count בתשובה מדווח בדיוק לכמה חלקים ההודעה פוצלה ועל כמה מהם חויבתם, כך שאפשר לראות את זה כבר בזמן השליחה ולא רק בחשבונית.
-
מה קורה כשהמספר שגוי או לא יכול לקבל מסרונים?
התשובה חוזרת עם success: false וקוד שגיאה שמסביר בדיוק מה קרה: מספר חסר או לא תקין, מספר שאינו ישראלי, או מכשיר כשר שחסום לקבלת מסרונים. ההודעה לא יוצאת.
-
אפשר לשלוח מסרונים בלי לכתוב קוד?
כן. אותה יכולת זמינה גם כמודול מוכן ב-Make, כך שאפשר לחבר אותה לטפסים, לגיליונות או למערכת ניהול הלקוחות שלכם בלי לכתוב שורת קוד. אם אתם כבר עובדים עם Make, זו הדרך המהירה יותר להתחיל.
-
איפה רואים את ההודעות שנשלחו?
כל הודעה שיוצאת דרך ה-API נרשמת ביומן ההודעות באיזור האישי, יחד עם ההודעות שנשלחו ידנית. המזהה שחוזר בתשובה לבקשה הוא אותו מזהה של הרשומה ביומן, כך שאפשר לקשר בין מה שקרה אצלכם במערכת לבין מה שיצא בפועל.
-
יש הגבלה על כמות ההודעות?
אין תקרה קבועה שמפורסמת כאן. שליחה בהיקפים גדולים או בפרצים חדים היא משהו שכדאי לתאם איתנו מראש, כדי שנוודא שהחשבון והמזהה שלכם ערוכים לזה ושההודעות לא ייתקעו בדרך.
מוכנים לשלוח?
פותחים חשבון, מאמתים את המזהה שממנו תשלחו, ומתחילים.
מפתח ה-API מחכה לכם באיזור האישי. משם זו בקשת HTTP אחת.
להנפקת מפתח API למפתחות ה-API שלי לתיעוד השליחה
כבר לקוחות? המפתח מחכה באיזור האישי.
