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

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

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

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

      הפקודה היא - UpdateTemplateEntries

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

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

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

      תגובה 1 תגובה אחרונה תגובה ציטוט 1
      • 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
                                            • פוסט ראשון
                                              פוסט אחרון