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

[שמואל]

פוסט זה נמחק!

[שמואל]

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

השירות מאפשר להפעיל קמפיין לרשימת מספרים - שבעת המענה לשיחה השיחה תיכנס למערכת לשלוחה מסויימת.

הפקודה היא - CallExtensionBridging

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

פרמטר	תיאור	סוג
token	טוקן	string
phones	רשימת מספרים. ראה להלן צורות תמיכה ברשימת מספרים	string / json
ivrPath	שלוחה במערכת, למשל: ivr2:/1/100 - יכניס לשלוחה 1/100	string
callerId	זיהוי שיחה יוצא, ברירת מחדל זיהוי של המערכת/רשימת התפוצה שנבחרה	string
callsTimeOut	זמן חיוג מקסימלי - בשניות, ברירת מחדל 30 שניות, מקסימום 35 שניות.	number

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

פרמטר phones יכול להכיל רשימת מספרים בדומה לשירות RunTzintuk:

---

כאשר הפניה היא בGET או בPOST שהוא לא (Content-Type: application/json) יש 3 אפשריות:

• רשימה מפורשת עם הפרדה של : בין מספר למספר
• מספרים מתוך רשימת תפוצה קיימת על ידי ציון tpl:XX כשאשר במקום הXX יש לכתוב את מזהה רשימת התפוצה.
• צינתוק לרשימת צינתוק חינמי (שימו לב הערה למטה בנוגע לאפשרויות שליחה לכמה רשימות צינתוקים חינמיים) על ידי ציון tzl:XX כאשר במקום XX יש לכתוב את מספר הרשימה במערכת.
  כאשר הפניה היא json - ניתן גם לשלוח את רשימת המספרים כמערך:

{
    "phones": [
        "0510000",
        "0510001",
        "0510002",
        "0510003"
    ]
}

או כמערך עם אובייקטים לצורך ציון זיהוי יוצא ספציפי לכל מספר:

{
    "phones": [
        {
            "phone": "0511111",
            "callerId": "077313"
        },
        {
            "phone": "05111333",
            "callerId": "07731344"
        }
    ]
}

או על אותו הדרך עם קבוצות:

"phones": [
        {
            "phones": [
                "0511111",
                "051111221"
            ],
            "callerId": "077313"
        },
        {
            "phones": [
                "0511111999"
            ],
            "callerId": "077414"
        }
    ]

---

חיוב יחידות:

על כל מספר שנכנס לחיוג יש חיוב של 0.1 יחידות,
על כל שיחה שנענת, יש חיוב של יחידה לדקה, עם מינמום חיוב של 0.5 יחידות.

שימו לב, ניתן להפעיל בשירות זה קמפיין עם עד 500 מספרים.

---

מענה בעת הצלחה:

פרמטר	סוג	הסבר	דוגמא
responseStatus	string	סטטוס הפעולה	OK
module	string	המודול של השלוחה שהשיחות יגיעו אילה	menu
callerId	string	זיהוי השיחה היוצאת	0770770770
callsCount	int	כמות מספרים שנכנסו לקמפיין	6
bilingPerCall	int	חיוב לכל שיחה (משוער)	1
errors	object	מערך של מספרים שלא נכנסות לחיוג ושגיאה	{ "0510001": "not Vaild", "0510002": "not Vaild", "0510003": "not Vaild" }
callsTimeout	int	זמן שיחה יוצאת כפי שנקלט	30
campaignId	string	מזהה קמפיין במערכת הקמפיינים	YA-1-0770770770-Yemot-1695290243349441

[שמואל]

קבלת רישומים לחשבון SIP - SipGetContexts

---

הפקודה היא - SipGetContexts

בכל פניה יש לצרף:

פרמטר	תיאור	סוג
token	טוקן	string
accountNumber	ניתן לציין מספר חשבון sip, באם ריק, זה החשבון הראשון	string

מענה בעת הצלחה

מאפיין	סוג	הסבר	דוגמא
responseStatus	string	סטטוס הפעולה	OK
contexts	array	טבלאת רישומים	מערך, יבואר מטה מבנה האובייקט

אובייקט במערך contexts

בעיקרון, לא אמור להיות יותר מרישום אחד פעיל.

מאפיין	סוג	הסבר	דוגמא
expiration_time	string	זמן התפוגה של הרישום, באם השלוחה שולח keep_alive - הזמן מתארך	2024-06-04 15:43:38
uri	string	הURI לחיוג בפועל לשיחה נכנסת	sip:0773137770@192.168.1.99:5060
user_agent	string	הפלטפורה שמחוברת	Yealink SIP-T29G
via_addr	string	ניתוב דרך. זה יכול להיות גם כתובת פנימית של השלוחה	192.168.1.110
via_port	string	ניתוב בפורט	5060

[שמואל]

קבלת חשבונות הSIP במערכת בדגש על בדיקה אם הם רשומים - GetSipAccountsRegisteredStatus

---

הפקודה היא - GetSipAccountsRegisteredStatus

בכל פניה יש לצרף:

פרמטר	תיאור	סוג
token	טוקן	string

מענה בעת הצלחה

מאפיין	סוג	הסבר	דוגמא
responseStatus	string	סטטוס הפעולה	OK
accounts	array	טבלאת חשבונות	מערך, יבואר מטה מבנה האובייקט

אובייקט במערך accounts

מאפיין	סוג	הסבר	דוגמא
userName	string	שם המשתמש של החשבון	0773137770
createdDate	string	זמן יצירת החשבון	2021-06-26 23:00:00
registered	bool	האם רשום?	true

[שמואל]

קבלת זיהויים מאושרים במערכת להוצאת שיחות/סמסים

---

הפקודה היא - GetApprovedCallerIDs

כל המספרים הם במבנה e164

בכל פניה יש לצרף:

פרמטר	תיאור	הערות
token	טוקן

מענה בעת הצלחה

מאפיין	סוג	תיאור	דוגמה
responseStatus	string	סטטוס הפעולה	OK
call	object	זיהויים לשיחות	יבואר מטה מבנה האובייקט
sms	object	זיהויים לשיחות	יבואר מטה מבנה האובייקט

אובייקט call

מאפיין	סוג	תיאור
mainDid	string	המספר הראשי של המערכת
secondaryDids	array	מערך מספרי משני
callerIds	array	מערך זיהויים מאושרים חיצוניים

אובייקט sms

מאפיין	סוג	תיאור
smsId	string	זיהוי הסמסים (אם יש זיהוי סמסים, זה אומר שסמסים יוצאים רק איתו, אם לא, ניתן לבחור בכל זיהוי שיחה גם לסמס)
allowText	bool	האם מאושר זיהויים טקסט

[שמואל]

בדיקת זיהוי האם הוא מאושר לשימוש בשיחה/סמס

---

הפקודה היא - IsCallerIDApproved

בכל פניה יש לצרף:

פרמטר	תיאור	הערות
token	טוקן
callerId	זיהוי לבדיקה
serviceType	סוג שירות לבדיקה. ברירת מחדל שיחות	sms אוcall

מענה בעת הצלחה

מאפיין	סוג	תיאור	דוגמה
responseStatus	string	סטטוס הפעולה	OK
parsedCallerId	string	המספר כE164	+972773137770
isApproved	bool	האם מאושר
reason	string	סיבה	INVALID_CALLER = זיהוי לא תקין / SMS_ID = נעילת זיהוי סמסים / INCLUDE = רשימת מספרים מורשים

[אהרן שובקס]

ניהול בקשות לשיחה חוזרת (מודול תור)

---

הפקודה היא - QueueCallBack

בכל פנייה יש לצרף:

פרמטר	תיאור	סוג
token	טוקן	string
action	פעולה לביצוע	string

---

פעולות:

קבלת רשימת התורים

הפעולה היא - getQueues

מענה בעת הצלחה:

מאפיין	סוג	הסבר	דוגמה
responseStatus	string	סטטוס הפעולה	OK
callbackList	array	רשימת התורים	[{...}]

דוגמת אובייקט של תור:

מאפיין	סוג	הסבר	דוגמה
id	integer	מזהה התור	110
path	string	השלוחה שבו הלקוח נרשם	"/1"
queue_path	string	שלוחת התור	"/1"
caller_id	string	זיהוי לשיחה היוצאת	0773137770
callback_times	string	זמני התור	weekDay=1-5&monthDay=&month=&year=*&time=09:15-16:30&open=true
max_waiting_time	integer	זמן מקסימלי לחכות בתור (בדקות)	120
max_waiting_customers	integer	מספר הלקוחות המרבי בתור	1
waiting_customers	integer	מספר הלקוחות הממתינים כעת בתור	0
open	boolean	אם התור פתוח או לא	1

---

---

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

הפעולה היא - getList

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

פרמטר	תיאור	סוג
id	מזהה התור	integer

מענה בעת הצלחה:

מאפיין	סוג	הסבר	דוגמה
responseStatus	string	סטטוס הפעולה	OK
callbackList	array	רשימת השיחות הממתינות	[{...}]

דוגמת אובייקט של שיחה:

מאפיין	סוג	הסבר	דוגמה
id	integer	מזהה השיחה	84299
calling_number	string	מספר המתקשר	"0533137770"
status	string	סטטוס השיחה	"waiting"
date_time	string	תאריך ושעת השיחה	"2025-05-14T14:37:11.000Z"
attempts	integer	מספר הניסיונות לבצע שיחה חוזרת	0
last_attempt	string	מועד הניסיון האחרון	null

---

מחיקת שיחה

הפעולה היא - removeNumber

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

פרמטר	תיאור	סוג
id	מזהה השיחה	integer

מענה בעת הצלחה:

מאפיין	סוג	הסבר	דוגמה
responseStatus	string	סטטוס הפעולה	OK
callbackList	string	הודעת הצלחה	OK

---

[שמואל]

קבלת הסמסים שהתקבלו למערכת

---

הפקודה היא - GetIncomingSms

בכל פניה יש לצרף:

פרמטר	תיאור	הערות
token	טוקן
limit	הגבלת תוצאות	ברירת מחדל 100 תוצאות. מקסימום 3000.
startDate	מתאריך	למשל: 2025-06-01 19:48:01
endDate	עד תאריך	למשל: 2025-06-03 00:00:00

מענה בעת הצלחה

מאפיין	סוג	תיאור	דוגמה
responseStatus	string	סטטוס הפעולה	OK
rows	array	מערך סמסים שהתקבלו	יבואר מטה

מבנה סמס במערך rows

מאפיין	סוג	תיאור	דוגמה
source	string	מקור	972773137770
destination	string	יעד	972773137770
message	string	תוכן ההודעה	הודעת בדיקה
receive_date	string	תאריך קבלת ההודעה	2025-06-03 19:58:03

[שמואל]

ניהול/ביצוע אימות דו-שלבי

---

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

בכל פניה יש לצרף:

פרמטר	תיאור	סוג
token	טוקן	string
action	פעולה לביצוע	string

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

פעולות:

---

בדיקת האם הסשן עבר אימות דו-שלבי - isPass

הפעולה היא - isPass

כל סשן חייב להיות במצב ״pass״ של מנגנון האימות הדו-שלבי, אחרת עליו לבצע אימות דו-שלבי בפועל - לפני היכולת להשתמש עם כל שירות אחר בAPI. כאשר סשן לא עבר אימות דו שלבי - הוא יכול לגשת רק לשירות MFASession - וגם בו - לחלקים מסויימים. הדברים יבוארו בהמשך.

---

דרישה מקדימה לשימוש בשירות זה: אין.
מצב שבו השירות לא זמין: אין.

פירוט מענה:

מאפיין	סוג	הסבר	דוגמא	הערה
responseStatus	string	סטטוס הפעולה	OK
isAvailable	boolean	האם יש יכולת לבצע אימות דו-שלבי - מבחינת שיש שיטות אימות זמינות.	true	כאשר סשן לא עבר אימות - ואין אפשרות טכנית לאמת אותו - לא ניתן לבצע שום פעולות.
isPass	boolean	האם הסשן עבר אימות בהצלחה	true	לאחר שהסשן אומת - ישנם פעולות שלא ניתן לבצע בגלל זה, אבל ניתן להשתמש בסשן לטובת גישה לכל השירותים (שלא דורשים אימות קשיח - יבואר בהמשך).
passReason	string	סיבת מעבר מנגנון האימות הדו שלבי.	MFA_PASSED	ישנם הרבה סיבות למה הסשן עבר את מנגנון האימות הדו שלבי - ניתן לראות בטבלא את הסיבות האפשריות.
isPassInThisSession	boolean	האם הסשן עבר אימות בפועל בחיבור הנוכחי (אימות קשיח)	true	בהמשך לפרמטר מעלה - ישנם מצבים שבו הסשן ״עבר״ את מנגנון האימות הדו-שלבי - בגלל סיבות ש״פוטרות״ אותו מהצורך לבצע אימות דו שלבי בפועל - אבל לא בוצע ממש באותו הסשן אימות דו-שלבי. ישנם פעולות שדורשות ״אימות קשיח״ = רמה חזקה יותר של אימות - וזה דורש שיבוצע אימות דו-שלבי ממש באותו החיבור ממנו רוצים לגשת לשירותים האלה.

פירוט סיבות מעבר אימות:

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

סיבת מעבר	הסבר	הערה
INACTIVE_SYSTEM	מנוע האימות הדו שלבי לא פעיל או לא זמין
WAIT_TO_BLOCK_DATE	תאריך אכיפת השירות לא הגיע	במצב שבו מגדירים זמן מסויים ממנו חובה לעבור אימות דו שלבי - כל עוד הזמן לא הגיע - כל הסשנים עוברים ״בהצלחה״ במנגנון - כי תאריך אכיפת השירות לא הגיע.
INIT_WHITELIST_IPS	כתובת IP ברשימה לבנה	כתובת הIP שממנה בוצעה הבקשה למעבר - קיבלה אישור כי היא נמצאת ברשימה הלבנה.
INIT_MASTER_LOGIN_WHITELIST_IPS	כתובת IP ברשימה לבנה בהתחברות מאסטר	כתובת הIP שממנה בוצעה הבקשה למעבר - קיבלה אישור כי היא נמצאת ברשימה הלבנה כאשר מתבצע התחברות עם סיסמת מאסטר של ריסיילר.
HAVE_ACTIVE_TRUST_TOKEN	בוצע מעבר על ידי אסימון ״זכור אותי״
INHERITED_FROM_ORIGINAL_SESSION	ירושה מסשן קודם כל שהוא	למשל, בעת מעבר מהאתר ניהול הרגיל לממשק חיצוני - נוצר טוקן API שסיבת המעבר שלו היא שכבר בוצע מעבר בסשן קודם.
MFA_PASSED	בוצע אימות בפועל בחיבור הנוכחי	אין להסתמך על הסיבה בלבד בנושא ״אימות קשיח״ - אלא להסתמך על isPassInThisSession
SPECIAL_VALID_TOKEN	טוקן שנוצר עם פטור מאימות מסיבה מיוחדת

---

ניסיון ביצוע אימות - try

הפעולה היא - try

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

---

דרישה מקדימה לשימוש בשירות זה: אין.
מצב שבו השירות לא זמין: לאחר מעבר שקיבל החלטת ״עבר״ (isPass: true).

פירוט מענה (מענה זהה ל isPass - רק שהנתונים יהיו לאחר ביצוע ניסיון אימות):

ניסיונות מרובים לבצע מעבר ב try שלא יצליחו - כלומר שלא יהיה מעבר בהם - יובילו לחסימת המערכת כולה לעבור אימות דו שלבי.

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

---

קבלת שיטות אימות זמינות - getMFAMethods

הפעולה היא - getMFAMethods

פעולה זו יכולה להחזיר נתונים שונים לפני ואחרי ביצוע אימות קשיח.

---

דרישה מקדימה לשימוש בשירות זה: אין.
מצב שבו השירות לא זמין: אין.

פירוט מענה:

מענה זהה ל isPass - בתוספת מערךmfaMethods עם שיטות האימות הזמינות. להלן פירוט של אובייקט מתוך המערך:

מאפיין	סוג	הסבר	דוגמא	הערה
ID	int	מזהה שיטה	1	מזהה השיטה אינו קבוע - ונבנה בצורה דינמית בעת הבקשה. צריך לפנות איתו בשביל לבצע אימות - אבל אי אפשר להתסמך לאורך זמן שהוא יהיה אותו הדבר.
STATUS	string	סטטוס שיטת האימות	ACTIVE	שיטה יכולה להיות ACTIVE = פעילה, או PENDING = ממתינה. שיטה ממתינה לאימות לא יכולה לשמש לטובת ביצוע אימות קשיח. יש לאמת אותה קודם.
MFA_METHOD_ID	int	מזהה שיטה קבוע	6598	בניגוד לשדה ID - מזהה השיטה שפה הוא קבוע, אבל זה אומר שהוא נוסף בצורה יזומה - ולא מוצע בצורה אוטמאטית, ויתכן שיהיה ריק.
NIKE	string	תיאור מקור שיטת האימות	RESET_MAIL	יכול להיות: CREATE_PHONE = המספר שיצר את המערכת. RESET_MAIL המייל לשחזור. PROFILE הגיע מהפרופיל הקבוע. MASTER_LOGIN הגיע מהתחברות מאסטר של ריסיילר. BY_CUSTOMER נוסף על ידי הלקוח.
NOTE	string	תיאור חופשי שנכתב בעת הוספת השיטה	הטלפון בבית
SEND_TYPE	סוגי שליחות אפשריות	מערך של שיטות שליחת אימות אפשריות	["CALL","SMS"]	יכול להיות: CALL = בשיחה. SMS בהודעת סמס. EMAIL בהודעה למייל. ישנם שיטות שלא יהיה אפשרי לשלוח עבורם בצורה יזומה אימות, והמערך עבורם יהיה ריק.
VALUE	string	היעד של השיטה	+972773137770	כאשר לא בוצע אימות קשיח - היעד לא יוצג במלואו ויראה למשל: shmu•••@•••.co.il כאשר מספר ה• אינם משקפות את האורך האמיתי של הערך.
EXPIRED_DATE	string	זמן תפוגת השיטה	2025-09-28 12:11:38	שיטות שפגו תוקף - לא יוצגו אחרי זה בכלל, ויש להוסיף ולאמת אותם מחדש.
LAST_USED	string	הזמן האחרון שהשיטה אומתה בהצלחה	2025-09-28 12:11:38	שיטות שלא יבצעו אימות הרבה זמן - יתכן ולא יהיה זמינות בפועל או יוסרו.

---

שליחת אימות לטובת אימות קשיח/מעבר - sendMFA

הפעולה היא - sendMFA

שליחת אימות יכולה להיות רלוונטית כאשר רוצים לבצע אימות קשיח בסשן שעבר את המנגנון - או במקרה שהסשן לא עבר try וחייב לבצע אימות.

---

דרישה מקדימה לשימוש בשירות זה: אין.
מצב שבו השירות לא זמין: לאחר ביצוע אימות קשיח (isPassInThisSession: true).

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	הסבר
mfaId	מזהה שיטת האימות אליה רוצים לשלוח אימות	int
mfaSendType	סוג האימות הרצוי - מתוך SEND_TYPE	string
lang	שפת שליחת האימות.	string	HE או EN. ברירת מחדל ישלח בעברית.
autoOtpHostname	כתובת ה HOST_NAME שנמצאים בו לטובת הוספה שלו בסמס	string	מאפשר להשתמש עם OTPCredential בצד לקוח. רשות.

פירוט מענה:

כאשר responseStatus הוא OK השיחה/סמס/מייל - נשלחו.

כל שליחה חוזרת - תיצור קוד חדש - ותבטל את הקוד הקודם.
לכל סשן יש בקשת אימות ממתינה אחד בלבד.
שליחות רבות עלולות לחסום את המערכת ו/או את כתובת הIP מלשלוח לזמנים ארוכים מאד. בעת חסימה יופיע בפירוט הזמן שיש להמתין:

{
    responseStatus: "Exception",
    message: "exception send by customer. wait 55s",
    file: "CustomerMFA.class.ym",
    Line: "590:19",
    yAfastVersion: "6.7.30"
}

כאשר בדוגמא מופיע wait 55s - 55 שניות.
כאמור, הזמן יכול לעלות למספרים גבוהים מאד באם מתבצעים נסיונות רבים.

---

ביצוע אימות בפועל לאחר שליחת אימות - validMFA

הפעולה היא - validMFA

---

דרישה מקדימה לשימוש בשירות זה: אין.
מצב שבו השירות לא זמין: לאחר ביצוע אימות קשיח (isPassInThisSession: true).

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	הערה
mfaCode	קוד האימות שהתקבל	string
mfaRememberMe	יצירת אסימון ״זכור אותי״ בעת הצלחה	boolean	אסימון ״זכור אותי״ שנוצר ב API ייצור רק אסימון מסוג IP.
mfaRememberNote	תיאור לאסימון ״זכור אותי״ החדש.	string

פירוט מענה:

מאפיין	סוג	הסבר	דוגמא	הערה
responseStatus	string	סטטוס הפעולה	OK
mfa_valid_status	string	האם בוצע אימות.	VALID	יכול להיות UNVALIDאו VALID , או OVERTRY - שאומר שיש צורך לשלוח אימות חדש- כי עברו מספר הנסיונות האפשריים.
mfa_valid_trys	int	כמות הפעמים שבוצע ניסיון אימות קוד	1
mfa_valid_left	int	כמות הפעמים שנשארו לבצע ניסיון אימות לפני שהקוד לא רלוונטי	4
mfa_valid_message	string	הסבר מיוחד מדוע הקוד לא אומת.	validMFA not allow. over trys attempt

---

הוספת שיטת אימות חדשה - addMethod

הפעולה היא - addMethod

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	אופציות
mfaNewType	סוג שיטה	string	מייל - EMAIL או טלפון - PHONE
mtaNewValue	הערך של השיטה החדשה	string	המייל או הטלפון.
mtaNewValidNote	תיאור של השיטה החדשה	string	למטרות נוחות בלבד. לא חובה.
newExpiredDate	זמן תפוגה של השיטה	string	תאריך תפוגה בתבנית YYYY-MM-DD HH:mm:ss.

שימו לב:

• ניתן להוסיף עד 20 שיטות אימות
• ניתן להוסיף מספרי טלפון של המדינות הבאות: ישראל, ארה״ב, קנדה.

פירוט מענה:

כאשר responseStatus הוא OK השיטה נוספה כממתינה לאימות, כאשר בפרמטר methodId מצויין מזהה השיטה לטובת האימות שלה/מחיקה שלה בעתיד.

---

אימות או שליחת אימות חוזר של שיטת אימות חדשה - reValidMethod

הפעולה היא - reValidMethod

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	הסבר נוסף
mfaId	מזהה שיטת האימות	string	מתקבל כתגובה אחרי היצירה בפרמטר methodId, או בפרמטר MFA_METHOD_ID בפעולה getMFAMethods בתוך מערך mfaMethods כמו שהוסבר למעלה.
mfaSendType	סוג האימות הרצוי - מתוך SEND_TYPE	string
lang	שפת שליחת האימות.	string	HE או EN. ברירת מחדל ישלח בעברית.
autoOtpHostname	כתובת ה HOST_NAME שנמצאים בו לטובת הוספה שלו בסמס	string	מאפשר להשתמש עם OTPCredential בצד לקוח. רשות.

פירוט מענה:

כאשר responseStatus הוא OK הקוד לאימות נשלח.

---

ביצוע אימות של שיטה חדשה לאחר שליחת אימות - validMethod

הפעולה היא - validMethod

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	הסבר נוסף
mfaId	מזהה שיטת האימות	string	מתקבל כתגובה אחרי היצירה בפרמטר methodId, או בפרמטר MFA_METHOD_ID בפעולה getMFAMethods בתוך מערך mfaMethods כמו שהוסבר למעלה.
mfaCode	קוד האימות שהתקבל	string

פירוט מענה:

זהה לתגובת בקשה אימות בפועל - validMFA.

---

מחיקת שיטת אימות - deleteMethod

הפעולה היא - deleteMethod

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

ניתן למחוק שיטות פעילות או ממתינות לאימות, אך לא ניתן למחוק שיטות שמגיעות מהפרופיל/רייסילר/מספר שפתח וכו.

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	הסבר נוסף
mfaId	מזהה שיטת האימות	string	מתקבל כתגובה אחרי היצירה בפרמטר methodId, או בפרמטר MFA_METHOD_ID בפעולה getMFAMethods בתוך מערך mfaMethods כמו שהוסבר למעלה.

פירוט מענה:

כאשר responseStatus הוא OK השיטה נמחקה.

---

קבלת אסימוני ״זכור אותי״ פעילים - getMFATrustTokens

הפעולה היא - getMFATrustTokens

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

פירוט מענה:

בפרמטר trustTokens יש מערך אסימונים, להלן המבנה:

מאפיין	סוג	הסבר	דוגמא	הערה
id	int	מזהה אסימון	1	משמש לטובת מחיקתו
trust_key_type	string	סוג אסימון	YM_CALL2ALL_WEBSITE	יכול להיות או YM_CALL2ALL_WEBSITE אסימון אימות של אתר הניהול. או CUSTOMER_IP אסימון כתובת IP.
create_by	string	נוצר על ידי	192.168.1.1
create_date	string	זמן יצירה	2025-09-28 21:56:52
update_by	string	עודכן על ידי	192.168.1.1	עדכון אסימון מתבצע כאשר מסמנים ״זכור אותי״ עם אסימון שכבר שמור.
update_date	string	זמן עדכון	null
last_use	string	זמן שימוש בפועל	null	כאשר מתבצע שימוש באסימון - ומעבר של המנוע בגללו - הזמן מתעדכן.
trust_note	string	הערת האסימון מזמן היצירה	המחשב שלי	פרמטר mfaRememberNote בבקשת validMFA.

---

מחיקת אסימון ״זכור אותי״ - deleteTrustToken

הפעולה היא - deleteTrustToken

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	הסבר נוסף
trustTokenId	מזהה האסימון	string	מתקבל בid בבקשת getMFATrustTokens.

פירוט מענה:

כאשר responseStatus הוא OK האסימון נמחקה.

---

קבלת כתובות IP לבנות - getMFATrustIps

הפעולה היא - getMFATrustIps

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

פירוט מענה:

בערך trustIps מערך כתובות IP לבנות.

---

שמירת כתובות IP לבנות - setMFATrustIps

הפעולה היא - setMFATrustIps

---

דרישה מקדימה לשימוש בשירות זה: לאחר ביצוע אימות קשיח (isPassInThisSession: true).
מצב שבו השירות לא זמין: אין

שימו לב: ניתן להוסיף עד 50 כתובות.
כתובת IP לבנה תעבור MFA עם סיבה INIT_WHITELIST_IPS כפי שהוסבר למעלה.
כתובת IP לבנה עדיין תצטרך לבצע אימות קשיח בשביל לקבל isPassInThisSession: true לטובת ביצוע פעולות רגישות.
ניתן להוסיף כתובות IPv4 או IPv6.

בכל פניה יש לצרף:

פרמטר	תיאור	סוג	הסבר נוסף
trustIps	רשימת כתובות IP	string/array	כאשר שולחים string ההפרדה תיהיה בין שורה לשורה. בשליחה מערך כל איבר זה כתובת.

פירוט מענה:

מאפיין	סוג	הסבר	דוגמא	הערה
responseStatus	string	סטטוס הפעולה	OK
okCount	int	מספר הכתובות שנוספו בהצלחה	1
save	boolean	האם בוצע שינוי בפועל	true	יהיה false אם הרשימה לא השתנתה.
valid_new_list	array	מערך הכתובות החדש
errors	array	מערך שגיאות	[ "ip: 0.192.66.2222 is not valid" ]

[שמואל]

מוניטור 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 המכיל את מספר היעד, אבל לא יוצרת שיחה חדשה או מזהה שיחה ייחודי.