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

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

    אזור התעשיה - הגדרות המערכת
    4
    70
    53943
    טוען פוסטים נוספים
    • מהישן לחדש
    • מהחדש לישן
    • הכי הרבה הצבעות
    תגובה
    • הגיבו כנושא
    התחברו בכדי לפרסם תגובה
    נושא זה נמחק. רק משתמשים עם הרשאות מתאימות יוכלו לצפות בו.
    • 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
                                          • שמואל
                                            שמואל נערך לאחרונה על ידי eliyahu

                                            קבלת לוג סמסים יוצאים

                                            הפקודה היא - GetSmsOutLog

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

                                            פרמטר תיאור סוג
                                            token טוקן
                                            limit הגבלת תוצאות int

                                            בחירת מחדל מביא את כל הסמסים.
                                            סדר קבלת הסמסים הם מהחדש לישן

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

                                            מאפיין סוג הסבר
                                            rows array מערך של הסמסים היוצאים

                                            להלן תוכן מערך הסמסים:

                                            מאפיין סוג הסבר
                                            CallerId string זיהוי יוצא
                                            To string יעד
                                            Message string תוכן ההודעה
                                            Billing int עלות ביחידות
                                            RunBy string פרטי מבצע הפעולה
                                            Time string זמן השליחה
                                            DeliveryReport string דוח מסירה

                                            להלן סוגי סטטוס דוחות מסירה נפוצים לפי תקן SMPP:

                                            # הסבר
                                            null לא התקבל מידע על מסירת ההודעה
                                            DELIVRD נמסר
                                            ESME_ROK הועבר לשליחה בהצלחה
                                            EXPIRED פג תוקף מעקב המסירה
                                            ESME_RINVDSTADR יעד לא נגיש
                                            ESME_RINVMSGLEN אורך לא חוקי
                                            ESME_RINVCMDLEN אורך פקודה שגוי
                                            ESME_RMSGQFUL תור ההודעות מלא
                                            ESME_RINVNUMDESTS מספר יעדים לא חוקי

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

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