API - גישת מפתחים למערכות

[eliyahu]

ניהול קבצי קמפיין

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

כדי לנהל את קבצי הקמפיין יש לציין את הנתיבים הבאים בפרמטרים what ו-target

הודעת קמפיין קולי

tpl:${templateId}

הודעת קמפיין sms

tpl:${templateId}:tts

הודעה לפני ניתוב

tpl:${templateId}:MoreInfo

[eliyahu]

יצירת תבנית קמפיין חדשה

הערה: ההגדרות של הקמפיין החדש יועתקו מקמפיין ברירת המחדל

הפקודה היא - CreateTemplate

הפרמטרים הנדרשים

פרמטר	תיאור
token	טוקן
description	שם הקמפיין

מאפייני תגובת השרת

מאפיין	סוג	ערך
templateId	int	מזהה התבנית החדשה שנוצרה

[eliyahu]

מחיקת תבנית קמפיין

הפקודה היא - DeleteTemplate

הפרמטרים הנדרשים

פרמטר	תיאור
token	טוקן
templateId	מזהה תבנית

אין מאפיינים מיוחדים בתגובת השרת

[eliyahu]

הצגת המספרים שברשימת התפוצה

הפקודה היא - GetTemplateEntries

הפרמטרים הנדרשים

פרמטר	תיאור
token	טוקן
templateId	מזהה תבנית

מאפייני תגובת השרת

מאפיין	סוג	הסבר
templateId	int	מזהה תבנית
entries	array	מערך אובייקטים (ראה "תבנית אובייקט מספר" להלן)

תבנית אובייקט מספר

מאפיין	סוג	ערך	הערות
rowid	int	מזהה ייחודי של המספר ברשימת התפוצה
index		מיקום המספר ברשימת התפוצה
phone	string	מספר טלפון
blocked	boolean	האם המספר מוגדר כחסום	במידה וכן, יופיע הערך true. במידה ולא, יופיע הערך false
name	string	שם משוייך	במידה ולא מוגדר, יתקבל הערך null
moreinfo	string	מידע נוסף	במידה ולא מוגדר, יתקבל הערך null

[eliyahu]

עדכון מספר בודד ברשימת תפוצה

הפקודה היא - UpdateTemplateEntry

הפרמטרים הנדרשים

פרמטר	תיאור	הערות
token	טוקן	פרמטר חובה
templateId	מזהה תבנית	פרמטר חובה
rowid	מזהה ייחודי של המספר ברשימת התפוצה	אם הפרמטר מושמט והמספר לא קיים, תיווצר שורה חדשה
phone	מספר טלפון	אם המספר קיים ברשימת התפוצה והפרמטר rowid הושמט, המספר יעודכן מחדש והערכים name ו-moreinfo שהיו קיימים יימחקו
name	שם
moreinfo	מידע נוסף
blocked	האם לעדכן כחסום	במידה וכן, יש להגדיר 1. במידה ולא, יש להגדיר 0

אין מאפיינים מיוחדים בתגובת השרת

[eliyahu]

עדכון סטטוס או מחיקה של מספרים מרשימת התפוצה

הפקודה היא - UpdateTemplateEntries

הפרמטרים הנדרשים

פרמטר	תיאור	הערות
token	טוקן	פרמטר חובה
templateId	מזהה תבנית	פרמטר חובה
rowids	מזהה ייחודי של המספרים ברשימת התפוצה	יש להפריד בין המספרים עם מקף -
action	איזה פעולה לעשות	ישנם 3 אפשרויות. block - חסימה. unblock - ביטול חסימה. delete - מחיקה

אין מאפיינים מיוחדים בתגובת השרת

[eliyahu]

מחיקת כל המספרים מרשימת התפוצה

הפקודה היא - ClearTemplateEntries

הפרמטרים הנדרשים

פרמטר	תיאור
token	טוקן
templateId	מזהה תבנית

אין מאפיינים מיוחדים בתגובת השרת

[eliyahu]

העלאת קובץ טקסט והפיכתו לרשימת טלפונים לתבנית קמפיין
הפקודה היא - UploadPhoneList
הפרמטרים הנדרשים:

פרמטר	תיאור	הערות
token	טוקן	חובה
templateId	מזהה תבנית	חובה
data	קובץ רשימת הטלפונים כמחרוזת	חובה
nameColumns	מספר העמודות של 'שם'. כל עמודות הטקסט האחרות עוברות ל'מידע נוסף '	ברירת מחדל 1
defaultPrefix	קידומת מספר ברירת מחדל למספרים בני 7 ספרות.הערכים המותרים הם: 02,03,04,08,09,077,072,073.	רשות
delimiter	תו המפריד בין עמודות (עבור עמודות המופרדים ב טאב כיתבו "TAB"	ברירת מחדל ","
updateType	מגדיר את סוג העדכון: UPDATE = עדכן רשומות קיימות והוסף חדשות, NEW = הסר את כל הרשומות הקיימות והוסף חדש, REMOVE = הסר רשומות	ברירת מחדל UPDATE
blocked	1 = יקבע את סטטוס הרשומות שהועלה ל'חסום '.	ברירת מחדל 0 כלומר לא מגדיר כחסום

אם ניתוח הקבצים נכשל בגלל פורמט לא מזוהה, יחזיר תגובה עם הודעה = "bad_format".

מאפייני תגובת השרת

מאפיין	סוג	הסבר
message	string	"ok" - פירושו שההעלאה עובדה כהלכה
templateId	int	מזהה התבנית שעודכן
totalParsed	int	המספר הכולל של מספרים שהתקבלו
rejectedRecords	Array	מערך המתאר את הרשומות שנדחו (ראה להלן פירוט)
totalInserted	int	המספר הכולל של מספרים שהוכנסו בהצלחה
totalUpdated	int	המספר הכולל של המספרים שעודכנו
totalRemoved	int	המספר הכולל של המספרים שהוסרו

אם מספרים מסוימים נדחו משום מה, rejectedRecords יכיל מערך של אובייקטים בפורמט הבא:

מאפיין	סוג	הסבר
phone	string	מספר הטלפון
name	string	עמודת שם
moreinfo	string	עמודת מידע נוסף
blocked	bool	סטטוס חסום
errorState	enum	DUPLICATE = המספר כפול, INVALID = המספר לא חוקי (אסור בקמפיינים)
originalRowNumber	int	מספר השורה בו זוהתה השגיאה

[eliyahu]

הפעלת קמפיין

מאפשר להפעיל קמפיין על בסיס תבנית קיימת במערכת

הפקודה היא RunCampaign

הפרמטרים הנדרשים

פרמטר	תיאור	הערות
token	טוקן	חובה
templateId	מזהה תבנית כפי שהתקבל בקריאות GetTemplates CreateTemplate	רשות; אם לא צוין, המערכת תשתמש בתבנית ברירת המחדל
callerId	זיהוי יוצא, מתקבל בקריאת GetApprovedCallerIDs	רשות; אם לא צוין, המערכת תשתמש בזיהוי שמוגדר בתבנית
phones	טלפונים לחיוג	רשות; ראה להלן פורמט מספרים לשליחה; אם לא צוין, המערכת תשתמש במספרים שנמצאים בתבנית.
ttsMode	השמעת הודעות אישיות בהקראה ממוחשבת - TTS	ראה הסבר להלן
withSMS	קמפיין משולב sms	ראה הסבר להלן

---

פורמט מספרים לשליחה

ניתן לשלוח את רשימת המספרים בפורמט פשוט כאשר המפריד בין מספר למספר הוא נקודותיים.
לדוגמה:

phones=0772222770:0773137770

בדוגמה, המערכת תחייג למספרים 0772222770 0773137770.

לחילופין, ניתן לשלוח בפורמט JSON ולצרף מידע על כל מספר (בדומה למידע שמופיע בתבנית על המספרים)
לדוגמה

{
	"0773137770":{
		"name":"שם",
		"moreinfo":"מידע נוסף",
		"blocked":true
	},
	"0772222770":{
		"name":"ימות המשיח",
		"text":"עתיד התקשורת כבר כאן"
	}
}

הסבר על הדוגמה
רשימת המספרים היא אובייקט כאשר לכל מספר ניתן להוסיף אובייקט עם מידע על המספר; כדלהלן:

1. שדה name משמש עבור השם.
2. שדה moreinfo משמש עבור מידע נוסף.
3. שדה text משמש עבור טקסט להודעה אישית (sms או tts; ראה להלן).
4. שדה blocked מציין אם המספר חסום או לא (true=חסום, false=פעיל; ברירת מחדל היא פעיל).

---

השמעת הודעות אישיות בהקראה ממוחשבת - TTS

ניתן להגדיר שהקמפיין יכיל הודעה אישית אשר תושמע לנמען בהקראה ממוחשבת (TTS - Text To Speech).
לצורך כך יש לשלוח את הפרמטר ttsMode=1, במקרה כזה, המערכת תשמיע תחילה את הודעת הקמפיין הכללית ולאחר מכן את הטקסט האישי.
שימו לב! במידה והקמפיין נשלח למספרי הטלפון שבתבנית (קרי, לא שלחתם פרמטר phones) אזי הטקסט להשמעה יהיה מה שמופיע על המספר בשדה moreinfo.
במידה והקמפיין נשלח למספרי טלפון ספציפיים (שציינתם בפרמטר phones) אזי הטקסט להשמעה יהיה מה שמופיע בשדה text וכמו שצוין למעלה.

---

קמפיין משולב sms

ניתן להגדיר שהקמפיין יהיה משולב sms, כך שלמספר נייד רגיל תישלח הודעת sms ולמספר נייד כשר תישלח הודעה קולית.
לצורך כך יש לשלוח את הפרמטר withSMS=1, במקרה כזה, המערכת תשלח קמפיין משולב.

---

מאפייני תגובת השרת

מאפיינים עיקריים

מאפיין	משמעות	סוג	דוגמה
templateId	מזהה תבנית עליה מתבסס הקמפיין	int	1117319
campaignId	מזהה הקמפיין (משמש עבור מעקב אחר הקמפיין ועוד)	string	0772222770-1117319-2025-01-21-15-11-18-347-API
entriesCount	סך הכל ערכים (מספרים) ברשימה	int	333
pending	סך הכל מספרים לחיוג	int	300
blocked	סך הכל מספרים חסומים	int	33
estimatedPrice	עלות משוערת ביחידות	double	333.0
customerUnits	כמות יחידות במערכת	double	10000.12121212
smsCount	כמות sms	double	0.0
smsPrice	עלות sms	double	0.0

---

שגיאות אפשריות

קוד הודעה	הודעה	הסבר
100	תבנית לא חוקית	ערך templateId אינו חוקי (התבנית אינה קיימת במערכת).
101	הקמפיין לא מוגדר כראוי	הקמפיין לא הוגדר נכון (רשימת הטלפונים ריקה, אין הודעה תקינה וכו').
102	אין טלפונים תקינים	כל המספרים שסופקו בפרמטר phones אינם תקינים.
103	יחידות לא מספיקות	יתרת היחידות במערכת אינה מספיקה עבור הקמפיין הנדרש.
104	isKodesh is true	ניסיון להפעיל קמפיין בשבת או ביום טוב.
105	שגיאה כללית	אירעה שגיאת מערכת והקמפיין לא יכול להתחיל.
120	CallerId אינו מורשה	המספר המבוקש ב-callerId אינו מורשה לשימוש עבור הלקוח.

[eliyahu]

קבלת מצב קמפיין

מאפשר לבדוק את הסטטוס הנוכחי של קמפיין כפי שהתקבל בקריאת RunCampaign

הפקודה היא GetCampaignStatus

פרמטרים בבקשה

פרמטר	חובה/אופציונלי	תיאור
token	חובה	טוקן
campaignId	חובה	מזהה הקמפיין, כפי שהתקבל בקריאת RunCampaign
entries	אופציונלי	הצגת רשומות בקמפיין (מספרי טלפון) ראו להלן "הצגת רשומות בקמפיין". במידה ולא צוין, ברירת המחדל היא שלא מציג את מצב הרשומות בקמפיין אלא רק את המצב הכללי של הקמפיין.
range	אופציונלי	טווח ערכים להצגה (מקסימום/מינימום) ראו להלן "הגדרת טווח להצגה"

הצגת רשומות בקמפיין

סוגי הערכים האפשריים בפרמטר entries

ערך	הסבר
all	הכל
pending	בהמתנה לחיוג
blocked	חסומים
done	בוצע
accepted	אישרו מסירה
failed	נכשלו
no_answer	אין מענה
busy	תפוס
amd	מענה תא קולי
ringing	בחיוג
up	בשיחה
bridged	מנותבים
remove_request	בקשה להסרה
redial	ממתינים לחיוג חוזר
canceled	בוטל
error	שגיאה כללית

הגדרת טווח להצגה

בפרמטר range יש להגדיר את טווח הרשומות להצגה.
הפורמט הוא [min]:[max].
לדוגמה 1:100 עבור 100 הרשומות הראשונות, או : עבור כל הרשומות.
ברירת מחדל מחזיר 10,000 ערכים ראשונים.

---

פרמטרים בתשובה במצב הצלחה

מבנה התגובה

{
    "responseStatus": "OK",
    "campaign": {
        "campaignId": "0772222770-1117319-2025-01-22-10-07-54-414-API",
        "campaignStatus": "RUNNING",
        "templateId": 1117319,
        "who": "0.0.0.0",
        "callerId": "0772222770",
        "blockedEntries": 0,
        "pendingEntries": 0,
        "activeEntries": 1,
        "bridgedEntries": 0,
        "redialEntries": 0,
        "doneEntries": 0,
        "failedEntries": 0,
        "totalEntries": 1,
        "totalDialed": 3,
        "totalSuccessful": 1,
        "totalBridged": 0,
        "totalFailed": 2,
        "totalIncoming": 0,
        "totalIncomingBridged": 0,
        "maxActiveChannels": 100,
        "maxBridgedChannels": 0,
        "maxDialAttempts": 3,
        "redialWait": 10.0,
        "redialPolicy": "FAILED",
        "vmDetect": false,
        "filterEnabled": false,
        "playPrivateMsg": false,
        "runTime": 150.306,
        "currentPrice": 1.0,
        "paused": false,
        "entries": [
            {
                "phone": "0773137770",
                "name": null,
                "moreinfo": "זוהי הודעת בדיקה",
                "entryStatus": "up",
                "duration": 3680,
                "bridgedDuration": null,
                "bridged": false,
                "startTime": "2025-01-22 10:10:14",
                "currentPrice": 1.0,
                "redials": [
                    {
                        "entryStatus": "no_answer",
                        "duration": null,
                        "bridgedDuration": null,
                        "bridged": false,
                        "startTime": "2025-01-22 10:07:54"
                    },
                    {
                        "entryStatus": "no_answer",
                        "duration": null,
                        "bridgedDuration": null,
                        "bridged": false,
                        "startTime": "2025-01-22 10:09:04"
                    }
                ]
            }
        ]
    },
    "yemotAPIVersion": 6
}

---

מבנה תגובת הקמפיין

מאפיין	סוג	תיאור
campaignId	מחרוזת	מזהה הקמפיין.
campaignStatus	enum	סטטוס הקמפיין: אחד מ-STOPPED, RUNNING, PAUSED, STOPPING FINISHED.
templateId	מספר	מזהה התבנית שעל בסיסה פועל הקמפיין.
who	מחרוזת	כתובת IP או מספר הטלפון שהפעיל את הקמפיין.
callerId	מחרוזת	מספר טלפון היוצא עבור הקמפיין.
blockedEntries	מספר	מספר הרשומות החסומות.
pendingEntries	מספר	מספר הרשומות הממתינות.
activeEntries	מספר	מספר הרשומות הפעילות כעת.
bridgedEntries	מספר	מספר הרשומות שחוברו בהצלחה.
redialEntries	מספר	מספר הרשומות המחכות לחיוג חוזר.
doneEntries	מספר	מספר הרשומות שהושלמו בהצלחה.
failedEntries	מספר	מספר הרשומות שנכשלו.
totalEntries	מספר	סך כל הרשומות בקמפיין.
totalDialed	מספר	סך כל החיוגים (כולל חיוגים חוזרים).
totalSuccessful	מספר	סך השיחות המוצלחות.
totalBridged	מספר	סך כל השיחות שחוברו.
totalFailed	מספר	סך כל השיחות שנכשלו.
totalIncoming	מספר	סך השיחות הנכנסות במהלך הקמפיין.
totalIncomingBridged	מספר	סך השיחות הנכנסות שחוברו.
maxActiveChannels	מספר	המספר המרבי של שיחות פעילות מותרות בקמפיין.
maxBridgedChannels	מספר	המספר המרבי של שיחות מחוברות מותרות בקמפיין.
maxDialAttempts	מספר	מספר הניסיונות המרבי לחיוג חוזר.
redialWait	מספר	זמן ההמתנה המינימלי בין ניסיונות חיוג חוזר (בשניות).
redialPolicy	enum	מדיניות החיוג החוזר: NONE, CONGESTIONS, או FAILED.
vmDetect	בוליאני	האם זיהוי תא קולי מופעל.
playPrivateMsg	בוליאני	האם מצב הודעה פרטית מופעל.
runTime	מספר	זמן הריצה הכולל של הקמפיין (בשניות).
currentPrice	מספר	המחיר הנוכחי שנגבה עבור הקמפיין (ביחידות).
paused	בוליאני	האם הקמפיין במצב מושהה.

---

שגיאות אפשריות

קוד הודעה	הודעה	הסבר
106	קמפיין לא נמצא	campaignId לא נמצא עבור המשתמש.

---

הערות

• כאשר נכלל פרמטר entries, התגובה תכיל את שדה entries עם מידע מפורט על הרשומות (ראו מבנה JSON בתיאור המפורט).

   "entries": [
     {
       "phone": string,
       "name": string|null,
       "moreinfo": string|null,
       "entryStatus": entry_status_enum,
       "duration": time_ms|null,
       "bridgedDuration": time_ms|null,
       "bridged": true|false,
       "startTime": sql_time|null,
       "redials": [
         {
           "entryStatus": entry_status_enum,
           "duration": null,
           "bridgedDuration": null,
           "bridged": true|false,
           "startTime": sql_time|null
     },
     {
       "phone": "0501234567",                       // מספר הטלפון של הנמען
       "name": "Yosef",                             // שם (אם קיים)
       "moreinfo": "Jerusalem",                          // מידע נוסף (אם קיים)
       "entryStatus": "bridged",                    // סטטוס נוכחי של הרשומה (למשל: bridged, done, no_answer)
       "duration": 5200,                            // משך השיחה הכולל במילישניות
       "bridgedDuration": 4100,                     // משך זמן ניתוב שיחה
       "bridged": true,                             // האם השיחה מנותבת
       "startTime": "2025-05-25 10:32:00",          // מתי התחילה השיחה (זמן החיוג)
       "redials": [                                 // ניסיונות חוזרים (אם היו)
         {
           "entryStatus": "busy",                // סטטוס ניסיון חוזר זה
           "duration": null,                        // משך שיחה בניסיון זה (null כי לא נענתה)
           "bridgedDuration": null,                 // משך זמן ניתוב שיחה
           "bridged": false,                        // האם בוצע ניתוב שיחה
           "startTime": "2025-05-25 10:29:00"       // זמן תחילת ניסיון החיוג הזה
         },
         {
           "entryStatus": "no_answer",              // ניסיון חוזר נוסף - לא נענה
           "duration": null,                       // 
           "bridgedDuration": 0,                    // 
           "bridged": false,                        //
           "startTime": "2025-05-25 10:30:30"       //
         }
       ]
     },
     {
       "phone": "0521234567",                       // מספר טלפון נוסף
       "name": null,                                // לא סופק שם
       "moreinfo": null,               // לא סופק
       "entryStatus": "done",                       // הסתיים בהצלחה
       "duration": 8000,                            // משך שיחה
       "bridgedDuration": 0,                        // 
       "bridged": false,                            // 
       "startTime": "2025-05-25 10:35:00",          // מתי בוצעה השיחה
       "redials": []                                // לא היו ניסיונות חוזרים
     }
   ]

[eliyahu]

הורדת דו"ח קמפיין-DownloadCampaignReport

[eliyahu]

קבלת קמפיינים פעילים-GetActiveCampaigns

[eliyahu]

ביצוע פעולות בקמפיין בזמן אמת

הפקודה היא CampaignAction

תיאור
שירות זה מאפשר לבצע פעולות ניהול בזמן אמת על קמפיין פעיל.
המערכת תומכת בשני סוגי פעולות:

1. פעולות כלליות על הקמפיין כולו (כגון עצירה, השהייה, הגבלת ערוצים).
2. פעולות ממוקדות על מספרים ספציפיים (כגון חסימה, הוספה, ניתוק).

---

חלק א' – פעולות כלליות בקמפיין

פרמטרים בבקשה

פרמטר	חובה	תיאור
token	כן	טוקן
campaignId	כן	מזהה הקמפיין, כפי שהוחזר מ־RunCampaign.
action	כן	הפעולה שיש לבצע (ראו טבלה להלן).
value	תלוי	ערך נלווה לפעולה (למשל 0, 1 או מספר ערוצים).

פעולות כלליות נתמכות (action)

ערך (action)	תיאור	ערך value נדרש
stop	עצירת הקמפיין באופן מיידי.	לא נדרש
setPaused	הפעלת/ביטול מצב מושהה – 1 להשהיה, 0 לביטול.	0 או 1
setMaxActiveChannels	שינוי כמות מקסימלית של שיחות פעילות בו־זמנית במהלך הקמפיין.	מספר
setMaxBridgedChannels	שינוי כמות מקסימלית של שיחות מנותבות בו־זמנית במהלך הקמפיין.	מספר

מבנה תגובה

{
  "responseStatus": "OK",
  "campaign": { ... },         /// סטטוס מעודכן של הקמפיין (ראו פירוט בהמשך)
  "action": "setPaused",       /// הפעולה שבוצעה
  "value": "1"                 /// הערך שנשלח לביצוע הפעולה
}

---

חלק ב' – פעולות על מספרים ספציפיים

פרמטרים בבקשה

פרמטר	חובה	תיאור
token	כן	טוקן
campaignId	כן	מזהה הקמפיין
action	כן	אחת מהפעולות: add, block, hangup.
value	כן	רשימת מספרים לביצוע הפעולה – בפורמט : או JSON (ראו להלן).

פעולות נתמכות במספרים (action)

ערך (action)	תיאור פעולה
add	הוספת מספרים לרשימת החיוג של הקמפיין (גם תוך כדי ריצה).
block	חסימת מספרים – לא יבוצעו אליהם חיוגים נוספים.
hangup	ניתוק מיידי של שיחות פעילות למספרים שצוינו.

פורמט value – רשימת מספרים

אפשרות 1: מחרוזת מופרדת ב־:

0501234567:0527654321

אפשרות 2: JSON מלא כמו ב־RunCampaign

{
  "0501234567": "הודעה מותאמת אישית",
  "0527654321": {
    "name": "חיים",
    "moreinfo": "מזכרת בתיה",
    "text": "שלום! זו הודעת תזכורת"
  }
}

---

מבנה תגובה

{
  "responseStatus": "OK",
  "campaign": { ... },         /// סטטוס מעודכן של הקמפיין
  "action": "add",             /// הפעולה שבוצעה
  "value": null,               /// ערך שנשלח (אם רלוונטי)
  "data": [
    {
      "phone": "0501234567",
      "action": "add"          /// הפעולה שבוצעה בפועל על המספר (ראה טבלה בהמשך)
    },
    {
      "phone": "0527654321",
      "action": "blocked"
    }
  ],
  "yemotAPIVersion": 6
}

---

אפשרויות ערך ב־data[].action

ערך (action)	תיאור הפעולה שבוצעה בפועל על המספר
add	המספר נוסף לקמפיין
addblocked	המספר נוסף אך מיד סומן כחסום
block	המספר נחסם ולא יחוייג שוב בקמפיין
unblock	בוטלה החסימה מהמספר
hangup	השיחה למספר זה נותקה (אם הייתה פעילה)
failed	המספר סומן כ"שיחה נכשלה" ולא יחוייג שוב

---

campaign – אובייקט סטטוס הקמפיין

האובייקט campaign המוחזר בתגובה מכיל את הסטטוס הנוכחי של הקמפיין, והוא תואם בדיוק למבנה שמוחזר מהשירות GetCampaignStatus.

כולל נתונים כגון:

• campaignId, campaignStatus, templateId, callerId
• ספירות של pendingEntries, activeEntries, doneEntries, failedEntries, redialEntries ועוד
• הגדרות כמו maxActiveChannels, vmDetect, paused
• עלות מצטברת (currentPrice)
• זמן ריצה כולל (runTime)

[eliyahu]

יצירת קמפיין מתוזמן
הפקודה היא - ScheduleCampaign

הפרמטרים הנדרשים

פרמטר	אפשרויות	תיאור/הערות/פירוט
token		טוקן
templateId		מספר מזהה של הקמפיין
time		הגדרת זמן הפעלה באחד מהצורות הבאות (תאריך לועזי בלבד)
אופציה 1	yyyy-MM-dd-HH:mm:ss	שנה -חודש - יום-שעה:דקה:שניה
אופציה 2	yyyy-MM-dd-HH:mm	שנה -חודש - יום-שעה:דקה
אופציה 3	yyyy-MM-dd HH:mm:ss	שנה -חודש - יום שעה:דקה:שניה(בין היום לשעה רווח במקום -)
אופציה 4	yyyy-MM-dd	שנה -חודש-יום
אופציה 5	HH:mm:ss	שעה:דקה:שניה
אופציה 6	HH:mm	שעה:דקה

[eliyahu]

קבלת קמפיינים מתוזמנים-

הפקודה היא - GetScheduledCampaigns

הפרמטרים הנדרשים:

פרמטר	תיאור/הערות
token	טוקן
type	סוג הקמפיינים להחזרה. האפשרויות הם PENDING קמפיינים המיועדים לביצוע. SUCCESSFUL קמפיינים שבוצעו בהצלחה. FAILED קמפיינים שנכשלו.
order	סדר המיון. האפשרויות הם: asc (ברירת מחדל) - סדר עולה. desc- סדר יורד
from	אופציונלי - maximum number of records to include
limit	אופציונלי - מקסימום של קמפיינים להחזרה

[eliyahu]

מחיקת קמפיין מתוזמן-DeleteScheduledCampaign

[eliyahu]

הצגת תוכן שלוחה (תיקייה)

הפקודה היא GetIVR2Dir

הפרמטרים הנדרשים

פרמטר	תיאור	הערות
token	טוקן	חובה
path	נתיב תיקייה	חובה. לדוגמה: / עבור שלוחה ראשית. 1 עבור שלוחה 1 ext/1 עבור שלוחה ext/1
filesFrom	הצג קבצים מ	רשות. 0 יציג מהקובץ הראשון 1 יציג מהקובץ השני וכן הלאה. ברירת מחדל מציג מהקובץ הראשון.
filesLimit	הצג קבצים עד	רשות. לדוגמה, 5 יציג את הקובץ החמישי (כולל). ברירת מחדל מציג עד הקובץ האחרון
orderBy	מיין קבצים לפי	ראה להלן "ערכים אפשריים לפרמטר orderBy"
orderDir	סדר קבצים	asc - סדר עולה. desc - סדר יורד.

ערכים אפשריים לפרמטר orderBy

ערך	תיאור
name	שם קובץ (ברירת מחדל)
date	תאריך יצירה
mtime	תאריך שינוי אחרון
customerdid	מספר מערכת
uploader	מעלה הקובץ
size	גודל
source	מקור

---

מאפייני תגובת השרת

מאפיין	סוג	הסבר
extIni	object	אובייקט הכולל את הגדרות השלוחה
thisPath	string	נתיב תיקייה נוכחית
parentPath	string	נתיב תיקיית אב
dirs	Array	מערך הכולל את התיקיות והשלוחות שבתיקייה הנוכחית
files	Array	מערך הכולל את הקבצים שבתיקייה הנוכחית (מלבד קבצי ini ו-html שנמצאים במערך נפרד)
ini	Array	מערך הכולל את קבצי ההגדרות (ini) שבשלוחה
messages	Array	מערך הכולל את הודעות המערכת הקשורות לשלוחה
html	Array	מערך הכולל את קבצי הדוחות (html) שבשלוחה
msgDescriptions	object	אובייקט הכולל את התיאור של כל הודעות המערכת בשלוחה (למשל M0000=הודעת ברוכים הבאים)

מאפיינים משותפים לאובייקטים במערכים "dirs" "files" "ini" "messages" "html"

מאפיין	סוג	הסבר
exists	boolean	האם התיקייה/קובץ קיימים
name	string	שם התיקייה/קובץ
uniqueId	string	מזהה ייחודי לתיקייה/קובץ
what	string	נתיב תיקייה/קובץ
fileType	string	סוג תיקייה/קובץ

מאפיינים משותפים לאובייקטים במערכים "files" "ini" "messages" "html"

מאפיין	סוג	הסבר
size	int	גודל קובץ (בבתים)
mtime	string	תאריך שינוי אחרון

מאפיינים משותפים לאובייקטים במערכים "files" "messages"
הערה: המאפיינים הבאים הינם עבור קבצי שמע בלבד

מאפיין	סוג	הסבר
duration		אורך (בדקות)
durationStr	string	אורך בפורמט mm:ss
customerDid	string	מספר מערכת בה נוצר הקובץ
meta	string	אובייקט המכיל מידע נוסף על הקובץ
date	string	זמן יצירת קובץ dd/mm/yyyy hh:mm
source	string	מקור הקובץ
phone	string	טלפון יוצר הקובץ
ip	string	כתובת IP של מעלה הקובץ

מאפייני אובייקטים במערך dirs
הערה: המאפיינים הבאים הינם עבור תיקיות המוגדרות כשלוחה ולא עבור תיקיות רגילות

מאפיין	סוג	הסבר
extType	string	סוג שלוחה
extTitle	string	תיאור שלוחה

[eliyahu]

קבלת מידע על קובץ בודד

הפקודה היא - GetFile

הפרמטרים הנדרשים

פרמטר	תיאור	סוג
token	טוקן	string
what	נתיב במערכת	string (דוגמה למטה)

דוגמה לנתיב

what=ivr2:2/000.wav    /// מידע על קובץ 000 בשלוחה 2

תגובה (במידה והקובץ קיים)
דומה למאפיינים של קובץ כפי שמופיע בGetIVR2Dir

במידה וקובץ לא קיים יחזור שגיאה

{
  "responseStatus": "ERROR",
  "message": "file does not exist",
  "messageCode": null,
  "yemotAPIVersion": 6
}

במידה ונתיב לא חוקי יחזור

{
  "responseStatus": "EXCEPTION",
  "exceptionClass": "IllegalArgumentException",
  "exceptionMessage": "bad descriptor format. don't know what is xyz",
  "nestedException": null,
  "yemotAPIVersion": 6
}

[eliyahu]

ניהול תיקיות וקבצים

הפקודה היא FileAction

הפרמטרים הנדרשים

פרמטר	תיאור	הערה
token	טוקן
action	סוג הפעולה לביצוע	ראה להלן
what	נתיב	ראה להלן
target	יעד	ראה להלן

בפרמטר action האפשרויות הקיימות הן:

1. copy - העתקה
2. move - העברה (לשינוי שם של שלוחה או קובץ יש להשתמש בהעברה)
3. delete - מחיקה

בפרמטר what האפשרויות הקיימות הן:

1. ניהול קובץ בודד או שלוחה בודדת.
2. ניהול קבצים מרובים כאשר בפרמטר what יש לציין כל קובץ או שלוחה בנפרד. לדוגמה:
3. ניהול קובץ בתבנית קמפיין. ראה כאן

${url}FileAction?token=${token}&action=${action}&what0=ivr2:1&what1=ivr2:2/ext.ini

בדוגמה: ניהול שלוחה 1 וניהול קובץ ext.ini שבשלוחה 2.

בפעולה מסוג העברה או העתקה חובה לציין פרמטר target. האפשרויות הקיימות הן:

1. בניהול קבצים מרובים או שלוחות מרובות יש לציין את נתיב היעד הרצוי. לדוגמה, במידה והיעד הוא שלוחה 1 יש לציין את הנתיב כך target=ivr2:1.
   הערה: שימו לב! השם המקורי נשמר. במידה ומדובר בהעברת או העתקת קבצים עם שם בעל מספר סידורי שמות הקבצים ישתנו בהתאם לשמות הקבצים בשלוחת היעד. (לדוגמה, אם בוצעה העתקה של קובץ 001 משלוחה 2 לשלוחה 1 ששם קיים קובץ בשם 050 אז השם של הקובץ שהועתק ישתנה ל-051).
2. בניהול קובץ בודד או שלוחה בודדת ניתן גם לציין נתיב מלא כולל השם הרצוי ביעד.

מאפייני תגובת השרת:

מאפיין	סוג	הסבר	הערה
reports	array	מערך אובייקטים	ראה להלן
success	boolean	האם הפעולה בוצעה	במידה וכן, יופיע הערך true. במידה ולא, יופיע הערך false
action		סוג הפעולה שבוצעה

תבנית אובייקט

מאפיין	ערך
what	נתיב מקור
target	נתיב יעד
success	האם בוצע (זהה לתיאור לעיל)

[eliyahu]

קבלת תוכן קובץ טקסט

הפקודה היא - GetTextFile

הפרמטרים הנדרשים:

פרמטר	תיאור	הערות
token	טוקן
what	נתיב מלא כולל שם הקובץ והסיומת	לדוגמה ivr2:1/ext.ini

מאפייני תגובת השרת:

מאפיין	סוג	ערך
contents	string	התוכן הכתוב בקובץ
file	array	מערך אובייקטים (ראה להלן)

תבנית אובייקט:

מאפיין	סוג	ערך
exists	boolean	האם הפעולה בוצעה (במידה וכן, יופיע הערך true. במידה ולא, יופיע הערך false)
name	string	שם הקובץ
uniqueId	string	מזהה תנועה ייחודי
fileType	string	סוג קובץ (למשל: INI)
size	int	גודל קובץ
mtime	string	תאריך ושעה שהקובץ השתנה (פורמט: dd/MM/yyyy HH:mm)
what	string	נתיב מלא