מוניטור SIP בזמן אמת - מערכת SiP_panel
שימו לב, שירות זה דורש רישיון פעיל (חבילה בתשלום מול שירות הלקוחות, או התנסות). ניתן לבדוק את מצב הרישיון גם ללא רישיון באמצעות getLicenseInfo.
הפקודה היא - SipRealtimeMonitor
אפשר לקרוא לשירות בGET (פרמטרים ב-query string) או בPOST עם json בbody — למעט getCalls עם פילטר חשבונות שמצריך POST.
בכל פניה יש לצרף:
| פרמטר |
תיאור |
סוג |
| token |
טוקן |
string |
| action |
הפעולה לביצוע - יבואר |
string |
פעולות:
קבלת מצב הרישיון - getLicenseInfo
הפעולה היא - getLicenseInfo
מענה בעת הצלחה
| מאפיין |
סוג |
הסבר |
דוגמא |
| responseStatus |
string |
סטטוס הפעולה |
OK |
| license.allowed |
boolean |
האם יש גישה לשירות |
true |
| license.trial |
boolean |
האם זהו רישיון ניסיון |
true |
| license.trialStart |
number |
Unix timestamp של תחילת הניסיון |
1779705344 |
| license.trialEnd |
number |
Unix timestamp של סיום הניסיון |
1780310144 |
| license.trialAvailable |
boolean |
האם ניסיון זמין להפעלה |
false |
דוגמא לתגובה כאשר השירות בניסון פעיל:
{
"responseStatus": "OK",
"license": {
"allowed": true,
"trial": true,
"trialStart": 1779705344,
"trialEnd": 1780310144
}
}
דוגמא לתגובה — אין רישיון, ניסיון זמין:
{
"responseStatus": "OK",
"license": {
"allowed": false,
"reason": "no_license",
"trialAvailable": true
}
}
הפעלת ניסיון חינם - startTrial
הפעולה היא - startTrial
מפעיל ניסיון חינם של 7 ימים. ניתן לבצע את הפעולה בכל מערכת פעם אחת בלבד!.
מענה בעת הצלחה
| מאפיין |
סוג |
הסבר |
דוגמא |
| responseStatus |
string |
סטטוס הפעולה |
OK |
| trialStarted |
boolean |
האם הניסיון הופעל כעת |
true |
| alreadyLicensed |
boolean |
האם כבר היה רישיון פעיל |
true |
| license |
object |
פרטי הרישיון לאחר הפעלה |
|
{
"responseStatus": "OK",
"trialStarted": true,
"license": {
"allowed": true,
"trial": true,
"trialStart": 1779705344,
"trialEnd": 1780310144
}
}
קבלת שיחות - getCalls
הפעולה היא - getCalls
שירות זה דורש רישיון פעיל.
הפרמטרים הנדרשים בנוסף (אופציונליים):
| פרמטר |
תיאור |
סוג |
ברירת מחדל |
| includeEnded |
כלול שיחות שהסתיימו (כלומר שלא בחיוג / בשיחה כרגע) (ended[]) בתגובה |
0 או 1 |
0 |
| onlyEnded |
החזר רק שיחות שהסתיימו, ללא שיחות פעילות |
0 או 1 |
0 |
| endedLimit |
מגבלת מספר שיחות שהסתיימו להחזיר (האחרונות לפי זמן ניתוק, כאשר הראשון הוא החדש ביותר) |
number |
30 |
| accounts |
מערך חשבונות לסינון — רק חשבונות אלו יוחזרו. מצריך POST עם JSON body |
array |
ללא סינון |
מענה בעת הצלחה
| מאפיין |
סוג |
הסבר |
| responseStatus |
string |
סטטוס הפעולה |
| summary |
object |
סיכום המכיל את המידע המצטבר מכלל החשבונות שנבחרו |
| accounts |
object |
המפתח — key הוא שם החשבון, value הוא נתוני החשבון |
| license |
object |
מצורף רק כשהרישיון הוא רישיון התנסות, עם מידע עוד כמה זמן הוא פג תוקף וכו כמו שנכתב למעלה |
מבנה summary:
| מאפיין |
סוג |
הסבר |
| totalActive |
number |
סה"כ שיחות פעילות כרגע |
| dialing |
number |
שיחות במצב חיוג |
| inCall |
number |
שיחות בשיחה ממש |
| totalCalls |
number |
סה"כ שיחות (היסטוריה שבועית ~~ יבואר למטה) |
| totalIncoming |
number |
סה"כ נכנסות |
| totalOutgoing |
number |
סה"כ יוצאות |
| totalAnswered |
number |
סה"כ נענו |
| totalMissed |
number |
סה"כ לא נענו |
| totalTalkTimeSeconds |
number |
סה"כ זמן שיחה בשניות |
| totalRecorded |
number |
סה"כ מספר שיחות שהוקלטו הוקלטו |
מבנה כל חשבון ב-accounts:
| מאפיין |
סוג |
הסבר |
| summary |
object |
סטטיסטיקות החשבון (אותם שדות כמו summary הכללי - רק כלפי החשבון הספציפי הזה) |
| calls |
array |
מערך שיחות שיחות פעילות כרגע |
| ended |
array |
שיחות שהסתיימו (רק אם includeEnded=1 או onlyEnded=1) |
מבנה שיחה (calls / ended):
| מאפיין |
סוג |
הסבר |
דוגמא |
| id |
string |
מזהה שיחה ייעודי |
"3f2a1b..." |
| account |
string |
שם חשבון ה-SIP |
"06558877=2" |
| callType |
string |
סוג שיחה |
"IN" / "OUT" |
| source |
string |
מספר מקור |
"050000000" |
| destination |
string |
מספר יעד |
"0773133333=2" |
| startTime |
number |
Unix timestamp — תחילת השיחה |
1779710278 |
| answeredTime |
number|null |
Unix timestamp — מענה (null אם לא נענה) |
1779710282 |
| endTime |
number|null |
Unix timestamp — ניתוק (null אם עדיין פעיל) |
null |
| status |
string |
מצב השיחה |
"dialing" / "in_call" / "ended" |
| hasRecord |
boolean |
האם יש הקלטה |
true |
| recordPath |
string|null |
נתיב ההקלטה |
"ivr2://Trash/SIPRecord/DID-..." |
| history |
array |
רצף אירועי השיחה - יבואר למטה |
|
מבנה history event:
| מאפיין |
סוג |
הסבר |
דוגמא |
| event |
string |
סוג האירוע |
"start" / "answer" / "transfer" / "end" |
| time |
number |
Unix timestamp |
1779710278 |
| to |
string |
יעד ההעברה (רק באירוע-transfer) |
"05200000" |
דוגמא לתגובה מלאה:
{
"responseStatus": "OK",
"summary": {
"totalActive": 2,
"dialing": 1,
"inCall": 1,
"totalCalls": 4395,
"totalAnswered": 219,
"totalMissed": 4176,
"totalIncoming": 4380,
"totalOutgoing": 15,
"totalTalkTimeSeconds": 13515,
"totalRecorded": 16
},
"accounts": {
"0888888888=2": {
"summary": {
"totalActive": 1,
"dialing": 0,
"inCall": 1,
"totalCalls": 250,
"totalAnswered": 8,
"totalMissed": 242,
"totalTalkTimeSeconds": 480,
"totalRecorded": 1
},
"calls": [
{
"id": "3f2a1b4c-5d6e-7f8g-9h0i-1j2k3l4m5n6o",
"account": "0888888888=2",
"callType": "IN",
"source": "050000000",
"destination": "0888888888=2",
"startTime": 1779710278,
"answeredTime": 1779710282,
"endTime": null,
"status": "in_call",
"hasRecord": true,
"recordPath": "ivr2://Trash/SIPRecord/DID-xxxx-Phone-xxxx-routing-4446464646=2-Date-2026-05-25-19-00-00.wav",
"history": [
{
"event": "start",
"time": 1779710278
},
{
"event": "answer",
"time": 1779710282
},
{
"event": "transfer",
"time": 1779710290,
"to": "079999999"
}
]
}
],
"ended": []
}
}
}
קבלת שיחות לחשבון ספציפי - getCallsByAccount
הפעולה היא - getCallsByAccount
שירות זה דורש רישיון פעיל.
הפרמטרים הנדרשים בנוסף:
| פרמטר |
תיאור |
סוג |
| account |
שם חשבון ה-SIP |
string |
| includeEnded |
כלול שיחות שהסתיימו |
0 או 1 |
מענה בעת הצלחה
| מאפיין |
סוג |
הסבר |
| responseStatus |
string |
סטטוס הפעולה |
| account |
string |
שם החשבון שנשאל |
| summary |
object |
סטטיסטיקות החשבון |
| calls |
array |
שיחות פעילות |
| ended |
array |
שיחות שהסתיימו (רק אם includeEnded=1) |
{
"responseStatus": "OK",
"account": "09948949494=2",
"summary": {
"totalActive": 1,
"dialing": 0,
"inCall": 1,
"totalCalls": 250,
"totalAnswered": 8,
"totalMissed": 242,
"totalTalkTimeSeconds": 480,
"totalRecorded": 1
},
"calls": [],
"ended": []
}
שימו לב:
השירות מיועד להיות שירות לקבל מידע בזמן אמת על מצב חשבונות ה SIP במערכת - ועל כן כל הנתונים לא נשמרים לטווח ארוך.
נכון לכתיבת שורות אלה - אלה פחות או יותר הזמנים שנשמרים הנתונים לאחר שהם כבר לא ״זמן אמת״:
| נתון |
זמן שמירה |
| שיחה בחיוג (dialing) |
5 דקות — פג תוקף אוטומטית אם לא נענתה |
| שיחה פעילה (in_call) |
עד 2.5 שעות מרגע המענה |
| שיחה שהסתיימה |
20 דקות |
| סטטיסטיקות |
7 ימים |
שיחות שמועברות: כל העברה מתועדת כ-event מסוג transfer ב-history עם שדה to המכיל את מספר היעד, אבל לא יוצרת שיחה חדשה או מזהה שיחה ייחודי.
