מודול sip - הגדרות לחיוג מטלפון משרדי או משלוחת sip
-
ב"ה.
בפוסט הבא מרוכזות כל ההגדרות לגבי שלוחת sip, וכן ההגדרות של חיוג יוצא.
סוג השלוחה:
type=sip
קישורים לתוספים שניתנים להגדרה בכל מודול
רשימת כל ההגדרות שניתנות להטמעה בכל מודול
הגדרות זיהוי בכניסה לשלוחה
הסבר על הודעת ברוכים הבאים (הודעה ראשונה בשלוחה)
הרשאות כניסה לשלוחה
מחייג למספר יוזר של המערכת. ניתן להגדיר לאיזה מספר חשבון של המערכת הוא יחייג:
account_dial_number=3או לחלופין, להגדיר שיחייג למספר שלוחה מסויימת במערכת:
account_dial_extension=495בשימוש עם מספר שלוחה ניתן להגדיר להוציא את השיחה לכמה מספרי שלוחות בו זמנית, הראשון שיענה השיחה תפסיק לצלצל לשאר.
יש לשים את מספרי השלוחה מופרדים בפסיקים. למשל:account_dial_extension=4652,496,111,65974,4848,4545,5454,45454,5851את מספרי השלוחות של החשבונות ניתן להגדיר באתר בלשונית "מרכזיה עסקית".
ניתן להגדיר מוזיקה בהמתנה בחיוג:
sip_music_on_hold=שם המוזיקה בהמתנהניתן להגדיר הקלטת שיחות נכנסות:
sip_record=yesההקלטות ישמרו בסל מחזור תחת תיקיה
SIPRecordIn.
הקלטה של שיחה שלא נענתה לא נשמרת.ניתן לשמור, בנוסף להקלטה הרגילה, קובץ נפרד לכל צד בשיחה:
sip_record_split=yesלצד ההקלטה ייווצרו שני קבצים נוספים באותו שם, עם סיומת
-account(הצד של החשבון) ו--remote(הצד השני).שימו לב: הגדרות ההקלטה, המייל והדו"ח שבשלוחה גוברות על ההגדרות שבקובץ
sip_configuring.iniשל המערכת (ראו בהמשך). הגדרה שלא נקבעה בשלוחה נלקחת מהקובץ. למשל, אם בקובץ מוגדרsip_record=yesובשלוחהsip_record=no, שיחות שעוברות דרך השלוחה לא יוקלטו.ניתן לבקש שליחה למייל:
sip_send_mail=yesברירת מחדל שולח למייל המוגדר במערכת. ניתן להגדיר למייל אחר:
sip_send_mail_to=my@yemot.co.ilכברירת מחדל, המערכת שומרת דו"ח שיחות (נמצא בתיקיית SipLogs)
כדי לבטל את שמירת הדו"ח בשיחות נכנסות יש להגדירsip_ymgr_logger=noזמן חיוג
ברירת מחדל מחייג 35 שניות, אם רוצים להגדיר זמן אחר, ניתן להגדירsip_timeout=23כאן בדוגמה רואים שזמן ההמתנה יהיה 23 שניות.
לאחר ההמתנה יעבור לסיום, וכדלהלן.מעבר בסיום בשלוחה
ברירת מחדל לאחמ"כ חוזר שלב אחד אחורה ניתן להגדיר מעבר לשלוחה אחרת או ניתוק | ראה כאן את האפשרויות להגדרה.
ההגדרה היא:sip_dial_end_go_to=/1/1/1/1בחירת מחדל מבצע אותה פעולה גם אם השיחה לא נענת, ניתן להגדיר שאם הסתיים החיוג ולא היה מענה יושמע תפריט
M3519המאפשר חיוג חוזר או סיום:sip_tfr_redial_if_no_answer=yesניתן להגדיר מעבר לשלוחה אחרת/ניתוק באם לא היה מענה ללא תפריט חיוג חוזר:
sip_no_answer_goto=/0ניתן להגדיר לאן ללכת/לנתק במידה שלא היה מענה כתוצאה מזה שזמן החיוג נגמר:
sip_timeout_goto=/1מתקדם:
ברירת מחדל, ישנה צורה מסויימת שהמזהה של השיחה (זיהוי) נשלח, ישנם טלפונים שלא אוהבים את זה, וכל השיחות נראה שהם נכנסות מהמספר של המערכת, ניתן לשנות את הצורה של שליחת הזיהוי:
reverse_caller_id=yesברירת מחדל, נשלחים כותרות (headers) עם מידע על השלוחה, מזהה השיחה, ועוד. ישנם טלפונים או ראוטרים שזה גורם לכך שלא יכנסו שיחות נכנסות בכלל, ניתן לבטל את שליחת הכותרות:
sip_not_send_spacel_headers=yes
הגדרות לשיחות נכנסות לחשבונות ה-SIP של המערכת -
sip_configuring.iniיש לשים ערכים בקובץ
sip_configuring.iniשתחת השלוחה הראשית. במערכת מסוג "חיוג SIP" לא ניתן להגיע לקבצים דרך האתר הרגיל - יש לבצע את הפעולה דרך האתר החדש.הגדרות שחלות על כל שיחה שנכנסת לחשבון SIP של המערכת
מכל מקום שממנו הגיעה: סוג מערכת "חיוג SIP", מספר משנה שמחייג לחשבון, שלוחת
type=sip(הגדרות השלוחה גוברות), מודול תור וניתוב שיחות לפי תור, וחיוג פנימי מחשבון SIP אחר של המערכת.הגדרה הסבר sip_record=yesלהקליט sip_record_split=yesקובץ נפרד לכל צד בשיחה, בנוסף להקלטה sip_send_mail=yesלשלוח את ההקלטה גם למייל sip_send_mail_to=my@yemot.co.ilמייל שונה מהמערכת sip_ymgr_logger=noלבטל את דו"ח השיחות (תיקיית SipLogs) sip_webhook_url=https://example.com/sip_call_end.phpנתוני השיחה בסיומה לשרת שלכם, ראו בהמשך דוגמה לקובץ:
sip_record=yes sip_record_split=yes sip_webhook_url=https://example.com/sip_call_end.phpההקלטות נשמרות בסל מחזור בתיקיה
SIPRecordIn. הקלטה של שיחה שלא נענתה לא נשמרת.
כשהשיחה הגיעה מתור של המערכת והתור מקליט, השיחה לא מוקלטת פעם נוספת. בדו"ח ובנתוני השיחה מופיעה ההקלטה של התור.הגדרות לסוג מערכת "חיוג SIP" ולמספר משנה שמחייג לחשבון
הגדרה הסבר sip_music_on_hold=שם המוזיקהמוזיקה בהמתנה reverse_caller_id=yesלשנות את צורת הזיהוי בשיחות נכנסות sip_timeout=30זמן חיוג בשניות (ברירת מחדל 35)
הגדרות ליחידה הטלפונית - שיחה יוצאת מהחשבון:
את כל ההגדרות הכלליות יש להכניס לתוך קובץ
sip_out_configuring.iniשתחת השלוחה הראשית. במידה שהמערכת מוגדרת על סוג מערכת "חיוג SIP" לא ניתן להגיע לקבצים דרך האתר הרגיל - יש לבצע את הפעולה דרך האתר החדש.על מנת להפעיל הקלטת שיחות יוצאות יש להגדיר:
sip_record=yesההקלטות ישמרו בסל מחזור בתיקיה
SIPRecord.
על מנת לבקש גם שליחה למייל יש להגדיר:sip_send_mail=yesבחירת מחדל שולח למייל המוגדר במערכת, ניתן להגדיר מייל מיוחד:
sip_send_mail_to=my@yemot.co.ilכברירת מחדל, המערכת שומרת דו"ח שיחות (נמצא בתיקיית SipLogs)
כדי לבטל את שמירת הדו"ח בשיחות יוצאות יש להגדירlogger=noניתן לשמור, בנוסף להקלטה, קובץ נפרד לכל צד בשיחה (סיומת
-accountלצד של החשבון ו--remoteלצד השני):sip_record_split=yesהקלטה של שיחה שלא נענתה לא נשמרת.
ניתן לקבל את נתוני השיחה בסיומה לשרת שלכם:
sip_webhook_url=https://example.com/sip_call_end.phpראו בהמשך: "קבלת נתוני השיחה לשרת שלכם (webhook)".
מוזיקה בהמתנה במהלך השהייה של השיחה, בחירת מחדל מושמעת מוזיקה בהמתנה בחירת מחדל אם אתה מעבירים את הלקוח להמתנה, ניתן להגדיר מוזיקה בהמתנה מיוחדת לערוץ:
musicclass=המוזיקה שלכם.על מנת לקבוע זיהוי יוצא למדינה ספציפית, יש להכניס הגדרה
sip_out_callerid_XXכאשר במקום יש להכניס קוד מדינה בשתי אותיות.
למשל, ארה״ב זה US.
ואז, בערך, להכניס את הזיהוי (הוא צריך להיות זיהוי מאושר/מספר משנה במערכת כמובן) לפי תקן E164.
לצורך הדוגמא, אם רוצים להגדיר זיהוי יוצא לשיחות בארה״ב, מגדירים:sip_out_callerid_US=+134770770770770שיחה יוצאת מחשבון הSIP היא בעלות יחידה לדקה, מלבד אם משתמש בקידומת פנימית, להלן הסבר.
ניתן לחייג פנימית לחשבון sip אחר של אותה מערכת, שימו לב, זה רק לשלוחת sip אחרת, זה לא חיוג למערכת תוכן אלא לשלוחת הSIP שלה. חיוג פנימי לחשבון של מערכת אחרת לא יתבצע.
יש שלוש דרכים לחייג לחשבון אחר במערכת:
1. לפי מספר השלוחה של החשבון
אם הגדרתם לחשבונות מספרי שלוחה (באתר, בלשונית "מרכזיה עסקית"), מחייגים את מספר השלוחה, בלי קידומת. למשל, לחשבון שמספר השלוחה שלו 201 מחייגים:2012. לפי שם החשבון, עם הקידומת
1*
מתחילים את השיחה ב1*. במילים: אחד כוכבית, ואחריו שם החשבון שאליו רוצים לחייג.
שם החשבון הראשי של המערכת הוא מספר המערכת. שם של כל חשבון נוסף הוא מספר המערכת, הסימן=ומספר החשבון.
למשל, במערכת 0773137770, כדי לחייג לחשבון הראשי יש להקיש:1*0773137770וכדי לחייג לחשבון מספר 2:
1*0773137770=2את הסימן
=לא ניתן להקיש במקלדת של מכשיר טלפון רגיל, לכן ממכשיר כזה חייגו לחשבונות הנוספים לפי מספר שלוחה או בחיוג מקוצר.3. בחיוג מקוצר
בקובץsip_speed_local_dial.iniמגדירים קיצור לכל חשבון, ומחייגים1*ואחריו הקיצור.
דוגמא למופיע בקובץ:1=0773137770 2=0773137770=2 29=0773137770=3ואז ניתן לחייג בטלפון לפי הקיצור.
למשל, כדי להגיע לחשבון0773137770=2אפשר לחייג ל:1*2כדי להגיע ל
0773137770=3אפשר לחייג1*29איזורים
אם החשבונות במערכת מחולקים לאיזורים (איזור שלוחה), חיוג לפי מספר שלוחה מחפש קודם באיזור של החשבון המחייג, ואם לא נמצא - בכל המערכת. אם הוגדרה לאיזור "נעילת שלוחות", חשבון באיזור הזה יכול לחייג רק לחשבונות של אותו איזור, בכל אחת משלוש הדרכים. הסבר מלא על איזורים ועל נעילת שלוחות כאן.במקרה של שיחה פנימית אין כלל חיוב יחידות.
שיחה פנימית נרשמת אצל שני החשבונות: אצל החשבון המחייג כשיחה יוצאת, לפי
sip_out_configuring.ini, ואצל החשבון שמקבל אותה כשיחה נכנסת, לפיsip_configuring.ini(הקלטה, דו"ח שיחות ונתוני שיחה - webhook).ישנה אפשרות גם להגדיר חיוגים מקוצרים כללים - ממש תרגום של כל מספר למספק אחר. (מינימום של מספר זה 2 ספרות) זה בקובץ
sip_speed_dial.ini
דוגמא למופיע בקובץ:050000000=0773137770 100=0773137777 55=0733137770ואז חיוג ל 050000000 יתחלף בזמן החיוג ל 0773137770
חיוג ל 100 יתחלף בזמן החיוג ל 0773137777
חיוג ל 55 יתחלף בזמן החיוג ל 0733137770
קבלת נתוני השיחה לשרת שלכם (webhook)
בסיום כל שיחה של חשבון SIP במערכת, נכנסת או יוצאת, שנענתה או שלא נענתה, ניתן לקבל לשרת שלכם את כל נתוני השיחה.
לשיחות נכנסות ההגדרה היא בקובץ
sip_configuring.ini, ולשיחות יוצאות בקובץsip_out_configuring.ini:sip_webhook_url=https://example.com/sip_call_end.phpניתן להוסיף לכתובת פרמטרים קבועים (למשל מפתח זיהוי של המערכת שלכם), כל פרמטר בשורה נפרדת:
sip_webhook_add_1=token=abc123 sip_webhook_add_2=system=officeבדוגמה הזו הכתובת שתיקרא היא
https://example.com/sip_call_end.php?token=abc123&system=office
לא ניתן לכתוב בערכים שבקובץ את התווים& ; | ( ) < > $ ' ", ולכן כל פרמטר נכתב בשורה משלו.הנתונים נשלחים ב-POST, כטופס רגיל (
application/x-www-form-urlencoded), ברקע, כך שהשליחה לא מעכבת את השיחה.
השדות זהים לשדות של שיחה בפעולה getCalls, עם כמה תוספות. כל הזמנים במילישניות (Unix).שדה הסבר id מזהה השיחה (זהה למזהה ב-getCalls) account חשבון ה-SIP, למשל 0773137770=2callType IN- שיחה נכנסת,OUT- שיחה יוצאתsource המספר שממנו הגיעה השיחה destination היעד: בשיחה נכנסת - החשבון, בשיחה יוצאת - המספר שחויג startTime תחילת השיחה answeredTime זמן המענה (ריק אם השיחה לא נענתה) endTime סיום השיחה status endeddialStatus תוצאת החיוג (ראו טבלה בהמשך) hasRecord האם יש הקלטה: true/falserecordPath נתיב ההקלטה recordPathAccount הקובץ של הצד של החשבון (רק כשיש קובץ נפרד לכל צד) recordPathRemote הקובץ של הצד השני (רק כשיש קובץ נפרד לכל צד) history[N][event] אירועי השיחה לפי הסדר: start,answer,transfer,endhistory[N][time] זמן האירוע history[N][to] באירוע transfer- המספר שאליו הועברה השיחהtransfer[to] המספר שאליו הועברה השיחה (רק בשיחה שהועברה) transfer[time] זמן ההעברה transfer[answeredTime] זמן המענה אחרי ההעברה transfer[dialStatus] תוצאת החיוג של ההעברה transfer[recordPath] הקלטת החלק שאחרי ההעברה (אם מוקלט) הערכים העיקריים של
dialStatus:ערך הסבר ANSWER השיחה נענתה NOANSWER לא נענתה עד שהסתיים זמן החיוג BUSY תפוס או שהשיחה נדחתה CANCEL המתקשר ניתק לפני המענה CHANUNAVAIL החשבון לא מחובר שיחה שהועברה (העברה עיוורת או העברה מתווכת) מדווחת פעם אחת, בסיום האמיתי של השיחה, עם אירוע
transferב-historyופרטי ההעברה ב-transfer.
כשהשיחה הגיעה מתור שמקליט,recordPathמצביע על ההקלטה של התור.דוגמאות לנתונים שנשלחים
(השדות נשלחים מקודדים כטופס. כאן הם מוצגים לא מקודדים, לנוחות הקריאה.)
שיחה נכנסת שנענתה, עם קובץ נפרד לכל צד:
id=xSP-1794560253.0 account=0773137770=2 callType=IN source=0501234567 destination=0773137770=2 startTime=1794560253168 answeredTime=1794560256209 endTime=1794560371714 status=ended dialStatus=ANSWER hasRecord=true recordPath=ivr2://Trash/SIPRecordIn/DID-0773137770-Phone-0501234567-routing-0773137770=2-Date-2026-11-13-10-57-33.wav recordPathAccount=ivr2://Trash/SIPRecordIn/DID-0773137770-Phone-0501234567-routing-0773137770=2-Date-2026-11-13-10-57-33-account.wav recordPathRemote=ivr2://Trash/SIPRecordIn/DID-0773137770-Phone-0501234567-routing-0773137770=2-Date-2026-11-13-10-57-33-remote.wav history[0][event]=start history[0][time]=1794560253168 history[1][event]=answer history[1][time]=1794560256209 history[2][event]=end history[2][time]=1794560371714שיחה נכנסת לחשבון שלא מחובר:
id=xSP-1794560265.6 account=0773137770=3 callType=IN source=0501234567 destination=0773137770=3 startTime=1794560265989 answeredTime= endTime=1794560265994 status=ended dialStatus=CHANUNAVAIL hasRecord=false recordPath= history[0][event]=start history[0][time]=1794560265989 history[1][event]=end history[1][time]=1794560265994שיחה יוצאת שהחשבון העביר למספר אחר:
id=xSP-1794560338.24 account=0773137770=2 callType=OUT source=0773137770 destination=0527654321 startTime=1794560338969 answeredTime=1794560342018 endTime=1794560455520 status=ended dialStatus=ANSWER hasRecord=true recordPath=ivr2://Trash/SIPRecord/DID-0773137770-Phone-0773137770-routing-0527654321-Date-2026-11-13-10-58-59.wav history[0][event]=start history[0][time]=1794560338969 history[1][event]=answer history[1][time]=1794560342018 history[2][event]=transfer history[2][time]=1794560401025 history[2][to]=0581112222 history[3][event]=end history[3][time]=1794560455520 transfer[to]=0581112222 transfer[time]=1794560401025 transfer[answeredTime]=1794560405071 transfer[dialStatus]=ANSWER transfer[recordPath]=ivr2://Trash/SIPRecord/DID-0773137770-Phone-0773137770-routing-0581112222-Date-2026-11-13-11-00-02.wav
בברכה,
-
א אברהם צבי התייחס לנושא זה ב
-
N nk. 0 התייחס לנושא זה ב
-
צ צדיק תמים התייחס לנושא זה ב
-
ש שמואל 9 התייחס לנושא זה ב
-
ש שמחה - זו הסיסמא התייחס לנושא זה ב
-
ת תפארת יעקבב התייחס לנושא זה ב
-
ס סוד כמוב התייחס לנושא זה ב
-
ש שמואל ש. התייחס לנושא זה ב
-
C CUBASE התייחס לנושא זה ב
-
פ פלוס התייחס לנושא זה ב
-
ע עידו התייחס לנושא זה ב
-
B BEN ZION התייחס לנושא זה
שלום! נראה שהשיחה הזו מעניינת אותך, אבל עדיין אין לך חשבון.
נמאס לכם לגלול בין אותם הפוסטים בכל ביקור? כשנרשמים לחשבון, תמיד תחזרו בדיוק למקום שבו הייתם קודם, ותוכלו לבחור לקבל התראות על תגובות חדשות (בין אם במייל, ובין אם בהתראת פוש). תוכלו גם לשמור סימניות ולפרגן ב-upvote לפוסטים כדי להביע הערכה לחברי קהילה אחרים.
בעזרת התרומה שלך, הפוסט הזה יכול להיות אפילו טוב יותר 💗
הרשמה התחברות