המערכת מאפשרת לך לבצע בדיקה של סטטוס קמפיין ששלחת לפי קוד קמפיין
את קוד הקמפיין המערכת שולחת בעת החזרת תשובה לבקשת השליחה
קוד הקמפיין מופיע לאחר הערך OK במידה והשליחה התקבלה בהצלחה במערכת
על מנת לקבל את סטטוס הקמפיין יש לפנות לכתובת הבאה:
https://www.micropay.co.il/extApi/taskStatus.php
רשימת פרמטרים לביצוע פנייה לממשק
token – טוקן שיצרת במערכת, עם הרשאה לשירותי טלפוניה או סמס
ניתן לפתוח ולנהל את הטוקנים על ידי כניסה למערכת, לחיצה על האייקון הירוק למעלה משמאל, ובחירה באפשרות "טוקנים לממשקים"
tid – קוד הקמפיין שברצונך לבדוק את הסטטוס שלו
תת מנהל יכול לבדוק סטטוס קמפיין על ידי שליחת token שמוגדר לתת מנהל
קביעת שיטת השליחה: GET או POST
ניתן לשלוח את הפרמטרים בשיטת GET או POST
במידה ואתה מבצע את השליחה בשיטת GET יש להוסיף את הפרמטר: get=1
במידה ואתה שולח בשיטת POST יש להוסיף את הפרמטר post=2
שים לב, הגדרת הפרמטר אינה משנה את שיטת השליחה, אלא רק מגדירה למערכת את סוג השליחה שבחרת
אתה צריך לבצע את השליחה בשיטה המתאימה בקוד עצמו
תשובת המערכת
המערכת תחזיר את אחד מהסטטוסים הבאים:
pending – הקמפיין ממתין לריצה
running – הקמפיין נמצא כרגע בריצה
done – הקמפיין בוצע והסתיים בהצלחה
stop – הקמפיין נמצא בתהליך עצירה עקב בקשת ביטול
empty – הקמפיין בוצע אולם לא נמצאו טלפונים לשליחה (בשליחה לרשימות תפוצה כאשר הרשימה ריקה)
cancel – הקמפיין נעצר באמצע הריצה עקב בקשת ביטול
error – הקמפיין נעצר באמצע הריצה עקב תקלה
noMsgLeft – הקמפיין נעצר באמצע הריצה עקב סיום יתרת ההודעות בחשבון
na – קוד הקמפיין לא היה קיים במערכת, שגוי או שהקמפיין נמחק
בשלושת הסטטוסים הבאים: cancel, error, noMsgLeft המערכת תחזיר בנוסף לסטטוס, רשימה של מספרי טלפון שלא קיבלו את ההודעה עקב עצירת הקמפיין (במידה ויש כאלו)
מספרי הטלפון יופיעו בשורה חדשה מתחת לסטטוס והם יופרדו בפסיקים, להלן דוגמא לתשובת מערכת עם רשימת טלפונים:
noMsgLeft
0545554446,0558887773,0529098887
להלן דוגמא לשליחת בקשה לקבלת סטטוס משימה בשיטת GET:
https://www.micropay.co.il/extApi/taskStatus.php?get=1&token=xxxxx&tid=123456