על מנת לקבל הודעות סמס נכנסות מלקוחות לשרת שלך, עליך לפתוח במערכת שירות סמס שנקרא "טקסט דינמי"
בשירות תצטרך להגדיר כתובת של עמוד אינטרנט אליו תפנה המערכת ברגע שהודעת סמס תתקבל מלקוח
המערכת תפנה לעמוד שלך בפרוטוקול HTTP סטנדרטי, בשיטת GET, כלומר, כל הפרמטרים של הבקשה ישורשרו לכתובת שתגדיר בשירות
להלן רשימת הפרמטרים שהמערכת שולחת
origsms – תוכן ההודעה המלא כפי ששלח אותו הלקוח
זהו התוכן המקורי והמלא של ההודעה שהתקבלה מהלקוח
phone – מספר הטלפון ממנו נשלחה ההודעה
cid – קוד השירות שהופעל במערכת
dest – מספר הטלפון שאליו שלח המשתמש את ההודעה
msgid – קוד יחודי שמיוצר על ידי המערכת לכל הודעה שנשלחת למשתמשים
code – מילת הקוד ששלח המשתמש
המערכת מאפשרת לך להגדיר לכל שירות מילת קוד וכך להפעיל מספר שירותים שונים על אותו מספר טלפון
המערכת לוקחת את הטקסט מתחילת ההודעה עד התו הראשון שאינו אות או מספר, ומגדירה אותו כמילת הקוד
בפרמטר code אתה תקבל את מילת הקוד שהמערכת שלפה מתוכן ההודעה
sms – תוכן ההודעה ששלח המשתמש
תוכן הסמס יחשב כתוכן שהתקבל לאחר מילת הקוד, ולכן אם לדוגמא הלקוח שלח: שלום אני רוצה לקבל את השירות
מילת הקוד תהיה "שלום" ותוכן הסמס יהיה "אני רוצה לקבל את השירות"
net – מספר המסמל את הרשת אליה שייך המשתמש
97250 – פלאפון, 97252 – סלקום, 97254 – פרטנר, 97253 – הוט מובייל, 97258 – גולן טלקום, 97255 – כל המפעילים הוירטואליים
התשובה שהעמוד שלך צריך להחזיר
המערכת מצפה לקבל תשובה חוזרת מהעמוד שלך ובמידה ולא תתקבל תשובה תקינה המערכת תחשיב זאת כשגיאה, תסמן זאת כשגיאה בדוחות, ותשלח מייל התראה לכתובת המייל להתראות טכניות שמוגדרת בחשבון שלך במערכת
החזרת תשובה למערכת מתבצעת על ידי print, echo, response.write או כל פקודה אחרת שמוציאה פלט, כאשר יש לדאוג לא להוציא שום פלט אחר, כגון: תגי HTML, טקסט וכדומה.
חובה שהעמוד יחזיר ב- HEADER קוד HTTP 200, כל קוד HTTP אחר שיוחזר יחשב כשגיאה והמערכת תחזיר הודעת שגיאה קבועה אוטומטית למשתמש
באפשרותך להחזיר שתי סוגי תשובות למערכת:
במידה ואינך רוצה להחזיר שום הודעה חוזרת ללקוח, יש לרשום את המילה: OK או להחזיר עמוד ריק
אם מחזירים את המילה OK, חשוב לרשום אותה באותיות גדולות, ללא שום תגים, רווחים, טקסט נוסף וכדומה
במידה ואתה רוצה להחזיר הודעה ללקוח, יש לרשום את תוכן ההודעה בלבד
תוכן ההודעה יכול להיות כל טקסט שתבחר, ויכול להכיל עד 1000 תווים
שים לב, החזרת תשובה ארוכה מ- 1000 תווים תגרום להחזרת הודעת שגיאה קבועה של המערכת ללקוח
דוגמא לפנייה לעמוד שלך
אם לדוגמא העמוד שהגדרת בשירות "טקסט דינמי" הוא:
http://www.mysite.com/getSms.php
המערכת תפנה לעמוד שלך בצורה הבאה:
http://www.mysite.com/getSms.php?origsms=This+is+a+test+message &phone=0501234567&cid=12762&dest=034567890 &msgid=00705d38b642d5423 &code=This&sms=is+a+test+message&net=97250