• הרשמה
    • התחברות
    • חיפוש
    • דף הבית
    • אינדקס קישורים
    • פוסטים אחרונים
    • קבלת התראות מהדפדפן
    • משתמשים
    • חיפוש בהגדרות המתקדמות
    • חיפוש גוגל בפורום
    • ניהול המערכת
    • ניהול המערכת - שרת private

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

    אזור התעשיה - הגדרות המערכת
    5
    70
    52616
    טוען פוסטים נוספים
    • מהישן לחדש
    • מהחדש לישן
    • הכי הרבה הצבעות
    תגובה
    • הגיבו כנושא
    התחברו בכדי לפרסם תגובה
    נושא זה נמחק. רק משתמשים עם הרשאות מתאימות יוכלו לצפות בו.
    • E
      eliyahu ניהול נערך לאחרונה על ידי eliyahu

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

      הפקודה היא - ClearTemplateEntries

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

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

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

      תגובה 1 תגובה אחרונה תגובה ציטוט 2
      • E
        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 מספר השורה בו זוהתה השגיאה
        תגובה 1 תגובה אחרונה תגובה ציטוט 3
        • E
          eliyahu ניהול נערך לאחרונה על ידי 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 אינו מורשה לשימוש עבור הלקוח.
          תגובה 1 תגובה אחרונה תגובה ציטוט 2
          • E
            eliyahu ניהול נערך לאחרונה על ידי 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": []                                // לא היו ניסיונות חוזרים
                 }
               ]
            
            תגובה 1 תגובה אחרונה תגובה ציטוט 2
            • E
              eliyahu ניהול נערך לאחרונה על ידי

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

              תגובה 1 תגובה אחרונה תגובה ציטוט 2
              • E
                eliyahu ניהול נערך לאחרונה על ידי

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

                תגובה 1 תגובה אחרונה תגובה ציטוט 2
                • E
                  eliyahu ניהול נערך לאחרונה על ידי 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)
                  תגובה 1 תגובה אחרונה תגובה ציטוט 2
                  • E
                    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 שעה:דקה
                    תגובה 1 תגובה אחרונה תגובה ציטוט 2
                    • E
                      eliyahu ניהול נערך לאחרונה על ידי שמחה - זו הסיסמא

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

                      הפקודה היא - GetScheduledCampaigns

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

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

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

                        תגובה 1 תגובה אחרונה תגובה ציטוט 2
                        • E
                          eliyahu ניהול נערך לאחרונה על ידי שלוימי 770

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

                          הפקודה היא 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 תיאור שלוחה
                          תגובה 1 תגובה אחרונה תגובה ציטוט 2
                          • E
                            eliyahu ניהול נערך לאחרונה על ידי 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
                            }
                            
                            תגובה 1 תגובה אחרונה תגובה ציטוט 3
                            • E
                              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 האם בוצע (זהה לתיאור לעיל)
                              תגובה 1 תגובה אחרונה תגובה ציטוט 4
                              • E
                                eliyahu ניהול נערך לאחרונה על ידי אלחנן1

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

                                הפקודה היא - 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 נתיב מלא
                                תגובה 1 תגובה אחרונה תגובה ציטוט 6
                                • E
                                  eliyahu ניהול נערך לאחרונה על ידי אלחנן1

                                  העלאת טקסט לקובץ

                                  הערה: במידה והקובץ לא קיים בשלוחה, ייווצר קובץ חדש.

                                  הפקודה היא - UploadTextFile

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

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

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

                                  תגובה 1 תגובה אחרונה תגובה ציטוט 6
                                  • E
                                    eliyahu ניהול נערך לאחרונה על ידי eliyahu

                                    עדכון הגדרות שלוחה

                                    שימו לב! בשונה מהפקודה UploadTextFile כאן המערכת לא מוחקת את הקיים בקובץ ext.ini והדבר היחיד שמשתנה הוא מה שאתם שולחים לשרת

                                    הערה: במידה והשלוחה לא קיימת במערכת, תיווצר שלוחה חדשה.

                                    הפקודה היא - UpdateExtension

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

                                    פרמטר תיאור / הערות
                                    token טוקן
                                    path נתיב

                                    בפרמטרים הנוספים תוכלו לצרף ערכים לעדכון בקובץ ext.ini

                                    לדוגמה:

                                    ${url}UpdateExtension?token=${token}&path=ivr2:1&type=menu&title=בדיקה&enter_id=yes
                                    

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

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

                                    תגובה 1 תגובה אחרונה תגובה ציטוט 6
                                    • שמואל
                                      שמואל נערך לאחרונה על ידי שמחה - זו הסיסמא

                                      הכוונת שיחה - העברת מאזין ב**אפשרות הראשונה לשלוחה אחרת או לניתוק

                                      ** לא בכל שלב ניתן להעביר את המאזין לשלוחה אחרת באופן מיידי, ולכן הפעולה נשמרת למקום הראשון בו ניתן לעשות את הפעולה

                                      הפקודה היא - CallAction

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

                                      פרמטר תיאור הערות
                                      token טוקן
                                      ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                      action set:GOasap=XXXX יש להחליף את "XXX" בלאן להעביר את המאזין, נתיב העברה, או "hangup" לניתוק

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

                                      מאפיין סוג הסבר
                                      calls array פירוט השיחות שבוצעה בהן פעולה - זהה לתיאור המופיע בפקודה GetIncomingCalls
                                      action סוג הפעולה שבוצעה
                                      callsCount int מספר כולל של שיחות שבוצעה בהן פעולה

                                      לפניות בנוגע לפורום: shmuel@yemot.co.il

                                      תגובה 1 תגובה אחרונה תגובה ציטוט 14
                                      • שמואל
                                        שמואל נערך לאחרונה על ידי

                                        ניהול חדרי ועידה:


                                        הפקודה היא - CallAction

                                        בקריאה ל GetIncomingCalls יש מערך של שיחות של חדרי ועידה, כל הפעולות המפורטות כאן צריכות להיות מבוצעות על הid של המאזין של חדר הועידה - ולא על הID הראשי.

                                        טיפה הסבר על מערך של שיחות הוועידה:

                                        דוגמא:

                                        4c97d3a2-6790-43f7-93f9-54b428a7bdd9-image.png

                                        נעבור על החלקים החשובים.

                                        פרמטר תיאור הערות
                                        confCalls מכיל את מספר המערכת הראשי, ואז - ואז את השלוחה של חדר הועידה
                                        mute האם הערוץ מושתק
                                        hand האם יש הרמת אצבע
                                        admin האם מנהל
                                        data['survey'] מכיל את נתוני הצבעה, במהלך החדר המאזין יכול להקיש על כל הספרות בטלפון שלו וזה משוקף מייד. באם אין הקשה הערך לא יופיע

                                        הוספה או הסרה של רכיבים מה path וממערך data.

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

                                        הוספה של ערך:

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        path:add:XXX הוספה של נתון בpath, זה גם יופיע במערך data שהובא לעיל יש להחליף את XXX בערך, למשל: path:add:survey=7.

                                        הסרה של ערך:

                                        פה ניתן לשלוח רק את ההתחלה של הערך, והוא ירד.

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        path:remove:XXX הסרה של נתון בpath, זה גם ירד במערך data שהובא לעיל יש להחליף את XXX בתחילת ערך, למשל: path:remove:survey=. זה יגרום למחיקה של ערך survey ממערך הdata בכלל - למשל, כדי לאפס נתוני הצבעה.

                                        יש לשים לב, זה לא משפיע על סוג וצורת החדר, למשל, שליחה של path:add:admin לא תגרום למאזין להיות מנהל של החדר.


                                        הוצאה מחדר ועידה.

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

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        action kick

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


                                        השתקת הערוץ:

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

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        action mute

                                        ביטול השתקה של הערוץ:

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

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        action unmute

                                        סימון הורדת יד:

                                        בדומה להורדת אצבע על ידי המאזין בטלפון.

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

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        action lowerhand

                                        סימון הרמת יד:

                                        בדומה להרמת אצבע על ידי המאזין בטלפון.

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

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        action raisehand

                                        כיוון הוצאה מחדר ועידה:

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

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

                                        פרמטר תיאור הערות
                                        token טוקן
                                        ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                        set:ConfbridgeNewGoto=/XX מסמן לאן להעביר את המאזין בביצוע kick מהאתר יש לכתוב נתיב להעברה או hangup לניתוק.


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

                                        מאפיין סוג הסבר
                                        calls array פירוט השיחות שבוצעה בהן פעולה - זהה לתיאור המופיע בפקודה GetIncomingCalls
                                        action סוג הפעולה שבוצעה
                                        callsCount int מספר כולל של שיחות שבוצעה בהן פעולה

                                        לפניות בנוגע לפורום: shmuel@yemot.co.il

                                        תגובה 1 תגובה אחרונה תגובה ציטוט 14
                                        • שמואל
                                          שמואל נערך לאחרונה על ידי eliyahu

                                          שינוי השפה בערוץ:

                                          גובר על ערך language בשלוחה ובivr.ini.

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

                                          פרמטר תיאור הערות
                                          token טוקן
                                          ids מזהה ייחודי של השיחה כפי שהתקבל בקריאה GetIncomingCalls ניתן לשרשר כמה שיחות לביצוע על ידי כתיבה : בין id לid
                                          action=set:Clanguage=XX מסמן את השפה החדשה בערוץ כולו יש להחליף את XX בשפה המבוקשת - כל קודי השפה שיש כמו במערכת עצמה השינוי יכנס לתוקף במעבר שלוחה הבא של המאזין.

                                          דוגמה

                                          CallAction?token=xxxxxxxx&ids=fgdhfszfzvxbdgsxf&action=set:Clanguage=en
                                          


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

                                          מאפיין סוג הסבר
                                          calls array פירוט השיחות שבוצעה בהן פעולה - זהה לתיאור המופיע בפקודה GetIncomingCalls
                                          action סוג הפעולה שבוצעה
                                          callsCount int מספר כולל של שיחות שבוצעה בהן פעולה

                                          לפניות בנוגע לפורום: shmuel@yemot.co.il

                                          תגובה 1 תגובה אחרונה תגובה ציטוט 7
                                          • שמואל
                                            שמואל נערך לאחרונה על ידי שמואל

                                            קבלת סיכום דקות נכנסות למערכת לפי טווח תאריכים

                                            הפקודה היא - GetIncomingSum

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

                                            פרמטר תיאור דוגמא
                                            token טוקן
                                            from מאיזה תאריך YYYY-mm-dd
                                            to עד איזה תאריך YYYY-mm-dd
                                            בחירת מחדל - אם לא צויין טווח תאריכים - יביא מתחילת החודש הלועזי

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

                                            מאפיין סוג הסבר
                                            fromDate string מאיזה תאריך מוצגים הנתונים
                                            toDate string עד איזה תאריך מוצגים הנתונים
                                            direct int דקות בחיוג ישיר למערכת
                                            transferIn int דקות ממערכות אחרות
                                            transferOut int דקות שיצאו למערכות אחרות

                                            לפניות בנוגע לפורום: shmuel@yemot.co.il

                                            תגובה 1 תגובה אחרונה תגובה ציטוט 15
                                            • פוסט ראשון
                                              פוסט אחרון