ביקורת תוכן ותמונות

היכרות​

docs/getting-started/introduction.md

היכרות​

חברת MASKYOO הינה חברה בינלאומית המספקת פתרונות מדידה טלפוניים למפרסמים בכל סוגי המדיה.

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

החזון של MASKYOO מבוסס על הטענה כי הכול מדיד. לכן, פיתחה החברה כלים אוטומטיים מתקדמים וקלים לשימוש במטרה להפוך את התחום לנגיש יותר לכלל סוגי הלקוחות.

כיצד זה עובד​

בשימוש במערכת מסקיו למדידת שיחות, צריך פשוט לבחור מספר טלפון לפרסום העסק (המספרים זמינים בקידומות שונות ומגוונות), ואז יש להזין מספר טלפון יעד (מספר טלפון של העסק) אשר אליו יופנו השיחות.

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

יתרונות המערכת​

מערכת מסקיו מאפשרת גישה 24/7 לניתוחים מפורטים מכל דפדפן, וכן דיווח מפורט על שיחות שבוצעו למספר המפורסם במודעה או באינדקס, יחד עם:

• ניהול פשוט - ניהול פשוט של מספרי הלקוח
• התראות אוטומטיות - התראות באימייל או ב-SMS ללקוחות המציגות שיחות שהוחמצו או נענו, פרטי המתקשר, שעת השיחה ומשך השיחה
• ניתוב שיחות גמיש - בחירה באופן החיוג ליעדי השיחה: חיוג במקביל, מוביל נגרר או נתב שיחות
• הודעה מותאמת אישית - קובץ השמעה מותאם אישית למקבל השיחה אשר מכריז על שיחה שהגיעה דרך הפרסום שלך כאשר השיחה נענית
• ניתוב לפי זמנים - ניתוב מותאם אישית לפי שעות וימי פעילות העסק
• מעקב קמפיינים - מעקב בעזרת מילות מפתח ושם קמפיין שמראה כיצד המתקשר הגיע אל האינדקס או המודעה
• קמפיינים דינאמיים - הכנסת תוסף של מספרים דינאמיים אשר מתחלפים באתר בהתאם לתנאי נבחר ומשפרים את ניטור השיחות, וכתוצאה מכך את קידום האתר דרך מדידה מעמיקה יותר של השיחות הנכנסות דרך האתר

השפעות על המערכת​

היכרות עם אופן העבודה של מסקיו מסבירה את שרשרת הרכיבים שמשפיעים זה על זה:

• מספרי מסקיו — נקודת הכניסה של כל שיחה; מתקשרים חיצוניים מחייגים אליהם והם מנתבים למספר היעד של העסק
• ניתוב (IVR / אלגוריתם חיוג) — המנגנון שמחליט איך ולאן להעביר את השיחה (במקביל, מוביל נגרר, נתב שיחות מלא)
• אוטומציה — לאחר סיום השיחה, אירועים מופעלים (SMS, דוא״ל, WebHook, Google Analytics, CRM)
• דוחות — כל שיחה שהתקבלה נרשמת וזמינה לניתוח; מתחילה להצטבר מהשיחה הראשונה
• משתמשים והרשאות — מגדירים מי יכול לראות מה; מנהל ראשי רואה הכל, משתמשי דוחות רואים רק נתונים, מנהל אופרציה מנהל מספרים
• תוספים — Google Ads, קמפיינים דינמיים ו‑SDK‑Pixel מחברים את מסקיו למערכות שיווק ולאתרי אינטרנט

ראו גם​

• מושגים ומונחים
• תחילת עבודה
• הגדרת חשבון מסקיו
• ניהול מספרי מסקיו
• נתב שיחות (IVR)
• אוטומציה

מושגים ומונחים​

docs/getting-started/concepts-and-terms.md

מושגים ומונחים​

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

מונחים בסיסיים​

מספר מסקיו​

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

תיאור מסקיו​

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

מספר היעד​

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

מספר המתקשר​

מספר אשר ממנו בוצעה שיחה למספר מסקיו.

משתמש מסקיו​

משתמש מסקיו (מנהל מערכת או אדם אחר) יכול להתחבר למערכת מסקיו למדידת שיחות ו/או לקבל דוחות יומיים, שבועיים וחודשיים במטרה לשפר את פרסום העסק.

עסק / לקוח​

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

לקוח קצה​

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

קריאת שירות (פנייה)​

פנייה שנפתחת מול מוקד התמיכה של מסקיו ישירות מתוך המערכת (במסך פניה לשרות לקוחות), עם נושא הנבחר מקטגוריה ותת-קטגוריה, תיאור, רמת דחיפות, סטטוס (פתוח/סגור) והתכתבות עם נציג.

סוגי וסטטוסי שיחות​

שיחות שנענו​

שיחות שנענו על ידי מספר היעד.

שיחות שלא נענו​

שיחות שלא נענו על ידי מספר היעד, מסיבות שונות. ישנם שלושה סטטוסים אפשריים:

שיחות שלא חוברו​

שיחות שכלל לא מגיעות למספר היעד מאחת מהסיבות הבאות:

שיחות ייחודיות​

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

שיחות ננטשות​

שיחות שהתקבלו לשרת של מסקיו ומעולם לא נענו על ידי העסק - לא על ידי מענה אנושי ולא על ידי מענה אוטומטי.

סטטוס המסקיו​

מושגי זמן​

משך שיחה​

משך שיחה מוגדר כזמן בשניות מרגע המענה לשיחה (בין אם מענה אנושי או על ידי מענה אוטומטי) עד לניתוק השיחה על ידי אחד הצדדים.

זמן המתנה למענה​

זמן המתנה למענה הוא הזמן שעבר מרגע החיוג ועד למענה של השיחה על ידי אדם או מענה אוטומטי.

השפעות על המערכת​

המושגים האלה אינם הגדרות שניתן לשנות — הם האופן שבו המערכת מודדת ומציגה נתונים. לכן הם משפיעים על כל רכיב שצורך מידע:

• סטטוס השיחה (נענתה / תפוסה / כשל / חסומה) — אותו סיווג משמש בלוח הבקרה, בכל הדוחות, ובפילטרים של אוטומציה; שינוי בהגדרות המספר (זמן המתנה למענה, שעות פעילות) משפיע איזה סטטוס יינתן
• סטטוס המסקיו (פעיל / מושהה / משוחרר) — משפיע אם השיחה בכלל תעבור ליעד; מסקיו מושהה עדיין ייספר ב‑CDR אבל ידחה את השיחה
• שיחה ייחודית — בסיס לחישוב של כל הדוחות מסוג "Unique" (מסקיו ייחודיות, תקופתיות, לפי קידומת)
• משך שיחה — בסיס לחישוב דקות וממוצעים בלוח הבקרה ובדוחות; גם סף לטריגר אוטומציה (רק שיחות מעל X שניות)
• "שיחות ננטשות" — חופף אך שונה מ‑"שיחות שלא נענו"; קריטי להבנה נכונה של דו"ח שיחות ננטשות

ראו גם​

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

תחילת עבודה עם מסקיו​

docs/getting-started/getting-started.md

תחילת עבודה עם מסקיו​

צעד 1 - קבלת אישור גישה לממשק מסקיו​

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

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

צעד 2 - תיאום הדרכת מערכת עם הצוות הטכני​

איש מצוות התמיכה הטכנית של מסקיו ייצור איתך קשר כדי לתאם מועד הדרכה. ההדרכה תתבצע בטלפון באמצעות שיתוף מסך. במהלך ההדרכה יוגדרו הגדרות בסיסיות במערכת.

צעד 3 - בחירת מספרי מסקיו והגדרות מתקדמות​

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

בתפריט הראשי של מסקיו ניתן להגדיר וליצור תכונות נוספות המותאמות לצרכי המערכת שלך:

אוטומציה​

• יצירת אירוע חדש - הגדרת אירועים אוטומטיים
• שליחת SMS - הודעת SMS אוטומטית
• שליחת אימייל - הודעת אימייל אוטומטית
• שליחת נתונים ל-CRM - שליחת WebHook
• נתונים לגוגל אנליטיקס - שליחת אירועים ל-GA

ניהול משתמשים​

• יצירת משתמשים נוספים - מנהלי מערכת, משתמשי דוחות וכו'

דוחות​

• שליחת דוחות אוטומטיים - יצירת דוחות מתוזמנים

השפעות על המערכת​

תהליך תחילת עבודה יוצר את התצורה הראשונית של החשבון — ולכן משפיע על כל פעילות המערכת מנקודה זו:

• אישור גישה — פותח את החשבון ומאפשר הקצאת מספרי מסקיו ראשונים; ללא זאת אי אפשר לקבל שיחות
• הדרכה טכנית — הגדרות שמתבצעות בהדרכה (אזור זמן, פורמט תאריך, שפת מערכת) נשמרות ברמת חשבון ומשפיעות על כל המשתמשים
• הגדרת מספרי היעד — קובעת לאן יעברו השיחות; שינויים עתידיים נעשים במסך ניהול המספרים
• אלגוריתם חיוג ושעות עבודה — משפיעים על סטטוס השיחה (נענתה / כשל / מחוץ לשעות) בכל הדוחות
• יצירת משתמשים נוספים — כל משתמש מקבל סינון נתונים משלו בהתבסס על שיוכי המספרים
• הגדרות אוטומציה ראשוניות — אירועים ראשונים קובעים אילו התראות יישלחו ממעגל השיחות הראשון

ראו גם​

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

כניסה למערכת והזדהות​

docs/getting-started/login-and-authentication.md

כניסה למערכת והזדהות​

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

תהליך ההתחברות​

1. במסך הכניסה יש להזין את כתובת הדוא"ל של המשתמש וללחוץ על "הבא".
2. המערכת שולחת קוד אימות (בדוא"ל או ב-SMS, בהתאם לשיטת האימות שהוגדרה) ומציגה את שלב הזנת הסיסמה.
3. יש להזין את הסיסמה ואת קוד האימות הדו-שלבי, וללחוץ על "התחבר". לאחר התחברות מוצלחת מוצג לוח הבקרה.

שיטות האימות הדו-שלבי​

הכניסה הדו-שלבית מחויבת עבור כל המשתמשים. שיטת האימות אחידה לכל החשבון ונקבעת על ידי מנהל המערכת בהגדרות המערכת, בלשונית הגדרות האבטחה, בשדה "סוג כניסה דו-שלבית":

• קוד בדוא"ל (ברירת המחדל) — קוד בן שש ספרות נשלח לכתובת הדוא"ל של המשתמש.
• קוד ב-SMS — הקוד נשלח למספר "טלפון SMS" המוגדר בחשבון המשתמש.
• קוד בדוא"ל וב-SMS — הקוד נשלח בשני הערוצים במקביל.
• אפליקציית אימות — בכניסה הראשונה מוצג ברקוד (QR) שיש לסרוק באפליקציית אימות, כדוגמת Google Authenticator. מאותו רגע, בכל התחברות יש להזין את הקוד המוצג באפליקציה. משתמש שהחליף מכשיר יכול לקבל את הברקוד מחדש לכתובת הדוא"ל שלו באמצעות הקישור "צריך קוד QR מחדש?" שבמסך הכניסה.

קוד שנשלח בדוא"ל או ב-SMS תקף ל-10 דקות. אם הקוד לא הגיע או פג תוקפו, ניתן ללחוץ על "שלח קוד אימות חדש".

הגבלות כניסה נוספות​

• הגבלת כתובות IP — אם הוגדרה למשתמש רשימת כתובות IP מורשות, ההתחברות תתאפשר רק מכתובות אלה.
• משתמש מושהה — משתמש שהושהה על ידי מנהל מקבל הודעה מתאימה ואינו יכול להתחבר עד שהחשבון יופעל מחדש.

קוד תמונה (CAPTCHA) לאחר ניסיונות כושלים​

לאחר מספר ניסיונות התחברות כושלים (הסף ניתן להגדרה בהגדרות המערכת) יתווסף למסך הכניסה קוד תמונה. כדי להמשיך בניסיונות ההתחברות יש להעתיק את התווים המופיעים בתמונה.

נעילת חשבון אוטומטית​

כאשר מופעלת נעילה אוטומטית בהגדרות המערכת, המשך ניסיונות כושלים גם לאחר הופעת קוד התמונה נועל את החשבון:

• הסיסמה הקיימת מבוטלת, ובניסיון הכניסה מוצגת הודעה שהחשבון ננעל לאחר ריבוי ניסיונות כושלים.
• למשתמש נשלח דוא"ל "חשבונך ננעל" ובו קישור לאיפוס הסיסמה. תוקף הקישור 15 דקות; אם פג התוקף, ניתן לבצע איפוס דרך "שכחת סיסמה?".
• ניתן להגדיר בהגדרות המערכת כתובת דוא"ל שתקבל התראה אוטומטית על כל נעילת משתמש.

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

שכחתי סיסמה — שחזור סיסמה​

1. במסך הכניסה, תחת "שכחת סיסמה?", יש ללחוץ על הקישור לאיפוס הסיסמה.
2. יש להזין את כתובת הדוא"ל של המשתמש ולשלוח. אם הכתובת רשומה במערכת — יישלח אליה דוא"ל עם קישור לאיפוס הסיסמה.
3. הקישור מוביל למסך איפוס הסיסמה, שבו מזינים סיסמה חדשה פעמיים. הסיסמה החדשה חייבת לעמוד במדיניות הסיסמאות של המערכת (אורך מינימלי ודרישות מורכבות), וכאשר מוגדרת מניעת שימוש חוזר בסיסמאות — לא ניתן לבחור סיסמה ששימשה את החשבון לאחרונה.
4. הקישור חד-פעמי ותקף ל-15 דקות. אם פג תוקפו, יש לחזור על התהליך.

לאחר האיפוס מתחברים למערכת עם הסיסמה החדשה.

פקיעת סיסמה תקופתית​

אם נקבע בהגדרות המערכת מועד מחייב להחלפת סיסמה, סיסמה שלא הוחלפה בפרק הזמן שנקבע — פוקעת. בניסיון הכניסה הבא תוצג הודעה שהחשבון ננעל עקב סיסמה שפג תוקפה, ולמשתמש יישלח דוא"ל עם קישור לקביעת סיסמה חדשה (בתוקף 15 דקות). לאחר קביעת הסיסמה החדשה ניתן להתחבר כרגיל.

יציאה מהמערכת​

• יציאה יזומה — בתפריט המשתמש (לחיצה על שם המשתמש בסרגל העליון) יש לבחור "יציאה". היציאה מסיימת את החיבור הנוכחי ומחזירה למסך הכניסה.
• ניתוק אוטומטי — לאחר פרק זמן ממושך ללא פעילות מוצגת התראה על סיום החיבור, ובהיעדר תגובה המערכת מתנתקת אוטומטית וחוזרת למסך הכניסה. משך הזמן ניתן להגדרה בהגדרות המערכת.

כל התחברות מוצלחת וכל ניסיון כושל נרשמים בלוג הגישה.

ראו גם​

• הגדרת חשבון מסקיו (הפרופיל שלי)
• יצירת משתמש חדש
• ניהול משתמשים
• הגדרות מערכת
• לוג גישה

הגדרת חשבון מסקיו​

docs/getting-started/setting-up-your-maskyoo-platform.md

הגדרת חשבון מסקיו​

הגדרות משתמש ראשי​

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

יש לבחור בתוך חשבון המשתמש בהפרופיל שלי.

תיפתח חלונית עם ארבע לשוניות:

1. מידע אישי​

כאן ניתן להגדיר ולשנות הגדרות כלליות של חשבון המשתמש:

2. שנה תמונת פרופיל​

כאן ניתן להגדיר ולשנות תמונת המשתמש.

3. שנה סיסמה​

בלשונית זו ניתן להגדיר בכל עת סיסמה חדשה. יש להזין את הסיסמה הישנה ופעמיים את הסיסמה החדשה. הסיסמה החדשה חייבת לעמוד במדיניות הסיסמאות המוגדרת בהגדרות המערכת (אורך מינימלי ודרישות מורכבות).

4. שליחת דוחות בדוא"ל​

ניתן לסמן בתיבה הרלוונטית האם רוצים לקבל דוח מובנה של שיחות מסקיו ברמה היומית, השבועית ו/או החודשית. ניתן ללחוץ על דוגמה כדי לראות כיצד הדוח נראה.

לשונית זו היא גרסה מצומצמת של הגדרות הדוחות: מנהל מערכת יכול להגדיר עבור המשתמש הגדרות מפורטות יותר — כותרת הדוא"ל, החלקים שייכללו בדוח ונמענים נוספים — במסך עריכת המשתמש.

השפעות על המערכת​

"הפרופיל שלי" הוא המקום שבו מגדירים העדפות אישיות של המשתמש המחובר — ולכן משפיע רק על אותו משתמש:

• אזור זמן, פורמט תאריך ופורמט שעה — שולטים בהצגת זמנים בכל המסכים שהמשתמש רואה (דוחות, לוח בקרה, CDR)
• שפת מערכת — החלפת שפה משפיעה על התפריטים, הודעות המערכת ושפת ה‑TTS בחלק מרכיבי IVR המוגדרים ל"שפת ברירת מחדל של המשתמש". החלפת השפה גם מחליפה את כיוון הממשק: עברית וערבית מימין-לשמאל (RTL), אנגלית משמאל-לימין (LTR), כולל התאמת בורר התאריכים
• ערכת עיצוב — בחירת ערכת העיצוב (מתוך שש הערכות) משנה את מראה הממשק עבור אותו משתמש בלבד; ברירת המחדל היא הערכה הכהה-כחולה
• סיסמה חדשה — שינוי עצמי ללא צורך באישור מנהל; מדיניות הסיסמאות (אורך מינימלי ודרישות מורכבות) נקבעת בהגדרות המערכת
• דוחות אוטומטיים — סימון דו״ח יומי/שבועי/חודשי מסמן שהמשתמש יקבל דוח מובנה בתדירות שנבחרה. הדוח נשלח אוטומטית לכתובת הדוא״ל של אותו משתמש בלבד. מדובר בדוח מובנה מצומצם; להגדרות מפורטות יותר יש להשתמש בדוחות מתוזמנים
• תמונת פרופיל — תצוגתית בלבד; מוצגת בתפריט המשתמש שבראש המסך

ראו גם​

• היכרות
• כניסה למערכת והזדהות
• מושגים ומונחים
• תחילת עבודה
• יצירת משתמש חדש
• הגדרות מערכת
• דוחות מתוזמנים

לוח בקרה​

docs/dashboard/index.md

לוח בקרה​

לוח בקרה מאפשר לך לראות סקירה כללית של כלל השיחות וההתראות שהתקבלו לכלל המספרים במערכת שלך לפי תקופות זמן נבחרות (דקות, שעה, יום, שבוע וחודש אחרון).

שיחה נספרת במערכת מסקיו לאחר שהתקבלה בשרתי מסקיו. היא נספרת אפילו אם קו הטלפון שלך תפוס, אם המחייג נמצא ברשימה השחורה שלך (כלומר, חסום), במידה והשיחה בוצעה מחוץ לשעות הפעילות ואפילו אם מספר המסקיו אינו פעיל.

הצגת לוח בקרה​

בתפריט הראשי, לחץ על לוח בקרה. להלן מה שיוצג:

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

כלי ניהול לוח בקרה​

בחירת יישומים להצגה​

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

איפוס תצוגה​

בתחתית תפריט ארגז היישומים קיים כפתור איפוס תצוגה (אדום) שמאפס את כל ההתאמות שביצעת:

• מחזיר את כל היישומים לתצוגת ברירת המחדל (אילו מסומנים ואילו לא)
• מחזיר את סדר היישומים לסדר המקורי
• מבצע טעינה מחדש של כל היישומים עם ההגדרות המחודשות

השימוש הנפוץ הוא כאשר רוצים "להתחיל מחדש" לאחר שינויים רבים בסידור היישומים.

גרירה וסידור מחדש​

ניתן לשנות את סדר היישומים בלוח הבקרה באמצעות גרירה:

1. יש למקם את סמן העכבר מעל כותרת היישום שברצונך להזיז — הסמן יהפוך לסמן הזזה (מתחלף ל-cursor של "move").
2. יש ללחוץ ולגרור את היישום למיקום הרצוי.
3. עם שחרור העכבר, הסדר החדש נשמר באופן אוטומטי ומיד ייטען גם בכניסות הבאות.

ריענון אוטומטי​

כל היישומים בלוח הבקרה מתרעננים אוטומטית כל 20 שניות, כך שהנתונים המוצגים הם תמיד עדכניים.

• על כל יישום מופיע בר התקדמות דק (בראש היישום) המציג את הזמן שנותר עד הרענון הבא
• ליד כפתורי הפעולה של כל יישום מופיעה מחוונית זמן (למשל "20s", "5s") המציגה ספירה לאחור
• כאשר לשונית הדפדפן אינה פעילה (הוחלפה ללשונית אחרת), הרענון מושהה אוטומטית כדי לחסוך במשאבים — וממשיך כאשר חוזרים ללשונית
• ניתן גם לרענן ידנית יישום בודד על ידי לחיצה על כפתור הרענון שבכותרת היישום
• כדי לרענן את כל היישומים יחד (למשל לאחר שינוי הגדרה), יש ללחוץ על כפתור רענן הכל שבראש הדף

הסבר על היישומים בלוח בקרה​

נתונים בזמן אמת (מספר שיחות אחרונות)​

יישום זה מציג את כמות השיחות שבוצעה ב-5 הדקות האחרונות, בשעה האחרונה, ומתחילת היום הנוכחי (מחצות). הנתון האחרון מתאפס בכל חצות ומתמלא מחדש במהלך היום, ולכן בשעות הבוקר המוקדמות הוא עשוי לשקף רק חלק קטן מהיום.

התפלגות סטטוס שיחות​

הצגה של אחוזי השיחות שהתקבלו מתחילת היום הנוכחי (מחצות), בחלוקה לשלוש קבוצות סטטוס. האחוזים מתייחסים ליום הנוכחי בלבד ומתאפסים בכל חצות, ולכן בשעות הבוקר המוקדמות הם עשויים להתבסס על מספר קטן של שיחות:

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

שיחות שהתקבלו ב-7 הימים האחרונים​

גרף המציג את השיחות הנכנסות בכל יום (החל מהיום) במשך שבעה הימים האחרונים. ניתן ללחוץ על האפשרויות מתחת לגרף כדי להציג את סך משך השיחות (בדקות) ו/או את כמות השיחות.

בנוסף, ניתן למקם את מצביע העכבר על עמודות הגרף כדי לראות מידע נוסף. דוגמא:

שיחות שהתקבלו ב-31 הימים האחרונים​

גרף המציג את השיחות הנכנסות בכל יום (החל מהיום) במהלך החודש האחרון (כ-31 הימים האחרונים). ניתן ללחוץ על האפשרויות מתחת לגרף כדי להציג את סך משך השיחות בדקות ו/או את כמות השיחות .

נתוני שליחת הודעות (SMS)​

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

נתוני שליחת אימיילים​

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

פירוט שיחות אחרונות​

רשימה דינאמית של השיחות האחרונות שהתקבלו (לאחר שהשיחה הסתיימה). ניתן לבחור את כמות השורות המוצגת (5, 10, 25 או 50) — הבחירה נשמרת לפעם הבאה שתיכנס/י לדף.

עסקים מובילים​

רשימה של מספרי המסקיו המוצגת בסדר יורד לפי כמות השיחות לכל מספר במהלך החודש האחרון. ניתן לבחור את כמות השורות המוצגת (5, 10, 25 או 50).

השפעות על המערכת​

לוח הבקרה מציג מידע מצרפי ולכן מושפע ישירות מכל תת‑מערכת:

• הרשאות משתמש — כל יישום מסנן נתונים רק למספרי מסקיו שהמשתמש משויך אליהם; מנהל ראשי רואה את כל הארגון
• מספרי מסקיו — סטטוס המסקיו (פעיל / מושהה / משוחרר) קובע אילו שיחות נספרות ובאיזה יישום
• CDR (רשומות שיחות) — כל יישום מתבסס על שאילתות לטבלת ה‑CDR; רק שיחות שהסתיימו מוצגות
• אוטומציה — יישומי "נתוני שליחת הודעות" ו"נתוני שליחת אימיילים" סופרים פעולות שבוצעו על ידי אירועי אוטומציה
• שעות עבודה של המספרים — שיחות מחוץ לשעות הפעילות נצבעות ונספרות אחרת
• פריסה אישית — בחירת היישומים והסדר שלהם נשמרת לכל משתמש בנפרד

ראו גם​

• מעקב אחר שיחות
• דוחות
• ניהול מספרי מסקיו
• אירועי אוטומציה
• ניהול משתמשים

מעקב אחר שיחות​

docs/dashboard/monitoring-calls.md

מעקב אחר שיחות מלוח הבקרה​

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

יישומים רלוונטיים למעקב בזמן אמת​

• נתונים בזמן אמת (מספר שיחות אחרונות) — כמות השיחות ב-5 הדקות האחרונות, בשעה האחרונה, ומתחילת היום הנוכחי (מחצות ועד עכשיו). שימו לב: הנתון היומי מציג את שיחות היום עד לרגע זה ולא חלון נע של 24 שעות אחרונות, ולכן בסמוך לחצות הוא עשוי להציג כמות קטנה.
• התפלגות סטטוס שיחות — חלוקה גרפית לשלוש קבוצות: שיחות שנענו, שיחות בסטטוס תפוס, וכלל השיחות שלא נענו (כולל שיחות כשל, מספר מושהה, רשימה שחורה ומחוץ לשעות הפעילות) — מסייעת לזהות במהירות מגמות של שיחות שלא נענו.
• פירוט שיחות אחרונות — רשימה מתעדכנת של השיחות האחרונות שהסתיימו. לחיצה על שיחה פותחת את פרטיה במלואם.
• עסקים מובילים — המספרים הפעילים ביותר ב-30 הימים האחרונים, מסודרים לפי כמות השיחות. הדירוג מתעדכן בכל ריענון של היישום ומשקף צבירה חודשית מתגלגלת, ולא פעילות ברגע נתון.

מעקב על שיחה פעילה​

לוח הבקרה מציג רק שיחות שהסתיימו; שיחות הנמצאות כעת בתהליך (שטרם הסתיימו) יופיעו ביישומים רק לאחר סיומן, בריענון הבא.

מה לעשות כאשר זוהתה חריגה​

• אחוז שיחות כשל / תפוסה גבוה במיוחד — יש לבדוק את הגדרות המספר הרלוונטי (זמני המתנה, יעדי השיחה, שעות פעילות).
• עלייה חדה בנפח השיחות — אפשר למנוע גודש ולהקל על העומס בשיחות על ידי הוספת יעדי שיחה או שינוי אלגוריתם החיוג.
• זיהוי מספרי ספאם ושיחות לא רצויות — ניתן להוסיף את מספר המתקשר לרשימה השחורה דרך מסך ניהול הרשימה השחורה.

השפעות על המערכת​

מעקב אחר שיחות מלוח הבקרה משפיע ומושפע:

• מספרי מסקיו — היישומים מראים רק מספרים שלמשתמש יש הרשאה אליהם (סינון לפי DDI נגיש)
• סטטוס השיחה — חישוב "נענו / תפוס / לא נענו" מבוסס על נתוני השיחות; שינויי מצב משתקפים בריענון הבא (20 שניות)
• רשימה שחורה — הוספת מספר לרשימה השחורה (במסך ניהול הרשימה השחורה) מונעת קבלת שיחות עתידיות ומתעדכנת בלוג השינויים
• אוטומציה — התראות SMS/דוא״ל שנשלחו לגבי השיחה נראות ביישום "נתוני שליחת הודעות" ובדו״ח ההתראות
• דוחות — לוח הבקרה מציג שיחות שהסתיימו בלבד; לניתוח עומק יש לעבור לדוחות הייעודיים

ראו גם​

• לוח בקרה — סקירה מלאה של היישומים וכלי הניהול
• דוחות — לצפייה בנתונים היסטוריים ולניתוח מעמיק
• דו״ח פירוט שיחות
• אירועי אוטומציה
• ניהול רשימה שחורה
• ניהול מספרי מסקיו

דו"חות​

docs/reports/index.mdx

דו"חות מסקיו​

דו"חות מסקיו מאפשרים לך סקירה מקיפה ומעמיקה על השיחות הנכנסות למספרי המסקיו שלך. בדו"חות יש אפשרות לבחור בין דו"חות שונים ומגוונים, לסנן את הבחירות לפי מספרים רצויים, לפי סטטוס מענה לשיחה ועוד — כדי לנתח ולהבין בצורה הטובה ביותר את כמות ואופי השיחות. את הדו"חות ניתן להציג במערכת מסקיו, לייצא לפורמטים שונים (Excel, PDF, XML וכו'), ואף לשלוח באופן אוטומטי לכתובות דוא"ל נבחרות.

כניסה לדו"חות​

בתפריט הראשי יש ללחוץ על דו"חות. להלן מה שיוצג:

ממשק חיפוש ואלמנטים משותפים​

כל הדו"חות חולקים את אותו ממשק חיפוש בסיסי:

בחירת סוג הדו"ח​

בחר/י את סוג הדו"ח מרשימה נפתחת. ברשימה מופיעים כל הדו"חות הזמינים לך במערכת בהתאם להרשאותיך.

הגדרת טווח התאריכים​

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

אפשרויות חיפוש מתקדמות​

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

פירוט אפשרויות הסינון בחיפוש המתקדם:

• סטטוס שיחה — מאפשר לסנן לפי שיחות שנענו, שיחות שלא נענו (כולל סוגי המשנה כמו שיחת כשל, שיחה תפוסה וכו'), שיחות מחוץ לשעות הפעילות ועוד.
• משך שיחה — סינון לפי שיחה הקצרה מזמן מסוים או הארוכה מזמן מסוים (0—1800 שניות).
• סטטוס המסקיו — סינון לפי סטטוס המספר: פעיל, מושהה או משוחרר.
• מספר המסקיו — סינון לפי מספר מסקיו ספציפי או כמה מספרי מסקיו. ניתן להזין מספר או תיאור מסקיו ולבחור מתוך רשימה. בסביבות עם הרבה מספרים המערכת עוברת אוטומטית לחיפוש מסוג השלמה אוטומטית.
• תגיות — סינון לפי תגית/ות שהוגדרו למספרי המסקיו. כאשר נבחרות מספר תגיות יוצגו רק המספרים המשויכים לכלל התגיות הנבחרות.
• משתמשים (למנהלי מערכת בלבד) — סינון לפי משתמשים מסוימים.
• חיפוש טקסט חופשי — כל נתון שרוצים לחפש (מספר טלפון, דוא"ל וכו').

לאחר בחירת כל התנאים יש ללחוץ על כפתור החיפוש . אפשר ללחוץ גם על נקה כדי לאפס את הסינונים.

תוצאות החיפוש​

בראש העמוד יופיעו שלוש תיבות המציגות נתונים מסכמים של תוצאות החיפוש:

• התיבה הירוקה מציגה את מספר דקות השיחה הכולל
• התיבה האפורה מציגה את מספר השיחות הכולל
• התיבה הכחולה מציגה את ממוצע זמן השיחה

תכונות משותפות בטבלאות הדו"חות​

טבלאות הפירוט בכל הדו"חות חולקות מספר תכונות נוחות:

• שינוי רוחב עמודות — ניתן לגרור את הקו המפריד בכותרת כדי להרחיב או לצמצם כל עמודה.
• שינוי סדר עמודות — ניתן לגרור עמודה ולמקם אותה במיקום אחר.
• שמירת ההעדפות — רוחב העמודות וסדרן נשמרים עבורך לכל דו"ח בנפרד, כך שבכניסה הבאה לאותו דו"ח תקבל/י את אותה תצוגה.
• גלילה אופקית — בטבלאות רחבות מהמסך מופיעים כפתורי גלילה אופקית ורמז גלילה מונפש שמסמן שיש עוד עמודות מעבר לקצה.
• כותרת קפואה — בעת גלילה אנכית למטה בטבלה ארוכה, שורת הכותרת נשארת קבועה בראש כדי שתמיד יהיה ברור לאיזו עמודה שייך כל ערך.
• הודעת "לא נמצאו תוצאות" — כשאין נתונים מתאימים מוצגת הודעה "לא נמצאו תוצאות" עם אייקון, במקום טבלה או גרף ריקים.

דו"ח סימניות​

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

בחירת רשימת השדות להצגה​

בכל דו"ח ודו"ח ישנה אפשרות להוריד ולהוסיף עמודות הרלוונטיות לדו"ח. יש ללחוץ על כפתור ולסמן את השדות הרצויים.

ייצוא דו"חות​

כל דו"ח ניתן לייצא לפורמטים שונים. מתפריט הייצוא זמינות האפשרויות הבאות:

• ייצוא לקובץ — בפורמטים XLS‏, CSV‏, PDF ו‑XML.
• שלח בדוא"ל — שליחה חד-פעמית מיידית של הדו"ח לכתובת דוא"ל שתוזן (בשונה מדו"ח מתוזמן, הנשלח באופן קבוע).
• הדפס — הדפסת העמוד המוצג.

יצירת דו"ח מתוזמן​

ניתן להגדיר שליחת דו"חות ספציפיים באופן אוטומטי קבוע בדוא"ל. כל דו"ח מתוזמן נשלח למשתמש מוגדר במערכת שנבחר כנמען. בנוסף, אם למשתמש הנבחר שמורות כתובות דוא"ל נוספות בפרופיל שלו ובחרת באפשרות לשלוח גם אליהן, הדו"ח יישלח גם לאותן כתובות — כך שהנמענים יכולים לכלול גם כתובות חיצוניות מעבר לתיבת המשתמש עצמו.

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

הסבר על יצירת דו"ח מתוזמן

צפייה בפרטים נוספים על שיחות​

בדו"חות רבים ניתן ללחוץ על אייקון זכוכית המגדלת בעמודת הזום כדי לפתוח את דו"ח פירוט השיחות של המסקיו הנבחר.

העתקת ערכים מהטבלה​

בריחוף עם העכבר מעל תא הניתן להעתקה (כגון תיאור המסקיו, מספר המתקשר, מספר המסקיו, מזהה השיחה הייחודי ושדות מותאמים) מופיע אייקון העתקה. לחיצה עליו מעתיקה את ערך התא ללוח ומציגה אישור "הועתק".

סקירה כללית ופעילות​

• 📊 דו"ח סקירה כללית — תמונת מצב כוללת של כלל השיחות במערכת
  → ./overview-report
• 📞 דו"ח פירוט שיחות — רשימה מלאה של השיחות עם כל פרטי כל שיחה
  → ./call-detail-report
• 🏢 דו"ח לפי שם עסק — סיכום שיחות מקובץ לפי מספר מסקיו
  → ./maskyoo-report
• 📈 דו"ח פעילות מסקיו — התפלגות השיחות למספר מסקיו לפי זמן
  → ./maskyoo-activity-report

דו"חות זמן​

• ⏰ דו"ח שעתי — חלוקת שיחות לפי שעות במהלך היום
  → ./hourly-report
• 📅 דו"ח יומי — חלוקה של שיחות לפי ימים
  → ./daily-report
• 🗓️ דו"ח חודשי — סיכום חודשי של פעילות השיחות
  → ./monthly-report

דו"חות ייחודיים (Unique)​

• 🔢 דו"ח שיחות Unique — ספירת מספרי מחייגים ייחודיים ללא חזרות
  → ./unique-calls-report
• 🏬 דו"ח עסקים Unique — שיחות ייחודיות בחלוקה לפי מספרי מסקיו
  → ./maskyoo-unique-calls-report
• ⏳ דו"ח עסקים Unique תקופתי — ניתוח שיחות ייחודיות לפי טווחי זמן
  → ./maskyoo-unique-calls-period-report

דו"חות מקור ויעד​

• 📍 דו"ח לפי מקור שיחה — ניתוח מקורות השיחות הנכנסות
  → ./caller-report
• 🔼 דו"ח מקור שיחה לפי קידומת — התפלגות שיחות לפי קידומת המתקשר
  → ./caller-by-prefix-report
• 🔽 דו"ח יעד שיחה לפי קידומת — התפלגות שיחות לפי קידומת היעד
  → ./callee-by-prefix-report

דו"חות תוכן ואיכות​

• 🏷️ דו"ח לפי תגיות — סיכום השיחות לפי תגיות שהוגדרו
  → ./tags-report
• ⭐ דו"ח מדרוג שיחה — דירוגים שנתנו המשתמשים לשיחות
  → ./call-ratings-report
• ❌ דו"ח שיחות ננטשות — שיחות שהמחייג ניתק לפני מענה
  → ./lost-calls-report
• 🔕 דו"ח מספרי מסקיו שלא ענו — מספרי מסקיו שלא נענתה בהם אף שיחה בתקופה
  → ./maskyoo-not-answered-report
• 📵 דו"ח יעדי שיחה שלא ענו — יעדי שיחה שלא ענו לאף שיחה בתקופה
  → ./destination-not-answered-report
• 🚨 דו"ח התראות — סיכום ההתראות שנשלחו בעקבות שיחות
  → ./notifications-report
• 💬 דו"ח הודעות SMS נכנסות — הודעות ה-SMS שהתקבלו במספרי המסקיו
  → ./sms-incoming-report

דו"חות מגמה וניתוח​

• 📉 דו"ח SWOT — ניתוח חוזקות, חולשות, הזדמנויות ואיומים
  → ./swot-report
• 📈 דו"ח מגמות לפי עסק — קו מגמה של כל מספר מסקיו לאורך זמן
  → ./trends-report-by-maskyoo
• 📊 דו"ח מגמות לפי תגית — קו מגמה של קבוצות מספרים (תגיות)
  → ./trends-report-by-tag
• 👤 דו"ח מגמות לפי משתמש — קו מגמה של השיחות לפי המשתמשים
  → ./user-trends-report

דו"חות Google​

דו"חות Google זמינים רק כאשר תוסף כלי הניתוח של גוגל מופעל ומוגדר במערכת.

• 🎯 דו"ח פירוט שיחות מקמפיינים — שיחות שהגיעו מכל קמפיין Google Ads
  → ./google/google-campaign-calls-report
• 🔍 דו"ח מילות מפתח — השיחות לפי מילת החיפוש שהניעה אותן
  → ./google/google-keyword-report
• 📣 דו"ח קמפיינים אינטרנטיים — סיכום ביצועי כל הקמפיינים
  → ./google/google-campaigns-report
• 📋 דו"ח פירוט שיחות מחיפושים — פירוט רחב של שיחות מקמפיינים וחיפושים
  → ./google/search-call-detail-report

השפעות על המערכת​

מודול הדו"חות הוא שכבת הצריכה של נתוני המערכת — כל הנתונים המוזנים בזרימות אחרות נגישים כאן דרך ממשק אחיד:

• הרשאות משתמש — כל דו"ח מוגבל אוטומטית למספרי המסקיו שהמשתמש מורשה לראותם; מנהל ראשי רואה את הארגון כולו
• אזור זמן המשתמש — קובע את חישוב הימים, השעות והטווחים בכל דו"ח מסתמך על זמן
• מערכת הסינון המשותפת — סטטוס שיחה, משך, תגיות, מספרי מסקיו וטקסט חופשי — פועלת בצורה אחידה בכל הדו"חות
• סימניות (bookmarks) — שמירת הגדרות חיפוש לשימוש חוזר; משמשות בסיס גם לדו"חות מתוזמנים
• ייצוא — כל דו"ח ניתן לייצוא ל‑Excel, PDF, XML ו‑CSV; קבצי הייצוא נוצרים בשרת ומועברים לדפדפן
• דו"חות מתוזמנים — כל דו"ח (בסימנייה) יכול להישלח אוטומטית בדוא"ל על בסיס לוח זמנים קבוע

ראו גם​

• דו"ח סקירה כללית
• דו"ח פירוט שיחות
• דו"ח מתוזמן
• ניהול תגיות
• ניהול משתמשים
• תוסף Google Analyze

דו"ח סקירה כללית​

docs/reports/overview-report.md

דו"ח סקירה כללית​

דו"ח זה מציג מידע מקיף על כמות השיחות לכל מספר מסקיו במערכת, כולל כמות שיחות כללית, כמות שיחות שנענו, כמות שיחות שלא נענו, אחוזי מענה, שיחות ייחודיות, שיחות ננטשות (מתקשרים שאף אחד מניסיונות החיוג שלהם לא נענה) ועמודת סטטוס המציגה האם המספר פעיל.

בתחילת הדו"ח מוצגים סכומי שיחות כוללים, מתחתם מוצגים גרפים אשר מציגים את התפלגות השיחות לפי מספרי המסקיו וגרף ניתוח ביצועים. ובתחתית ישנו שדה הפירוט של הדו"ח, המציג שורת נתונים אחת עבור כל מספר מסקיו. ניתן ללחוץ על זכוכית המגדלת כדי לפתוח את דו"ח פירוט השיחות של אותו מספר מסקיו.

גרף ניתוח ביצועים​

מציג כמות שיחות שנענו, כמות שיחות שהוחמצו וכמות שיחות ייחודיות.

גרף שיחות / משך זמן​

גרף זה מציג את כמות השיחות ומשך השיחה עבור כל מסקיו.

צביעת שורות לפי אחוז מענה​

בטבלת הפירוט מודגשות שורות של מספרים עם אחוז מענה נמוך: שורה שאחוז המענה שלה נמוך מהסף הקריטי נצבעת באדום, ושורה שאחוז המענה שלה נמוך מסף האזהרה נצבעת בצהוב. ריחוף מעל השורה מציג את הסף שלא הושג. את ערכי הספים ניתן להגדיר בהגדרות המערכת.

ברירות המחדל של הספים הן 70% (צהוב) ו-50% (אדום); ניתן לשנותן בהגדרות המערכת תחת "הגדרות ברירות מחדל".

השפעות על המערכת​

דו"ח הסקירה הכללית הוא נקודת הפתיחה לחקירה בשאר הדו"חות — הוא אוסף את הנתונים מכל הארגון ומשפיע על האופן שבו מתחילים בירור:

• הרשאות משתמש — כולל רק את מספרי המסקיו שהמשתמש מורשה עליהם; מנהל ראשי רואה את הארגון כולו
• כלל נתוני השיחות — הדו"ח סוכם את כל השיחות בטווח התאריכים, כולל שיחות שנענו, שלא נענו ושיחות ייחודיות
• נקודת כניסה לדו"חות ממוקדים — לחיצה על זכוכית מגדלת ליד מסקיו מעבירה לדו"ח פירוט שיחות של אותו מספר
• גרפים אגרגטיביים — גרף ניתוח הביצועים וגרף שיחות/משך זמן נבנים מסיכום של כל מספרי המסקיו בתוצאה
• ייצוא — ניתן להוריד את סיכום הארגון לאקסל או PDF לסקירה ניהולית חיצונית

ראו גם​

• דו"ח פירוט שיחות
• דו"ח לפי מסקיו
• דו"ח SWOT
• דו"ח מגמות לפי עסק
• דו"ח מתוזמן

דו"ח פירוט שיחות​

docs/reports/call-detail-report.md

דו"ח פירוט שיחות​

דו"ח פירוט שיחות מציג מידע מקיף על השיחות שהתקבלו, לפי סדר זמנים יורד. (השיחה האחרונה תופיע ראשונה וכן הלאה). זהו דו"ח שימושי ביותר מכיוון שהוא נותן את כל המידע על כל שיחה ושיחה. כל שורה בדו"ח מציגה שיחה שונה שהתקבלה.

עמודות הדו"ח​

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

בחשבונות שבהם מופעל תוסף כלי הניתוח של גוגל, ובכפוף להרשאה מתאימה, זמינות ברשימת השדות עמודות נוספות עם נתוני Google Ads של השיחה: קבוצת מודעות, קמפיין, מיקום מודעה וסוג שיחה.

עמודת הערות​

עמודת ההערות מאפשר להוסיף הערות על שיחות ולקבל מידע נוסף, כמוצג בחלונית להלן:

במידה ויוספו הערות כלשהן לשיחה, סימן ההערות של אותה שורה ייצבע באדום לאחר רענון הדף.

פרטיות ההערות: ההערות הן אישיות — משתמש רגיל רואה ועורך רק את ההערה שהוא עצמו הוסיף לשיחה. מנהלי מערכת חולקים ביניהם הערה משותפת אחת לכל שיחה (הערת המנהל), ואינם רואים את ההערות האישיות של שאר המשתמשים. מחיקת הערה דורשת הרשאת מנהל מערכת.

עמודת מידע נוסף​

עמודה של מידע נוסף מציגה מידע שנשלח מגוגל אנליטיקס במידה והמספר מחובר לממשק זה:

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

עמודת דירוג שיחות​

בעמודה זו יכולים להופיע דירוגי שיחה כפי שנקבעו על ידי הלקוח או בעקבות שיחה מיוחדת. בנוסף, ניתן להזין או לעדכן ערך דירוג באופן ידני דרך שדה דירוג שבחלונית ההערות של השיחה (ראו סעיף עמודת הערות). להלן הסבר על ערכים אפשריים בעמודה זו:

דירוג 0-9​

אפשרות של מקבל השיחה לדרג את השיחה לפי ספרה בין 0 ל-9. הדירוג מתבצע תוך כדי השיחה על ידי לחיצה על ## + ספרה בין 0 ל-9.

B = שיחה חוזרת (callback)​

שיחה חוזרת היא שיחה בה הלקוח (מספר היעד) מתקשר למספר המסקיו שלו בכדי לשמוע מי התקשר אליו ולחזור אליו.

כאשר מספר היעד מחייג למספר המסקיו שמעביר אליו שיחות, מושמעת רשימה של עשרה המתקשרים האחרונים שהחייגו למסקיו, כולל שעת וסטטוס השיחה. לאחר שמוקרא כל מספר, ישנה אפשרות לבצע חיוג לאותו מספר על ידי לחיצה 1, או לשמוע את המספר הבא. לאחר שמסתיימת השיחה, היא נרשמת במערכת כשיחת callback.

כך זה נראה בדו"ח:

C = שיחת click to call​

המתקשר לחץ על לינק אשר יוצר שיחה שמחברת בין המתקשר למקבל השיחה. השיחה מתבצעת לאחד הצדדים קודם (לפי בחירת הלקוח) ומיד מחייגת לצד השני.

O = מחוץ לשעות הפעילות (out of time)​

שיחות שבוצעו מחוץ לשעות הפעילות.

עמודת הקלטה​

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

לאחר לחיצה על ההקלטה, תקפוץ החלונית הבאה:

ניתן להאזין להקלטה דרך המערכת וניתן ללחוץ על הורדת הקלטה ולהוריד אותה למחשב.

הורדת כל ההקלטות כקובץ ZIP​

בדו"ח פירוט שיחות מופיע מעל הטבלה כפתור יצוא הקלטה, המאפשר להוריד בפעולה אחת את הקלטות השיחות שבתוצאות כקובץ ZIP. הכפתור זמין למשתמשים בעלי הרשאות האזנה להקלטות וייצוא דו"חות.

תמלול שיחה אוטומטי​

בשיחות שעבורן קיים תמלול אוטומטי (Speech-to-Text), מוצג טקסט התמלול לצד נגן ההקלטה, ובזמן ניגון ההקלטה מודגשות המילים הנאמרות בהתאם להתקדמות ההשמעה. התמלול מופיע גם בחלונית המידע הנוסף של השיחה.

תמלול אוטומטי הוא תכונה תלוית-חבילה — זמין בחשבונות שבהם הופעל.

השפעות על המערכת​

דו"ח פירוט שיחות הוא צרכן ישיר של נתוני השיחות וחושף את הנתונים הגולמיים ביותר על כל שיחה:

• הרשאות משתמש — הדו"ח מוגבל לרשימת מספרי המסקיו המשויכים למשתמש; משתמש רגיל לא יראה שיחות של מספרים של משתמש אחר
• הקלטות שיחה — עמודת ההקלטה מקשרת לקובץ השמע; מחיקת GDPR או פקיעת 60 הימים תעלים אותו
• ערכי טוקנים מ‑IVR — פרמטרים לנתוני השיחה שהוגדרו ב‑IVR Studio (למשל מספר לקוח שהוקש) מופיעים כאן כעמודות נוספות
• הערות שיחה — כל הערה שנוספת נשמרת למסד הנתונים ומתעדכנת בצבע האייקון
• דירוגים ו‑callback — הערכים בעמודת דירוג שיחות מוזנים תוך כדי שיחה (חיוג ##ספרה), בעקבות תרחיש callback, או באופן ידני דרך שדה הדירוג בחלונית ההערות
• ייצוא — הדו"ח ניתן לייצוא לאקסל/PDF/CSV/XML לניתוח חיצוני או יבוא ל‑CRM
• לחיצה על זום — מאפשרת להצר את הדו"ח למסקיו בודד בלי לחזור על סינון ידני

ראו גם​

• דו"ח סקירה כללית
• דו"ח שיחות ננטשות
• דו"ח מדרוג שיחה
• IVR Studio
• דו"ח מתוזמן

דו"ח שיחות ננטשות​

docs/reports/lost-calls-report.md

דו"ח שיחות ננטשות​

דו"ח שיחות ננטשות מציג את רשימת המתקשרים אשר חייגו למספר מסקיו מסוים ולא נענו באף אחד מנסיונות החיוג שלהם (בטווח הזמנים הנבחר). אם מתקשר חייג פעם אחת או עשר פעמים, אבל בכל הפעמים לא נענה, הוא יופיע בדו"ח שיחות ננטשות. במידה ואפילו שיחה אחת של אותו מתקשר נענתה, הוא כבר לא יופיע בשיחות האבודות.

עמודות הדו"ח​

השפעות על המערכת​

דו"ח שיחות ננטשות מזהה לידים שפספסו — ולכן הוא משפיע על תהליכי מעקב ואוטומציה:

• לוגיקת סינון ייחודית — הדו"ח מציג רק מתקשרים שכל הניסיונות שלהם נכשלו (שיחת כשל/תפוסה/ללא מענה); מתקשר שנענה אפילו פעם אחת אינו מופיע
• טווח תאריכים — קובע את חלון הזמן לבדיקת "כל הניסיונות" של המתקשר; שינוי הטווח עלול להעלים לידים או לכלול חדשים
• זיהוי מספרים לעזוב — ריכוז חוזר של אותו מסקיו ברשימה מצביע על מספר שדורש אוטומציית "חסרה תשובה" או בדיקת ניתוב
• משוב ל‑IVR וכללים — משתמש באוטומציה "חסרה תשובה" לשלוח SMS/דוא"ל אוטומטיים ובכך להפחית את שורות הדו"ח
• ייצוא יומי — נפוץ להגדיר דו"ח מתוזמן של רשימת לידים אבודים להגעה במייל בתחילת יום עבודה

ראו גם​

• דו"ח פירוט שיחות
• דו"ח סקירה כללית
• אוטומציה — השבתת מסקיו
• אירועי אוטומציה
• דו"ח מתוזמן

דו"ח מספרי מסקיו שלא ענו​

docs/reports/maskyoo-not-answered-report.md

דו"ח מספרי מסקיו שלא ענו​

דו"ח מספרי מסקיו שלא ענו מציג מספרי מסקיו שלא ענו לאף שיחה שהתקבלה בתקופה הנבחרת.

מה מציג הדו"ח​

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

כברירת מחדל ממוין הדו"ח לפי מספר הימים שחלפו מאז המענה האחרון, בסדר יורד.

עמודות הדו"ח​

סינון הדו"ח​

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

למי מוצג הדו"ח​

הדו"ח מוצג בתפריט הדוחות למנהלי מערכת.

ראו גם​

• דו"ח יעדי שיחה שלא ענו
• דו"ח לפי שם עסק
• דו"ח פירוט שיחות
• דו"ח שיחות ננטשות

דו"ח יעדי שיחה שלא ענו​

docs/reports/destination-not-answered-report.md

דו"ח יעדי שיחה שלא ענו​

דו"ח יעדי שיחה שלא ענו מציג את מספרי היעד של מספרי המסקיו הפעילים במערכת שלא נענתה בהם אף שיחה בתקופה הנבחרת.

מה מציג הדו"ח​

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

כאשר לא נרשם מענה ביעד כלל, יוצג הערך "אף פעם".

עמודות הדו"ח​

סינון הדו"ח​

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

למי מוצג הדו"ח​

הדו"ח מוצג בתפריט הדוחות למנהלי מערכת.

ראו גם​

• דו"ח מספרי מסקיו שלא ענו
• דו"ח יעד שיחה לפי קידומת
• דו"ח פירוט שיחות

דו"ח התראות​

docs/reports/notifications-report.md

דו"ח התראות​

דו"ח התראות מציג את כל ההתראות שנשלחו מהמערכת (על ידי כללים והתראות שהוגדרו), דרך האימייל או באמצעות הודעת SMS.

פרטים המוצגים בדו"ח​

בדו"ח הפירוט מופיעים הפרטים הבאים:

• תיאור המסקיו שעבורו נשלחה ההודעה
• תאריך ושעת השליחה
• הנמען שאליו נשלחה ההודעה (מספר טלפון או כתובת דוא"ל)
• סטטוס ההודעה
• תוכן ההודעה
• סוג ההודעה (email או SMS)
• מעטפה בלחיצה עליה יופיעו פרטי השליחה

רוב עמודות התוכן — סטטוס ההודעה, תוכן ההודעה, סוג ההודעה ועמודת המעטפה — מוסתרות כברירת מחדל, וניתן להפעילן באמצעות כפתור רשימת השדות.

סינון הדו"ח​

ניתן לצמצם את הדו"ח לפי סטטוס המסירה של ההתראות באמצעות מסנן סטטוס השיחה שבראש עמוד הדוחות:

• הצגת התראות שנשלחו בהצלחה בלבד
• הצגת התראות שנכשלו / לא נמסרו בלבד

השפעות על המערכת​

דו"ח ההתראות הוא שכבת ניטור לפעילות האוטומציה ובודק שהתראות אכן יצאו בפועל:

• אוטומציה — התוכן מאוכלס על ידי אירועי אוטומציה ופעולותיהם; ללא פעולה שנשלחה — הדו"ח יהיה ריק
• ספקי שליחה — סטטוס ההתראה (נשלחה/נכשלה) משקף את תגובת הספק (SES לדוא"ל, ספק SMS); כישלונות כאן מצביעים על בעיית תצורה
• צריכת SMS — שליחת SMS נצברת לחיוב לפי כמויות; הדו"ח מראה את ההיקף בפועל
• תוכן מותאם אישית — עבור הודעות SMS שנשלחו בהצלחה מוצגת בדו"ח תצוגה מקדימה של תחילת הטקסט שנשלח בפועל; עבור הודעות דוא"ל תוכן ההודעה אינו מוצג בדו"ח
• ייצוא — ניתן לייצוא לביקורת תאימות או הצגת פעילות ללקוח
• דיבוג התראות — כלי מרכזי לבדיקה מדוע אימייל/SMS לא הגיעו

ראו גם​

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

דו״ח הודעות SMS נכנסות​

docs/reports/sms-incoming-report.md

דו״ח הודעות SMS נכנסות​

דו"ח הודעות SMS נכנסות מציג את הודעות ה-SMS שהתקבלו במספרי המסקיו בטווח התאריכים הנבחר.

מה מציג הדו"ח​

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

עמודות הדו"ח​

עמודת תוכן ההודעה מוסתרת כברירת מחדל, וניתן להוסיפה לתצוגה מרשימת העמודות של הדו"ח.

סינון הדו"ח​

ניתן לסנן את הדו"ח לפי:

• טווח תאריכים — התקופה שבה התקבלו ההודעות
• מספר מסקיו — הצגת הודעות של מסקיו מסוים בלבד
• טקסט חופשי — חיפוש לפי תיאור המסקיו או לפי המספר לשליחת SMS שלו

למי מוצג הדו"ח​

הדו"ח מוצג בתפריט הדוחות למשתמשים בעלי ההרשאה המתאימה.

ראו גם​

• דו"ח פירוט שיחות
• דו"ח סקירה כללית
• אוטומציה - הודעת SMS

דו"ח מדרוג שיחה​

docs/reports/call-ratings-report.md

דו"ח מדרוג שיחה​

דו"ח מדרוג שיחות מציג את כמות השיחות שהתקבלו לפי המדרוג שלהן, במידה וקיבלו כזה.

השפעות על המערכת​

דו"ח מדרוג שיחה צורך נתונים שנוצרים בזמן שיחה — ולכן הוא תלוי בשיתוף פעולה של נציגי המענה:

• הזנה ידנית בזמן שיחה — דירוגים נוצרים על ידי חיוג ##ספרה (0–9) במהלך שיחה חיה; ללא לחיצה — אין רשומה
• דירוגים בלבד — הדו"ח כולל אך ורק שיחות שקיבלו דירוג ידני; שיחות שירות מערכתיות (כגון שיחת חזרה של בעל המסקיו לשמיעת השיחות האחרונות) אינן נספרות בדו"ח זה
• שיחות מחוץ לשעות (O) — מופיעות בהקשר של חוקי שעות פעילות של המסקיו
• מקור הנתונים — דירוג השיחה נשמר יחד עם נתוני השיחה; לכן כל מחיקה של שיחות תעלים גם את הדירוג
• דרוג כמדד איכות — משמש לניתוח איכות לידים או ביצועי נציגים לאורך זמן
• ייצוא — נפוץ לצרף דירוגים כעמודה ביצוא ל‑CRM לשיפור סגמנטציה

ראו גם​

• דו"ח פירוט שיחות
• דו"ח סקירה כללית
• דו"ח לפי תגיות
• IVR Studio
• דו"ח מתוזמן

דו"ח שעתי​

docs/reports/hourly-report.md

דו"ח שעתי​

הדו"ח מציג כמות שיחות שהתקבלה בכל שעה ביום בטווח זמן מסוים. מדו"ח זה ניתן לראות את השעות החזקות והחלשות ביום ובהתאם לכך לרכז את מאמצי השיווק בזמנים הרלוונטיים (למשל, במידה ויש קמפיין ממומן בשעות מסוימות).

גרפים​

בראש הדו"ח מוצגים שני גרפים: גרף ניתוח ביצועים, המציג את ממוצע משך השיחה ואת ממוצע זמן ההמתנה למענה בכל שעה, וגרף שיחות / משך זמן, המציג את כמות השיחות ואת משך השיחות בכל שעה.

עמודות הדו"ח​

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

השפעות על המערכת​

דו"ח שעתי מחלק את נתוני השיחות לבקטים לפי שעה, ולכן רגיש מאוד להגדרות אזור הזמן ולוח השעות של הארגון:

• אזור הזמן של המערכת — הבקטים השעתיים מחושבים לפי אזור הזמן הקבוע של המערכת ולא לפי אזור הזמן האישי של המשתמש; שינוי אזור הזמן בהגדרות המשתמש אינו משנה את ההתפלגות השעתית שמוצגת בדו"ח זה (בשונה מהדו"ח היומי, שכן מתחשב באזור הזמן של המשתמש)
• שעות פעילות המסקיו — שיחות מחוץ לשעות הפעילות יופיעו בשעות הפריפריאליות ויכולות להטות את המסקנות
• נתוני ממוצע המתנה — מחושבים בזמן ריצה על פי זמן ההמתנה של השיחה; כל שינוי ב‑IVR (תורים/השהיות) ישפיע ישירות
• החלטות שיווק וקמפיינים — הדו"ח משמש תדיר לקביעת חלונות פעילות של קמפיינים ממומנים ונציגי מוקד
• ייצוא לאקסל — השעות מיוצאות כערכים ולא כתווית; מאפשר גזירה נוספת בכלי BI חיצוני

ראו גם​

• דו"ח יומי
• דו"ח חודשי
• דו"ח סקירה כללית
• דו"ח פירוט שיחות
• שעות פעילות מסקיו

דו"ח יומי​

docs/reports/daily-report.md

דו"ח יומי​

הדו"ח מציג את כמות השיחות שהתקבלה לפי ימים בחודש וימים בשבוע.

מרכיבי הדו"ח​

גרף טווח תאריכים​

מציג את כמות השיחות ומשך זמן שיחה שהתקבלו בכל יום, לפי תאריכים בטווח התאריכים שנבחר.

גרף ימות השבוע​

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

פירוט שיחות יומי​

פירוט השיחות מראה עבור כל יום את התאריך, היום בשבוע, כמות השיחות שהתקבלו, אחוזי המענה (אחוז השיחות שנענו מתוך כלל השיחות באותו יום), משך השיחות בדקות וממוצע משך השיחה.

השפעות על המערכת​

דו"ח יומי מסכם את נתוני השיחות לפי יום ומשפיע על תכנון כוח אדם ושיבוץ משמרות:

• אזור זמן המשתמש — הוא שקובע את תחום "היום"; מעבר בין אזורי זמן יכול לגרום לשיחות לחצות לימים אחרים
• שני אגרגטים — גרף לפי טווח תאריכים וגרף ימות השבוע; שני האגרגטים נשאבים מאותה קבוצת תוצאות
• ימות שבוע חזקים וחלשים — תשתית להחלטות שיבוץ; משפיע על בחירת שעות פעילות ב‑IVR וניתוב מספרים
• חגים וסופי שבוע — נראים בבירור בגרף; שימושי לזיהוי דפוסים עונתיים
• ייצוא וחיבור ל‑BI — טבלת הפירוט נכללת בדו"ח מתוזמן ליום העבודה הבא

ראו גם​

• דו"ח שעתי
• דו"ח חודשי
• דו"ח סקירה כללית
• דו"ח מגמות לפי עסק
• דו"ח מתוזמן

דו"ח חודשי​

docs/reports/monthly-report.md

דו"ח חודשי​

הדו"ח החודשי מציג את כמות השיחות שהתקבלו ומשכן בכל חודש בתקופה הנבחרת.

גרף עמודות​

הדו"ח מורכב מגרף עמודות המציג את כמות השיחות ומשך השיחות בכל חודש:

פירוט הדו"ח​

פירוט הדו"ח מציג עבור כל חודש בטווח התאריכים הנבחר את כמות השיחות, אחוזי המענה (אחוז השיחות שנענו מתוך כלל השיחות באותו חודש), משך השיחות בדקות וממוצע משך השיחה.

השפעות על המערכת​

דו"ח חודשי הוא כלי הצגה ניהולי ברמה הגבוהה ביותר — הוא משקף את כיוון הארגון לאורך זמן:

• טווח תאריכים רחב — הדו"ח מומלץ לטווחים של מספר חודשים עד שנה; טווחים קצרים לא יציגו מגמה ברורה
• גבולות החודש — שיוך שיחה לחודש מתבצע לפי זמן השיחה כפי שנרשם במערכת, ואינו מושפע מהגדרת אזור הזמן של המשתמש (בשונה מהדו"ח היומי)
• מקור לדו"חות מתוזמנים — נפוץ לשלוח דו"ח חודשי בדוא"ל ללקוחות/בעלי עניין בתחילת כל חודש קלנדרי
• הצגת עונתיות — מספק את הבסיס לזיהוי חודשים חזקים/חלשים בשנה ותכנון קמפיינים
• השוואה תקופה מול תקופה — לרוב משמש כשדה סיכום ללקוח בפגישות חודשיות

ראו גם​

• דו"ח יומי
• דו"ח שעתי
• דו"ח מגמות לפי עסק
• דו"ח סקירה כללית
• דו"ח מתוזמן

דו"ח לפי שם עסק​

docs/reports/maskyoo-report.md

דו"ח לפי שם עסק​

דו"ח לפי שם עסק מציג את כמות השיחות שקיבל כל מסקיו במערכת. מוצגים גם מספרי מסקיו שלא קיבלו אף שיחה.

גרפים​

הדו"ח מורכב מגרף עמודות וגרף עוגה אשר מציגים את התפלגות השיחות לפי מספרי המסקיו:

פירוט השיחות​

בפירוט השיחות של הדו"ח מוצגים מספרי המסקיו, כמות השיחות שקיבלו בסדר יורד, אחוזי המענה וכן משכי השיחות (כולל ממוצע משך שיחה).

ניתן ללחוץ על הזום ליד מספר מסקיו מסוים כדי לראות את פירוט השיחות לאותו מסקיו.

עמודות נוספות​

עמודות נוספות מוסתרות כברירת מחדל, וניתן להוסיפן לתצוגה מרשימת העמודות של הדו"ח, ובהן: תאריך הצטרפות, דואר אלקטרוני, מספר לשליחת SMS, שיוך תגיות והשדות הפרטיים של המסקיו.

השפעות על המערכת​

דו"ח לפי מסקיו הוא תשתית מרכזית לניתוח השוואתי — שורה לכל מספר עם סיכום כל השיחות:

• הרשאות משתמש — המספרים המוצגים הם רק אלה שהמשתמש מורשה לראות; משתמש משני לא רואה כל הארגון
• כולל מספרים ללא שיחות — נחוץ לזיהוי מסקיו מושהים שאולי דורשים שחרור או שינוי קמפיין
• בסיס ל‑SWOT וטרנדים — דו"חות SWOT, מגמות לפי עסק ופעילות מסקיו משתמשים באותו אגרגט כבסיס
• קפיצה לדו"ח פירוט — לחיצה על הזום מעבירה לדו"ח פירוט שיחות של מספר בודד
• מיון לפי כמות שיחות — עוזר לזיהוי עסקים "חמים" מול כאלה הדורשים תשומת לב
• ייצוא — נפוץ לייצא לאקסל להפקת דוחות חיצוניים לבעלי עסקים

ראו גם​

• דו"ח פעילות מסקיו
• דו"ח SWOT
• דו"ח מגמות לפי עסק
• דו"ח סקירה כללית
• ניהול מספרי מסקיו

דו"ח פעילות מסקיו​

docs/reports/maskyoo-activity-report.md

דו"ח פעילות מסקיו​

דו"ח פעילות מסקיו מציג את פעילות מספרי המסקיו בחודש התחשבנות — אילו מספרים היו פעילים, באילו ימים, ואילו מספרים נוספו למערכת או שוחררו ממנה במהלך החודש.

הדו"ח מוצג למנהלי מערכת בלבד.

חודש התחשבנות​

הדו"ח נעול לחודש התחשבנות בודד: מה-16 בחודש בשעה 00:00 ועד ה-15 בחודש העוקב בשעה 23:59. תחילת טווח התאריכים שנבחר קובעת את חודש ההתחשבנות המוצג; אם נבחר טווח רחב יותר, הדו"ח מתבסס על תחילת הטווח בלבד.

פרטים המוצגים בדו"ח​

בראש הדו"ח מוצגים שלושה סיכומים:

• סה"כ מספרים במערכת בטווח התאריכים
• מספרים שהוקצו בטווח התאריכים
• מספרים ששוחררו בטווח התאריכים

בטבלת הפירוט מוצגות העמודות הבאות:

סינון הדו"ח​

מסנני הדוחות הרגילים (תגיות, משתמשים, סטטוס שיחה, משך שיחה, טקסט חופשי) אינם חלים על דו"ח זה. ניתן לסנן רק לפי טווח תאריכים (הקובע את חודש ההתחשבנות) ולפי מספר מסקיו.

שימוש לדוגמה​

על ידי דו"ח זה ניתן לדוגמא לבדוק כמה מספרים היו פעילים בחודש ההתחשבנות האחרון (אפשרות בחירה מובנית הנמצאת בטווח התאריכים) וכך לדעת על כמה יהיה החיוב החודשי.

השפעות על המערכת​

דו"ח פעילות מסקיו הוא כלי התחשבנות ותפעול — הוא מציג את המספרים שהיו חיים בפועל בחודש ההתחשבנות:

• חישוב חיוב חודשי — עזר מרכזי לאישור מספר המספרים הפעילים בתקופת החיוב; משמש כבסיס לחיוב ללקוח
• אירועי הקצאה ושחרור — הדו"ח משקף מספרים שנוספו למערכת או שוחררו ממנה במהלך החודש, כולל ימי הפעילות בפועל
• נעילה לחודש בודד — לא ניתן להפיק את הדו"ח על פני מספר חודשים בבת אחת; יש להפיקו לכל חודש התחשבנות בנפרד
• פעילות אינה שימוש — מספר נחשב פעיל גם אם לא קיבל שיחות; עמודות משך השיחות וכמות השיחות מאפשרות להצליב מול השימוש בפועל
• ייצוא ללקוח — שימושי לייצוא ושליחה ללקוח כנלווה לחשבונית, וכן להפקה קבועה כדו"ח מתוזמן

ראו גם​

• דו"ח לפי מסקיו
• דו"ח סקירה כללית
• ניהול מספרי מסקיו
• סטטוסי מסקיו
• דו"ח מתוזמן

דו"ח עסקים Unique​

docs/reports/maskyoo-unique-calls-report.md

דו"ח עסקים Unique​

דו"ח עסקים Unique מציג את כמות השיחות הייחודיות שהתקבלו לכל מספר מסקיו בטווח תאריכים מסוים, כאשר כל יום מתבצעת ספירה מחודשת של המתקשרים.

השפעות על המערכת​

דו"ח מסקיו Unique מנכה שיחות חוזרות של אותו מחייג בתוך יום — חשוב למדידת יעילות קמפיין שיווקי:

• לוגיקת ייחודיות יומית — הספירה מתאפסת כל יום; אותו מחייג שחוזר יום למחרת ייספר שוב כפעם נוספת
• בסיס — מספר המתקשר — הזיהוי הוא לפי מספר המתקשר; שיחות אנונימיות מטופלות בנפרד
• מדד איכות לידים — מבחין בין לידים חדשים ללידים חוזרים; מפחית הטיה בדו"ח סקירה
• הרשאות משתמש — מוגבל לרשימת המסקיו של המשתמש; מנהל ראשי רואה ארגון שלם
• ייצוא ו‑CRM — נפוץ לייצוא עבור מחלקת שיווק לבחינת עלות ליד אמיתית

ראו גם​

• שיחות ייחודיות
• מסקיו שיחות ייחודיות תקופתי
• דו"ח לפי מקור שיחה
• דו"ח סקירה כללית
• דו"ח לפי מסקיו

דו"ח עסקים Unique תקופתי​

docs/reports/maskyoo-unique-calls-period-report.md

דו"ח עסקים Unique תקופתי​

דו"ח זה נועד לתת מבט תקופתי על המתקשרים לכל מסקיו לאורך טווח תאריכים נבחר, כמדד המשלים את דו"ח ה-Unique היומי.

השפעות על המערכת​

דו"ח מסקיו Unique תקופתי מציג מבט תקופתי לכל מסקיו על פני טווח התאריכים:

• מדד תקופתי — בנוי כמשלים לדו"ח ה-Unique היומי, במבט על פני מספר ימים יחד
• הרשאות משתמש — מוגבל למסקיו של המשתמש
• מגבלת דיוק — כפי שצוין למעלה, הערך המוצג אינו ספירה אמינה של מתקשרים ייחודיים ואינו מנכה מחייגים חוזרים; לחישובי ROI או עלות-פר-ליד מדויקים יש להתבסס על דוחות פירוט השיחות ולא על ערך זה

ראו גם​

• מסקיו שיחות ייחודיות
• שיחות ייחודיות
• דו"ח לפי מקור שיחה
• דו"ח לפי מסקיו
• דו"ח מגמות לפי עסק

דו"ח שיחות Unique​

docs/reports/unique-calls-report.md

דו"ח שיחות Unique​

דו"ח זה מראה את השיחות הייחודיות לכל מסקיו ומסקיו. כלומר, עבור מתקשר שמספרו מזוהה מוצגת שיחה אחת לכל צירוף של מתקשר ומספר מסקיו בכל יום.

כאשר אותו מתקשר (עם מספר מזוהה) חייג לאותו מספר מסקיו כמה פעמים באותו יום, מוצגת שורה מייצגת אחת לאותו צירוף (יום, מספר מסקיו ומתקשר); אין הבטחה שזו השיחה הראשונה או האחרונה של אותו יום.

השפעות על המערכת​

דו"ח שיחות Unique מציג שיחה אחת לכל צירוף מתקשר–מסקיו ביום — תצוגה שונה מסיכום אגרגטיבי:

• שורת פירוט לכל מחייג — הדו"ח פועל דומה ל‑call detail, אך ללא כפילויות של אותו מספר מחייג באותו יום
• שיחה אחת ביום לכל מתקשר מזוהה — שיחות נוספות של אותו מתקשר מזוהה לאותו מסקיו באותו יום אינן מוצגות (מתקשרים חסויים אינם מאוחדים)
• מאפשר יצירת קשר חוזר — רשימת מספרים ייחודית לשימוש במערכות חיוג חוזר או SMS המוני
• הרשאות משתמש — חלה על המספרים שהמשתמש מורשה לראות
• ייצוא ו‑CRM — מתאים לייצוא לטלמרקטינג או קמפיין SMS יזום לכל לידים הייחודיים

ראו גם​

• מסקיו שיחות ייחודיות
• מסקיו שיחות ייחודיות תקופתי
• דו"ח פירוט שיחות
• דו"ח לפי מקור שיחה
• דו"ח סקירה כללית

דו"ח לפי מקור שיחה​

docs/reports/caller-report.md

דו"ח לפי מקור שיחה​

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

השפעות על המערכת​

דו"ח לפי מקור שיחה מאגרג את כל השיחות לפי מספר המחייג — כלי מרכזי לזיהוי לקוחות חוזרים ולקוחות VIP:

• אגרגציה לפי מספר המתקשר — מספר המתקשר הוא המפתח לסיכום; מחייגים אנונימיים יסוכמו לקבוצה משותפת
• זיהוי טורדנים וספאם — מחייגים עם כמות שיחות חריגה מעידים על ספאם או אוטומציה זדונית; משמש בסיס לרשימה שחורה
• ניתוח VIP — לקוחות עם היסטוריית שיחות גבוהה יכולים להוביל להחלטות על ניתוב מועדף
• הרשאות משתמש — המחייגים המוצגים הם רק של מספרי מסקיו שהמשתמש רואה
• ייצוא לזרימות שיווק — נפוץ לייצוא לקמפיינים ייעודיים (re‑engagement) או שירות לקוחות
• לחיצה על מחייג — יכולה להוביל לדו"ח פירוט של כל שיחותיו

ראו גם​

• דו"ח מקור שיחה לפי קידומת
• דו"ח יעד שיחה לפי קידומת
• דו"ח פירוט שיחות
• שיחות ייחודיות
• רשימה שחורה

דו"ח יעד שיחה לפי קידומת​

docs/reports/callee-by-prefix-report.md

דו"ח יעד שיחה לפי קידומת​

דו"ח יעד שיחה לפי קידומת מציג את חלוקת השיחות לפי קידומת מספר היעד.

השפעות על המערכת​

דו"ח יעד שיחה לפי קידומת מקבץ את השיחות לפי קידומת מספר היעד שקיבל את השיחה בפועל — שימושי לארגונים עם נציגים מבוזרים:

• מקור — מספר היעד — מחושב בזמן ריצה מהקידומת של המספר המועבר; תלוי בניתוב של המסקיו
• פיזור גיאוגרפי של נציגים — מזהה אילו אזורים/סניפים מקבלים את רוב השיחות; עוזר באיזון עומס
• בחינת ניתוב IVR — חלוקה לא מאוזנת יכולה להצביע על צורך בתיקון כללי ניתוב
• הרשאות משתמש — רק שיחות שהמשתמש מורשה לראות נכללות באגרגציה
• ייצוא — נפוץ לדיון בפגישות ניהול על הקצאת משאבים אזוריים

ראו גם​

• דו"ח מקור שיחה לפי קידומת
• דו"ח לפי מקור שיחה
• דו"ח פירוט שיחות
• דו"ח לפי מסקיו
• ניהול מספרי מסקיו

דו"ח מקור שיחה לפי קידומת​

docs/reports/caller-by-prefix-report.md

דו"ח מקור שיחה לפי קידומת​

דו"ח מקור שיחה לפי קידומת מציג את כמות המתקשרים מכל קידומת אפשרית.

התפלגות לפי אזור חיוג​

הדו"ח מחולק לגרף עוגה המציג את כמות המתקשרים לפי קידומת.

פירוט הדו"ח​

דו"ח הפירוט מציג את הקידומות השונות שמהן התקשרו וכמות השיחות שבוצעה מכל קידומת.

השפעות על המערכת​

דו"ח מקור שיחה לפי קידומת מקבץ את השיחות לפי הקידומת של המחייג — כלי ניתוח גיאוגרפי של מקור הביקוש:

• חישוב בזמן ריצה — הקידומת נגזרת ממספר המתקשר; קידומות ישראליות סטנדרטיות (050, 052, 054 וכו') מזוהות אוטומטית
• קידומות נייח לעומת סלולר — יחס שביכולתו להצביע על קהל היעד (עסקים/פרטיים)
• פיזור גיאוגרפי של ביקוש — קידומות אזוריות (02, 03, 04, 08, 09) עוזרות לזהות איפה הקמפיינים עובדים הכי טוב
• גיבוי לשיווק אזורי — תשתית להחלטות על פרסום ממוקד אזור
• הרשאות משתמש — מוגבל לשיחות של מספרי המסקיו שהמשתמש רואה
• ייצוא — נפוץ להצגה חזותית בלוחות מחוונים (dashboards) ניהוליים

ראו גם​

• דו"ח יעד שיחה לפי קידומת
• דו"ח לפי מקור שיחה
• דו"ח פירוט שיחות
• דו"ח לפי מסקיו
• דו"ח SWOT

דו"ח לפי תגיות​

docs/reports/tags-report.md

דו"ח לפי תגיות​

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

מפת תגיות​

בדו"ח מוצגת מפת תגיות (Treemap) שבה כל תגית מיוצגת בשטח יחסי לכמות השיחות שהתקבלה עבורה. גודל המלבן של כל תגית משקף את מספר השיחות שלה בלבד.

תגיות מובילות​

בנוסף, מוצג גם גרף עוגה עם חלוקת השיחות לפי התגיות:

פירוט השיחות​

פירוט השיחות הוא לפי תגיות. מוצגות כל התגיות וכל תגית כמות השיחות שלה:

השפעות על המערכת​

דו"ח לפי תגיות תלוי במערכת התיוג של הארגון — איכות התגיות משפיעה ישירות על שימושיות הדו"ח:

• תגיות פעילות — תשתית — רק תגיות שהוגדרו במערכת התגיות ושויכו למספרי מסקיו יופיעו; תגיות לא מוקצות לא ייראו
• שיוך מסקיו לתגית — מספר מסקיו יכול להיות משויך למספר תגיות; שיחותיו נספרות בכל תגית רלוונטית
• אגרגציה כפולה — שיחה אחת יכולה להיספר בכמה תגיות; חשוב להיות מודעים כשמסכמים
• בסיס לדו"ח מגמות לפי תגית — דו"ח מגמות לפי תגית משתמש באותה לוגיקת אגרגציה על ציר זמן
• סגמנטציה עסקית — שימושי לארגונים שמנהלים כמה קטגוריות עסקיות במקביל (ענפים, מוצרים, קמפיינים)
• ייצוא — נפוץ לייצוא לבעלי מוצר/קטגוריה כדי שיראו את ביצועי הענף שלהם

ראו גם​

• ניהול תגיות
• דו"ח מגמות לפי תגית
• דו"ח לפי מסקיו
• דו"ח סקירה כללית
• דו"ח SWOT

דו"ח SWOT​

docs/reports/swot-report.md

דו"ח SWOT​

דו"ח SWOT מציג נתונים סטטיסטיים מפורטים על השיחות למספרי מסקיו.

ראשי התיבות של SWOT הם: Strengths, Weaknesses, Opportunities and Threats. כלומר, יתרונות, חסרונות, הזדמנויות ואיומים.

סקירת נתונים​

דו"ח זה מציג גרף על נתוני השיחות כגון:

• סה"כ שיחות
• אחוז השיחות שלא נענו
• אחוז שיחות שנענו
• ממוצע משך שיחה עבור שיחות איכותיות
• אחוז שיחות תפוסות
• ועוד

מרכיבי הדו"ח​

בנוסף, מציג דו"ח זה את המרכיבים הבאים:

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

חוזקות (S)​

מזהה גורמים פנימיים שעשויים לסייע בהשגת יעדי השיווק והפרסום. לדוגמא:

• המספרים עם כמות השיחות הגבוהה ביותר
• התגיות הפעילות ביותר
• היום החזק בשבוע
• ועוד

חולשות (W)​

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

• עסקים שלא עונים לשיחות כלל
• כמות עסקים שמשך השיחות שלהם קצר
• יום חלש בשבוע
• ועוד

הזדמנויות (O)​

ההזדמנויות הינן גורמים חיצוניים שרצוי לנצלם כדי להשיג את יעדי השיווק. למשל:

• אזורים גאוגרפיים חזקים
• זמנים בהם יש הרבה שיחות
• ימים חזקים וחלשים
• ועוד

איומים (T)​

איומים מתייחסים לגורמים חיצוניים אשר עלולים להוות סיכון להשגת יעדי השיווק. כגון:

• מספרי טלפון שמתקשרים הכי הרבה (ועלולים להיות ספאם)
• כמות שיחות ממספרים חסומים
• ועוד

השפעות על המערכת​

דו"ח SWOT הוא שכבת ניתוח עליונה — הוא נבנה על בסיס אגרגציות של דו"חות אחרים ומוסיף ניתוח אוטומטי:

• דרישת סף — 1,000 שיחות — ללא מסת נתונים מספקת, הניתוח לא משמעותי; הדו"ח מציג אזהרה
• חישובים מרובים — שיעור מענה, שיעור כשל, ממוצע משכים, שיחות איכותיות — הכל בזמן ריצה
• תלוי בקלט איכותי — תגיות, שעות פעילות ונתוני מסקיו מדויקים מעלים את איכות הניתוח
• מקבץ בעיות תפעוליות — מציג "עסקים שלא עונים", "כמות ממספרים חסומים" ועוד — ישיר לפעולה ניהולית
• מקור לכיוון עסקי — המנהל משתמש בו לתעדף פעולות שיווק, תפעול וחוזרי מחיר
• ייצוא ללקוח — נפוץ להציג כחלק ממצגת שיפור תהליכים או פגישות ניהוליות

ראו גם​

• דו"ח לפי מסקיו
• דו"ח לפי תגיות
• דו"ח מגמות לפי עסק
• דו"ח שיחות ננטשות
• דו"ח סקירה כללית

דו"ח מגמות לפי עסק​

docs/reports/trends-report-by-maskyoo.md

דו"ח מגמות לפי עסק​

דו"ח מגמות לפי עסק מציג קו מגמת כמות השיחות של כל מספר מסקיו במערכת.

מטרת הדו"ח​

ניתן לראות באמצעות דו"ח זה:

• האם יש מגמת עליה (כמות השיחות עולה בין חודש לחודש)
• האם ישנה מגמת ירידה

כמו כן, תוצג כמות השיחות בכל חודש וחודש בתקופה הנבחרת.

שימוש בדו"ח​

בדו"ח מגמות תוכלו לבדוק האם יש שינוי בכמות השיחות לכל מספר מסקיו בין חודש לחודש ותוכלו לאתר את מספרי המסקיו שבמגמת ירידה ולשנות את המגמה.

עמודות הדו"ח​

לכל מספר מסקיו מוצגים בטבלת הדו"ח תיאור המסקיו והמספר, כמות השיחות בכל חודש (כברירת מחדל מוצגים שלושת החודשים האחרונים בטווח, וניתן להוסיף חודשים נוספים מרשימת העמודות), סה"כ השיחות בתקופה וכן גרף מגמה — גרף מוקטן המוצג בשורת כל מסקיו וממחיש את כיוון המגמה לאורך התקופה.

בנוסף, ניתן להוסיף לתצוגה עמודות המוסתרות כברירת מחדל, ובהן עמודת סטטוס המציגה האם המספר פעיל או מושהה, וכן השדות הפרטיים של המסקיו.

השפעות על המערכת​

דו"ח מגמות לפי עסק מראה קווי מגמה של כל מספר לאורך זמן — כלי מרכזי לזיהוי עליות וירידות בפעילות:

• רזולוציה משתנה — טווח של חודש קלנדרי אחד ומעלה מוצג לפי חודשים; טווח קצר מחודש מוצג לפי ימים. בנוסף, בטווח שמניב פחות משלושה חודשים תוצג המלצה להאריך את הטווח לקבלת מגמה משמעותית. בחירת הטווח היא קריטית
• זיהוי עליות וירידות — מספרים במגמת ירידה מסמנים צורך בבדיקת קמפיין, ניתוב או בעיה טכנית
• תלוי באזור זמן המשתמש — גבולות הזמן של נקודות המגמה נקבעים לפי אזור הזמן שלו
• בסיס — דו"ח לפי מסקיו — אותה לוגיקת אגרגציה פרוסה על ציר זמן
• הרשאות משתמש — רק המספרים שהמשתמש רואה נכללים; מנהל רואה את כלל הארגון
• ייצוא — מתאים לייצוא לדו"ח חודשי ניהולי המציג בריאות עסקית של כלל המספרים

ראו גם​

• דו"ח מגמות לפי תגית
• דו"ח מגמות לפי משתמש
• דו"ח לפי מסקיו
• דו"ח סקירה כללית
• דו"ח SWOT

דו"ח מגמות לפי תגית​

docs/reports/trends-report-by-tag.md

דו"ח מגמות לפי תגית​

דו"ח מגמות לפי תגית מציג קו מגמת כמות השיחות של כל תגית במערכת.

מטרת הדו"ח​

ניתן לראות באמצעות דו"ח זה:

• האם יש מגמת עליה (כמות השיחות עולה בין חודש לחודש)
• האם ישנה מגמת ירידה

כמו כן, תוצג כמות השיחות בכל חודש וחודש בתקופה הנבחרת.

שימוש בדו"ח​

בדו"ח מגמות תוכלו לבדוק האם יש שינוי בכמות השיחות לכל תגית בין חודש לחודש ותוכלו לאתר את התגיות שבמגמת ירידה ולשנות את המגמה.

השפעות על המערכת​

דו"ח מגמות לפי תגית משקף את בריאות סגמנטים עסקיים בארגון — תלוי מאוד בתגיות תקניות ומעודכנות:

• תגיות פעילות ומשוייכות — תגית ללא מספרים משוייכים לא תציג קו; ניהול תגיות תקין הוא תנאי
• רזולוציה משתנה — טווח של חודש ומעלה מוצג לפי חודשים; טווח קצר מחודש מוצג לפי ימים
• תשקיף ענפים — מאפשר לראות איזה ענף עסקי (בתגית) במגמת עלייה ואיזה בנסיגה
• בסיס — דו"ח לפי תגיות — אותה אגרגציה, פרוסה על ציר זמן
• שיחה עם תגיות מרובות — תיספר בכל תגית בנפרד, מה שיגרום לנקודות מגמה נפרדות
• ייצוא ולקוחות — שימושי בפגישות ענף/מותג להבנת כיוון הקמפיין

ראו גם​

• דו"ח לפי תגיות
• ניהול תגיות
• דו"ח מגמות לפי עסק
• דו"ח מגמות לפי משתמש
• דו"ח סקירה כללית

דו"ח מגמות לפי משתמש​

docs/reports/user-trends-report.md

דו"ח מגמות לפי משתמש​

דו"ח מגמות לפי משתמש מציג את המשתמשים במערכת ואת קו המגמה של אותו משתמש.

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

מה מציג הדו"ח​

באמצעות דו"ח זה ניתן לראות:

• האם יש מגמת עלייה (כמות השיחות עולה בין חודש לחודש)
• האם ישנה מגמת ירידה

בדו"ח לפי משתמש תוכלו לבדוק האם יש שינוי בכמות השיחות למספרים המשויכים למשתמשים בין חודש לחודש, ותוכלו לאתר את המשתמשים שבמגמת ירידה ולשנות את המגמה.

השפעות על המערכת​

דו"ח מגמות לפי משתמש מראה את ביצועי כל משתמש לאורך זמן — כלי ניהולי לניתוח פרודוקטיביות:

• שייוך מספרים למשתמש — הדו"ח מסתמך על שיוך מספרי המסקיו למשתמש; מספר ללא בעלים לא ייכלל
• רזולוציה משתנה — טווח קטן מחודש מציג ימים; גדול יותר מציג חודשים
• זיהוי משתמשים בירידה — משתמש במגמת ירידה עלול להצביע על בעיית שירות או ניהול לידים
• תלוי באזור זמן המשתמש המצפה (לא של מי שנמדד) — גבולות הזמן נקבעים לפי אזור הזמן של מי שמציג את הדו"ח
• כלי מנהלים — הדו"ח זמין למנהלי המערכת של החשבון בלבד ומציג את ביצועי המשתמשים שיש להם מספרים משויכים ושיחות בטווח שנבחר
• ייצוא לבחינה תקופתית — נפוץ לבדיקות ביצועים חודשיות ולתגמול על בסיס פעילות

ראו גם​

• ניהול משתמשים
• דו"ח מגמות לפי עסק
• דו"ח מגמות לפי תגית
• דו"ח סקירה כללית
• דו"ח לפי מסקיו

דו"ח קמפיינים אינטרנטיים​

docs/reports/google/google-campaigns-report.md

דו"ח קמפיינים אינטרנטיים​

דו"ח קמפיינים אינטרנטיים מציג את כמות השיחות שהתקבלו מכל קמפיין גוגל.

גרפים בדו"ח​

בראש הדו"ח מוצגים שני גרפים תחת הכותרת דירוג קמפיינים: גרף עמודות המציג לכל קמפיין את סה"כ שיחות לצד קו של סה"כ שיחות שצלחו, וגרף טבעת המציג את התפלגות סה"כ השיחות בין הקמפיינים.

עמודות הדו"ח​

השפעות על המערכת​

דו"ח קמפיינים אינטרנטיים תלוי במלואו בתוסף Google Analyze ובחיבור ל‑Google Ads:

• תוסף פעיל — תנאי חובה — כאשר תוסף כלי הניתוח של גוגל פעיל ומוגדר; אחרת הדו"ח לא מופיע בתפריט
• יבוא המרות Google Ads — הדו"ח מסתמך על יבוא ההמרה של "שיחה" לקמפיין; ללא יבוא — לא יופיעו כל השיחות
• קוד מסקיו ב‑Google Ads — חייב להיות מוטמע לצד לתפוס את GCLID של השיחה
• GCLID — מזהה הקליק מגוגל מחבר בין שיחה לקמפיין שהוביל אליה
• מדד ROI ברמת קמפיין — מאפשר להבין איזה קמפיין מייצר שיחות בפועל (לא רק קליקים)
• ייצוא לשיווק — נפוץ לייצוא למחלקת מדיה לחישוב עלות פר שיחה (CPL) לכל קמפיין

ראו גם​

• תוסף Google Analyze
• דו"ח פירוט שיחות מקמפיינים
• דו"ח מילות מפתח
• דו"ח פירוט שיחות מחיפושים
• דו"ח סקירה כללית

דו"ח פירוט שיחות מקמפיינים​

docs/reports/google/google-campaign-calls-report.md

דו"ח פירוט שיחות מקמפיינים​

דו"ח פירוט שיחות מקמפיינים מציג את כל השיחות שיש להם מזהה שיחה של Google Ads (GCLID) ואת כל פרטי השיחה ממערכת מסקיו, עם המידע שניתן לייבא מחשבון Google Ads שאליו מחובר הקמפיין.

להנחיות לחיבור מסקיו לכלי הניתוח והפרסום של גוגל, ראו חיבור לממשקי גוגל.

עמודות הדו"ח​

הדו"ח מציג את כל העמודות של דו"ח פירוט השיחות (זמן תחילת שיחה, מקור השיחה, מספר המסקיו, משך שיחה, סטטוס המענה לשיחה, מידע נוסף וכו'), ובנוסף עמודות עם המידע שיובא מ-Google Ads:

השפעות על המערכת​

דו"ח פירוט שיחות מקמפיין מחבר את נתוני השיחות של מסקיו עם נתוני קמפיין מ‑Google Ads — דורש שרשרת אינטגרציה שלמה:

• תוסף Google Analyze פעיל — ללא התוסף הדו"ח אינו זמין
• GCLID בכל שיחה — שיחות חייבות להכיל GCLID (Google Click ID) שנקלט דרך קוד מסקיו; ללא GCLID השיחה לא תופיע
• נתונים מיובאים מ‑Google Ads — פרטי הקמפיין, מילת המפתח וקבוצת המודעה אינם נשאבים בזמן אמת בעת פתיחת הדו"ח, אלא מיובאים ומסונכרנים באופן תקופתי מחשבון Google Ads דרך קוד מסקיו המוטמע בחשבון; ייתכן עיכוב עד שנתוני הקמפיין העדכניים יופיעו בדו"ח
• חיבור לדו"ח פירוט שיחות — מציג את כל שדות השיחה הרגילים, כולל הקלטה, סטטוס ומשך — בנוסף לנתוני הקמפיין
• ייצוא לניתוח ROI — שימושי למסך דף ‑שיווק לחישוב עלות קמפיין מול איכות הלידים שהגיעו בפועל
• מחיקת GDPR — מחיקה של שיחה תסיר אותה גם מהדו"ח הזה יחד עם כל נתוני הקמפיין

ראו גם​

• תוסף Google Analyze
• דו"ח קמפיינים אינטרנטיים
• דו"ח מילות מפתח
• דו"ח פירוט שיחות מחיפושים
• דו"ח פירוט שיחות

דו"ח מילות מפתח​

docs/reports/google/google-keyword-report.md

דו"ח מילות מפתח​

דו"ח מילות מפתח מציג את כמות השיחות שהתקבלו מכל מילת מפתח.

גרפים בדו"ח​

בראש הדו"ח, מעל טבלת הנתונים, מוצגים שני גרפים:

• דירוג מילות מפתח — גרף עמודות וקו המציג לכל מילת מפתח את סך השיחות (עמודות) ואת השיחות שנענו (קו).
• התפלגות שיחות לפי מילות מפתח — גרף עוגה המראה את חלוקת השיחות בין מילות המפתח, עם ציון סך כל השיחות במרכז הגרף.

עמודות הדו"ח​

השפעות על המערכת​

דו"ח מילות מפתח מראה אילו חיפושים ב‑Google הובילו לשיחות — הרזולוציה הגבוהה ביותר בניתוח קמפיינים:

• תוסף Google Analyze פעיל — תנאי חובה להצגת הדו"ח
• מקור — Google Ads API — מילת המפתח נאספת מ‑Google Ads לפי ה‑GCLID של השיחה
• נראות מילות מפתח — גוגל לא תמיד חושף את כל המילים (ביטויי חיפוש חסויים); חלק מהשיחות יופיעו ללא מילה ברורה
• אופטימיזציית קמפיין — עוזר לקטוע מילים עם שיחות לא איכותיות ולהגדיל תקציב למילים ממירות
• קישור לכוונת משתמש — מילה היא האות הטובה ביותר לכוונת המחייג בזמן החיפוש
• ייצוא — משמש למחלקת SEM לבניית רשימות מילות מפתח שליליות (negative keywords)

ראו גם​

• תוסף Google Analyze
• דו"ח קמפיינים אינטרנטיים
• דו"ח פירוט שיחות מקמפיינים
• דו"ח פירוט שיחות מחיפושים
• דו"ח פירוט שיחות

דו"ח פירוט שיחות מחיפושים​

docs/reports/google/search-call-detail-report.md

דו"ח פירוט שיחות מחיפושים​

דו"ח פירוט שיחות מחיפושים מציג את השיחות שבוצעו לתוספי השיחה של גוגל (Call extensions).

עמודות הדו"ח​

הדו"ח מציג את העמודות של דו"ח פירוט השיחות (זמן תחילת שיחה, מקור השיחה, מספר המסקיו, משך שיחה, סטטוס המענה לשיחה וכו'), ובנוסף עמודות מנתוני Google Ads:

בשונה מדו"ח פירוט שיחות מקמפיינים, דו"ח זה אינו כולל עמודות של מזהה קליק (GCLID) או מילת חיפוש.

השפעות על המערכת​

דו"ח פירוט שיחות מחיפושים מציג שיחות שהגיעו דרך Call Extensions של Google — ערוץ שיחה נפרד מקמפיין רגיל:

• תוסף Google Analyze פעיל — תנאי חובה להצגת הדו"ח
• מקור השיחה — Call extensions — מתקשרים שלחצו ישירות על כפתור התקשרות בתוצאות החיפוש; בדו"ח זה אין עמודות של מזהה קליק (GCLID) או מילת חיפוש
• מסלול שונה מ‑Campaigns — Call extensions מופיעים בדו"ח זה, ולא בהכרח בדו"ח קמפיינים אינטרנטיים
• נתוני מודעה — לצד פרטי השיחה מוצגים הקמפיין, קבוצת המודעות, מיקום המודעה וסוג השיחה כפי שהתקבלו מ‑Google Ads
• פירוט שיחות מלא — הדו"ח כולל משך, סטטוס, הקלטה (אם מוגדרת) וכל שדות השיחה הרגילים
• ייצוא לניתוח מובייל — ערוץ זה דומיננטי בחיפוש ממובייל; הדו"ח חושף ביצועי קמפיינים מול קהל חיפוש נייד

ראו גם​

• תוסף Google Analyze
• דו"ח פירוט שיחות מקמפיינים
• דו"ח מילות מפתח
• דו"ח קמפיינים אינטרנטיים
• דו"ח פירוט שיחות

ניהול מספרים​

docs/numbers/index.mdx

ניהול מספרים​

מקטע זה מרכז את כל הנושאים הקשורים לניהול מספרי מסקיו — מהוספת מספר חדש, דרך עריכת ההגדרות של כל מספר, ועד שחרור מספר חזרה למאגר.

• ➕ הוספת מספר חדש — יצירת מספר מסקיו חדש מתוך מאגר המספרים
  → ./add/create-new-maskyoo
• 📞 ניהול מספרי מסקיו — צפייה, חיפוש וסינון של מספרים קיימים
  → ./manage/manage-maskyoo
• ⚙️ עריכת מספר מסקיו — פרטי המספר, יעדים, טלפוניה, הקלטה, קבצי שמע, התראות, שעות עבודה וכו׳
  → ./manage/edit-maskyoo-number
• 🔓 שחרור מספר מסקיו — הסרת מספר מהמערכת בחזרה למאגר
  → ./manage/release-maskyoo-number

השפעות על המערכת​

מספרי המסקיו הם הצומת המרכזי של כל השיחות במערכת — כל שיחה מקושרת למספר המסקיו שדרכו עברה, ולכן לניהול המספרים יש השפעה רוחבית:

• לוח בקרה — רק מספרים שהמשתמש הנוכחי מורשה להם מופיעים במוניטור השיחות החי; הוספה/שחרור של מספר משנה מיידית את היקף הנתונים הנצפים
• דוחות — כל דוחות השיחות (פירוט, סיכומי מסקיו, סקירה כללית) מסננים לפי רשימת המספרים בחשבון; מספר משוחרר עדיין מופיע היסטורית עם סטטוס מתאים
• אוטומציה — "מספר מסקיו" הוא אחד ממסנני הליבה באירועי אוטומציה; תגיות ומשתמשים המשויכים למספר מחילים בעקיפין גם הם סינון על האירועים
• IVR ונתבי שיחות — מספר המוגדר עם אלגוריתם חיוג מסוג "נתב שיחות מתקדם (גרסת בטה)" נקשר לנתב שנבנה ב‑IVR Studio; שינוי במספר עלול לנתק את חיבור הנתב
• משתמשים ותגיות — שיוכי המספר למשתמשים ולתגיות משפיעים על ההרשאות והנראות בכל מסכי המערכת
• עריכה / שחרור / מחיקה מרובים — פעולות אלה מבוצעות ממסך אחד שמרכז עדכון מרובה של מספרים, כולל שחרור ומחיקה של המספרים שנבחרו

ראו גם​

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

הוספת מספר מסקיו חדש​

docs/numbers/add/create-new-maskyoo.md

הוספת מספר מסקיו חדש​

שלבי הוספת מספר​

מסך הוספת המספר הוא מסך יחיד הכולל פס מידע עליון, כרטיס חיפוש אחד, ואזור תוצאות שנטען דינמית. בראש המסך מופיע הסבר קצר: "חפשו מספרי טלפון זמינים לפי קידומת, סיומת או תבנית. לאחר שתמצאו מספר שמתאים, לחצו עליו כדי להקצותו לחשבונכם — ולאחר ההקצאה תועברו להגדרות המספר."

1. בכדי להוסיף מספר מסקיו חדש יש ללחוץ על ניהול מספרים בתפריט הראשי ולבחור בלשונית הוספת מספרים. ניתן גם ללחוץ על כפתור במסך ניהול מספרים.

   

2. באזור התוצאות יש לבחור מספר מסקיו רצוי מתוך בנק המספרים של מסקיו וללחוץ על כפתור הקצאה. כל מספר מוצג בשורה נפרדת — בצד אחד המספר עצמו ולצדו אייקון העתקה ללוח, ובצד השני כפתור הקצאה שלחיצה עליו מתחילה את הקצאת המספר לחשבונכם.

חיפוש מספר חדש​

ניתן ללחוץ על כדי לרענן את תוצאות המספרים הפנויים. במידה ויש מספר או רצף ספרות ספציפי רצוי, ניתן להזין אותו בשדה החיפוש ולבחור את אופן ההתאמה מתוך שלוש אפשרויות — מתחיל ב / מסתיים ב / דומה — וללחוץ על .

במידה ויהיו תוצאות מתאימות, הן יופיעו. לצד כל מספר בתוצאות מופיע אייקון העתקה — לחיצה עליו מעתיקה את המספר ללוח (תוצג הודעת "הועתק").

סוגי מספרים בבנק המספרים​

מספרים בצינון​

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

מספרים פנויים​

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

אישור הוספת המספר​

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

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

יש ללחוץ על המשך כדי להשלים את ההקצאה, או על חזור כדי לבטל ולחזור לאזור החיפוש.

עריכת המספר החדש​

4. ייפתח מסך לעריכת מספר המסקיו. ניתן לערוך את המסקיו באותה הזדמנות או ללחוץ על כדי להשאיר את המסקיו ללא הגדרות לעת עתה.

למידע מלא על כל ההגדרות הזמינות בעריכת מספר מסקיו (פרטי המספר, יעדי שיחה, תגיות ומשתמשים, טלפוניה מתקדמת, קבצי שמע, התראות, הקלטה, שדות פרטיים ושעות עבודה) — ראו עריכת מספר מסקיו.

בדיקה ואימות​

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

6. ניתן לעבור לאחר השיחה לדוח פירוט שיחות ולראות את פרטי השיחה.

השפעות על המערכת​

הוספת מספר מסקיו חדש יוצרת מספר פעיל בחשבון ומשפיעה מיידית על מגוון רכיבים:

• לוח בקרה — המספר מופיע ברשימת המספרים המנוטרים והשיחות אליו נצפות בזמן אמת במוניטור
• בנק המספרים — המערכת מוציאה את המספר הנבחר מהמאגר הכללי (או מבנק הצינון של החשבון) וסוגרת אותו לשימוש בלעדי
• דוחות — המספר הופך מיד לזמין כפילטר בכל הדוחות, אך יכיל נתונים רק משיחות שבוצעו לאחר ההקצאה
• אוטומציה — ניתן לכלול את המספר במסנני אירועים קיימים; ללא שיוך מפורש הוא "ייפול" לאירועים שאינם מסננים מספר מסוים
• שיוך משתמשים ותגיות — עד שלא משייכים בעל תפקיד/תגית, רק מנהלי המערכת רואים את המספר
• חיוב — הוספת מספר עשויה לגרור חיוב נוסף בהתאם לחבילה שנרכשה

ראו גם​

• ניהול מספרי מסקיו
• עריכת מספר מסקיו
• שחרור מספר מסקיו
• דו״ח פירוט שיחות
• יצירת משתמש חדש
• ניהול תגיות

ניהול מספרי מסקיו​

docs/numbers/manage/manage-maskyoo.md

ניהול מספרי מסקיו​

כדי לצפות ולערוך הגדרות במספר מסקיו קיים יש ללחוץ בתפריט הראשי על ניהול מספרים ← ניהול מספרים.

יופיע המסך הבא:

חיפוש וצפייה במספרי מסקיו​

במסך זה ניתן לצפות במספרי המסקיו הקיימים במערכת וכן לשנות ולהוסיף הגדרות.

אפשרויות חיפוש​

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

הסבר על סוגי הסטטוסים​

בריבועים הצבעוניים מעל פירוט המספרים ישנו סיכום של כמות המספרים הקיימת בכל סטטוס:

סטטוס	תיאור
	כמות מספרי המסקיו הקיימים בחשבון (פעילים ומושהים)
	מספרי מסקיו שהוגדרו כפעילים, כלומר מספרים שמעבירים שיחות וניתן להגיע דרכם ליעד
	מספרי מסקיו שמשוייכים למערכת אך הוגדרו כמושהים. בעת החיוג אליהם, המחייג לא יגיע ליעד אלא ישמע הודעה כי המספר מושהה. ניתן לשנות את המספר לפעיל בכל עת
	רשומות שבעבר היו משויכות למסקיו אך אותו מספר שוחרר מהמערכת. נשארה הרשומה של הלקוח אך אין כאן מדידת שיחות. רשומות נשמרות לצורך מעקב אחר לקוחות עבר, שיחות שהיו לאותם לקוחות ועוד. במידה ואין צורך במידע זה, ניתן למחוק את הרשומה

צפייה במספרים​

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

עמודת יעד השיחה מציגה חיווי ויזואלי כאשר חסר או שגוי מספר יעד: במספר פעיל שאין לו מספר יעד מוגדר מופיע סימן אזהרה ("חסר מספר יעד"), ואם הוזן מספר יעד שאינו תקין הוא מסומן באדום. אימות תקינות מספר היעד מתבצע ישירות במסך הרשימה.

ייצוא​

ניתן לייצא את רשימת המספרים לפורמטים שונים, על ידי לחיצה על ייצוא ובחירת הפורמט שנרצה לייצא אליו. בתפריט זמינות האפשרויות: הדפסה, PDF, שליחה בדוא"ל, Excel, CSV ו-XML.

הוספת שדות לרשימת המספרים​

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

כדי להוסיף שדות נוספים יש ללחוץ על בצד שמאל של המסך ולסמן ב-V את השדות הרצויים.

עריכת מספר מסקיו​

כדי לערוך מספר מסקיו, יש ללחוץ על או על תיאור המסקיו הרצוי. ייפתח מסך עריכת מספר המסקיו שהוא מסך אחד רציף המרוכז את כל אזורי ההגדרה של המספר.

לפירוט מלא של כל אזורי ההגדרה ראו עריכת מספר מסקיו.

מחיקת רשומה משוחררת​

ברשומות בסטטוס "משוחרר" (רשומות שהמספר שלהן שוחרר מהמערכת) מוצג בעמודת הפעולות, לצד כפתור העריכה, גם כפתור מחק עם אייקון פח אשפה. אפשרות זו זמינה למנהלי מערכת בלבד.

1. יש ללחוץ על מחק בשורת הרשומה הרצויה
2. תופיע חלונית אישור המבהירה כי המספר יימחק לצמיתות מהרשימה, אך ימשיך להופיע בדוחות עבר
3. לאחר האישור הרשומה מוסרת מרשימת המספרים

עריכה מרובה​

ניתן לבחור מספר מספרי מסקיו בסימון תיבת הבחירה שלצד השורה, וללחוץ על עריכה מרובה כדי לעדכן מספר הגדרות בבת אחת על כל המספרים הנבחרים — כגון שינוי יעד, תגיות, הקלטה, התראות וכו'.

מסך העריכה המרובה אינו מעדכן את כל ההגדרות בלחיצת "שמור" אחת. המסך מחולק לאזורים (יעדי שיחה, תגיות, משתמשים, טלפוניה, קבצי שמע, התראות וכו'), ולכל אזור יש כפתור שמור נפרד — מעדכנים אזור-אזור.

בשדות שיכולים להכיל כמה ערכים — יעדי שיחה, תגיות, משתמשים, כתובות דוא"ל להתראות וטלפון SMS — מוצעים שני מצבי שמירה נפרדים:

שחרור ומחיקה מרובים​

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

השפעות על המערכת​

מסך ניהול המספרים הוא נקודת הכניסה התפעולית הראשית למספרים ומכאן נגזרות פעולות שמשפיעות על כל המערכת:

• סטטוס פעיל/מושהה — כאשר מספר מוגדר כ"מושהה", המחייג שומע הודעה קבועה ולא מגיע ליעד; הסטטוס נבדק בזמן אמת בעת ניתוב השיחה
• חיפוש לפי משתמש/תגית — חיפושים אלה משקפים את שיוכי המספרים למשתמשים ולתגיות, ואת אותן ההרשאות שמגבילות מה משתמשים אחרים רואים
• ייצוא — תפריט הייצוא מציע מספר פורמטים ופעולות (הדפסה, PDF, שליחה בדוא"ל, Excel, CSV ו-XML), וכולם מכבדים את אותם הסינונים הפעילים על המסך
• עריכה / שחרור / מחיקה מרובים — משנים, משחררים או מוחקים בבת אחת מספר מספרים; הפעולות מתועדות בלוג השינויים של המערכת
• רשומות "סיום ללא מסקיו" — מייצגות מספרים שכבר שוחררו ומשמשות לצורך מעקב היסטורי בנתוני השיחות; מחיקתן מוחקת קישור היסטורי לשיחות ישנות

ראו גם​

• הוספת מספר מסקיו חדש
• עריכת מספר מסקיו
• שחרור מספר מסקיו
• ניהול תגיות
• ניהול משתמשים
• לוג שינויים

עריכת מספר מסקיו​

docs/numbers/manage/edit-maskyoo-number.md

עריכת מספר מסקיו​

מסך עריכת מספר המסקיו הוא מסך אחד רציף המכיל את כל ההגדרות של מספר מסקיו — פרטי המספר, יעדי השיחה והגדרות הטלפוניה, קבצי השמע, ההקלטה, שעות העבודה, ההתראות, השייכות והשדות הפרטיים. הסעיפים למטה מופיעים בסדר זהה לסדר שבו הם מופיעים במסך העריכה במערכת.

חלק מסעיפי המסך מוצגים בהתאם להרשאות המשתמש — משתמש ללא הרשאה מתאימה לא יראה את הסעיף כלל.

כניסה למסך העריכה​

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

בראש המסך מופיעים כפתור שמור, כפתור חזרה לרשימת המספרים, ותפריט פעולות נוספות המרכז פעולות על המספר — שכפול המספר, שחרור המספר והדפסה.

1. טלפון​

פרטי הבסיס של מספר המסקיו.

תיאור מספר מסקיו​

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

סטטוס מספר​

כל מספר מוגדר כפעיל כברירת מחדל. כדי להשהות את המספר יש ללחוץ על מושהה — מרגע זה שיחות נכנסות לא ינותבו ליעד, אך המספר נשאר משויך לחשבון. להפעלת המספר מחדש יש ללחוץ על פעיל.

מספר מסקיו​

המספר הוירטואלי שהוקצה מהמאגר. השדה אינו ניתן לעריכה לאחר שהוקצה, ולצדו אייקון להעתקת המספר ללוח. לצד השדה מופיע כפתור שחרור המספר (שחרור מספר מסקיו); ברשומה בסטטוס "משוחרר" מופיע במקומו כפתור בחר מספר (בחירת מספר חדש לרשומה משוחררת).

2. יעדי שיחה​

אלגוריתם לחיוג​

קובע את אופן החיוג ליעדים השונים. ארבע אפשרויות:

• חיוג במקביל לקבוצת מספרים — השיחה תצלצל אצל כל היעדים שהוגדרו, עד שאחד היעדים יענה לשיחה, ואז ייפסק החיוג.
• מוביל נגרר — השיחה תצלצל אצל היעד הראשון, במידה ולא יענה, השיחה תעבור ליעד השני וכן הלאה עד היעד האחרון שהוגדר.
• נתב שיחות (IVR) — כל מספר יעד יהווה שלוחה אפשרית, כאשר ההקשה היא בהתאמה לאינדקס של מספר היעד (מספר יעד 1 = שלוחה 1 וכן הלאה). כשמחייגים למסקיו מושמעת הודעה קצרה (שיש להקליט מבעוד מועד ולשים בקובץ השמעה למחייג) שבה יושמע התפריט של השלוחות. לאחר שהמחייג לוחץ על מספר השלוחה, הוא יועבר ליעד המקושר לאותה שלוחה.
• נתב שיחות מתקדם (גרסת בטה) — שיוך נתב שיחות מלא שנבנה ב-IVR Studio. מאפשר תרחישי ניתוב מורכבים הרבה יותר: תפריטים רב-רמתיים, לוגיקה מותנית, webhooks, הקלטה, תמלול ועוד.

בחירת מבנה הנתב הקולי​

כאשר נבחר האלגוריתם נתב שיחות מתקדם (גרסת בטה), מופיע שדה בחירה נוסף — בחרו את מבנה הנתב הקולי (IVR) — שבו בוחרים את הנתב הרצוי מתוך הנתבים שנבנו ב-IVR Studio.

הזנת יעדי שיחה​

יעדי השיחה הם מספרי הטלפון אליהם מנותבות השיחות ממספר המסקיו. במידה ויש יותר מיעד אחד, יש ללחוץ על כפתור ההוספה ולהוסיף עוד מספר. ניתן להזין עד עשרה יעדי שיחה שונים.

ניתן לגרור ולסדר מחדש את היעדים לפי סדר החיוג המועדף — שימושי במיוחד במצב "מוביל נגרר".

3. הגדרות טלפוניה מתקדמות​

תת-אזור מתקפל בתוך אזור יעדי השיחה. כברירת מחדל הוא מוצג מכווץ ונפתח בלחיצה על הכותרת הגדרות טלפוניה מתקדמות; אם אחת מההגדרות שבו שונתה מברירת המחדל, הוא ייפתח אוטומטית.

שלח DTMF למקבל השיחה​

ניתן להגדיר הקשות DTMF אשר ינתבו באופן אוטומטי את המחייג לשלוחה הרצויה, כאשר מדובר ביעד שהוא נתב שיחות או מרכזייה. ההקשות נשלחות למקבל השיחה מיד לאחר שהוא עונה.

תחביר השדה: ספרות 0–9, התווים * ו-#, והאות w להשהיה של חצי שנייה בין ההקשות (לדוגמה: ww = השהיה של שנייה אחת).

זמן חיוג / המתנה למענה​

זמן המתנה למענה הוא הזמן המוקצה להמתנה למענה עד שהשיחה תסתיים באופן יזום (תישמע הודעה אוטומטית על אין מענה). הערך נקבע באמצעות מחוון בטווח של 1–60 שניות (ברירת המחדל: 30 שניות). הטווח המומלץ הוא 8–30 שניות — בבחירת ערך מחוץ לטווח זה תוצג אזהרה, מכיוון שערך חריג עלול לפגוע בטיפול התקין בשיחות.

חשיפת מספר​

ניתן לבחור איזה מספר יראה מקבל השיחה (העסק) על הצג כאשר יקבל שיחה דרך מספר המסקיו. ישנן שלוש אפשרויות:

• המחייג — מקבל השיחה יראה את מספר המחייג המקורי.
• מסקיו — מקבל השיחה יראה את מספר המסקיו שדרכו עוברת השיחה. בדרך זו יוכל לדעת שהשיחה הגיעה ממספר המסקיו (דרך הפרסום). במקרה שירצה לחזור למתקשרים ניתן לשלוח לו התראות עם פרטי השיחה, והוא יכול גם לבצע שיחת Call Back.
• חסום — מקבל השיחה יראה מספר חסוי.

תרחיש שיחה חוזרת​

רלוונטי כאשר חשיפת המספר היא "מסקיו". מגדיר האם לאפשר תהליך שיחה חוזרת (Call Back) עבור מסקיו זה:

• רגיל — בעת ביצוע שיחה חוזרת יושמעו כל פרטי השיחות האחרונות, כולל השמעת מספר המתקשר, ותהיה אפשרות ללחוץ לחזרה למספרים אלו.
• מנוטרל — לא תהיה אפשרות לביצוע שיחה חוזרת.
• רגיל ללא מספר טלפון — בעת ביצוע שיחה חוזרת, יושמעו פרטי השיחות האחרונות ללא השמעת מספר הטלפון של המתקשר, אך עדיין תתאפשר חזרה אל אותם מתקשרים בלחיצה.

4. ניהול קבצי השמע​

פתיח קצר למחייג השיחה​

קובץ קול שיישמע מיד לאחר החיוג, ולפני שיתחיל הצלצול במספר היעד. ברירת המחדל (אם לא נבחר שום קובץ) היא קובץ קול שאומר "תודה שהתקשרתם, מיד תחוברו". ניתן לטעון קובץ אחר דרך ניהול קבצי השמע ולבחור אותו כאן.

מנגינת צליל חיוג​

צליל ההמתנה בזמן שיש צלצול במספר היעד והמחייג ממתין על הקו למענה. ברירת המחדל היא צליל חיוג רגיל — ניתן להחליף לקובץ מוזיקה/פרסומת.

פתיח קצר למקבל השיחה​

קובץ קול שיושמע למקבל השיחה ברגע שיענה. שימושי להשמיע למקבל השיחה הודעה קצרה על כך שהשיחה הגיעה מפרסום מסוים או מאתר מסוים. במידה ולא הוגדר קובץ קול, לא תושמע שום הודעה.

5. הקלטת שיחות​

סעיף זה מוצג רק בחשבונות שבהם שירות הקלטת השיחות פעיל.

אחוז שיחות הטלפון המוקלטות​

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

למי להשמיע הכרזה כי השיחה מוקלטת​

במידה והוגדרה הקלטת שיחות (אחוז השיחות המוקלטות גדול מ-0%), תישמע באופן אוטומטי במהלך השיחה הכרזה כי השיחות מוקלטות לצורך בקרה ושיפור השירות. לפחות אחד מהצדדים בשיחה חייב לדעת שהיא מוקלטת.

שלוש אופציות:

• המחייג — ההכרזה תישמע למחייג בפתיח השיחה (אם יש פתיח קולי מוגדר, ההכרזה תישמע מיד לאחריו).
• מקבל השיחה — ההכרזה תישמע למקבל השיחה ברגע שיענה.
• שני הצדדים — ההכרזה תישמע בפתיח הקולי גם למחייג וגם למקבל השיחה.

6. ימי עסקים ושעות עבודה​

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

הגדרת שעות פעילות​

יש לסמן ב-X את השעות בהן המסקיו לא יעביר שיחות ליעד, ולהשאיר ב-V את השעות הפעילות.

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

טלפון ייעודי לאי זמינות​

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

7. התראות והודעות​

כתובת דוא"ל להתראות​

ניתן להזין כתובת דוא"ל אחת או יותר לשליחת התראות עבור שיחות למסקיו זה. את הכתובות ניתן להזין בהפרדה של פסיקים ולסיום ללחוץ ENTER.

טלפון SMS​

ניתן להזין מספר טלפון אחד או יותר לקבלת התראה ב-SMS. את המספרים יש להפריד בפסיקים.

שליחת Webhook​

מתי לשלוח את נתוני השיחה לכתובת ה-Webhook:

כתובת שליחת Webhook​

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

לאפשרויות מתקדמות יותר של שליחת נתונים יש להשתמש במנגנון האוטומציה.

8. שייכות — תגיות ומשתמשים​

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

קישורים נוספים:

• הסבר על יצירה וניהול תגיות
• הסבר על יצירה וניהול משתמשים

9. שדות פרטיים​

עשרה שדות פרטיים אופציונליים להוספה של הערות, הגדרות, פרטים מזהים וכל מידע נוסף הקשור למספר המסקיו הספציפי. השדות הפרטיים הם לשימושו של מנהל המערכת ויופיעו בניהול המספרים ובדוחות המערכת.

דוגמאות לשימוש:

• מספר לקוח לכל מסקיו
• שם מקבל השיחה לצורך שליחת התראה
• פרמטרים לשליחת נתונים למערכת CRM

מנהל מערכת יכול לשנות את שם השדה באמצעות כפתור העריכה שלצד שם השדה — השם החדש יחול על השדה בכל המספרים בחשבון. הוספת התו * לשם השדה מסמנת אותו כשדה חובה: השדה יסומן בכוכבית ולא ניתן יהיה לשמור את המספר בלי למלא אותו.

שמירה​

בסיום ההגדרות יש ללחוץ על שמור בראש/תחתית המסך כדי להחיל את השינויים על המספר.

שכפול מספר מסקיו​

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

1. במסך העריכה של המספר, יש ללחוץ על פעולות נוספות ← שכפל Maskyoo
2. בחלונית שנפתחת יש להזין תיאור לרשומה החדשה (כברירת מחדל מוצע שם המבוסס על תיאור המספר המקורי) וללחוץ שמור
3. תיפתח (בלשונית חדשה) רשומה חדשה המכילה עותק של הגדרות המספר

מה משוכפל: יעדי השיחה ואלגוריתם החיוג (כולל שיוך הנתב הקולי), הגדרות הטלפוניה המתקדמות, קבצי השמע, הגדרות ההקלטה, שעות העבודה, ההתראות (דוא"ל, SMS ו-Webhook), השדות הפרטיים והתגיות.

מה לא משוכפל: מספר המסקיו עצמו, שיוכי המשתמשים והיסטוריית השיחות.

השפעות על המערכת​

הגדרות מספר המסקיו הן הרכיב המרכזי שקובע איך כל שיחה למספר מתנהגת — שינוי כאן משפיע מיד על מרכיבים רבים:

• IVR Studio — בחירת "נתב שיחות מתקדם (גרסת בטה)" באלגוריתם החיוג מקשרת את המספר לנתב שנבנה ב‑IVR Studio; שינוי האלגוריתם מנתק את הקישור והשיחה תעבור לחיוג רגיל
• ניהול קבצי השמע — בחירת פתיח, צליל חיוג או הכרזת הקלטה מסתמכת על קבצים קיימים במערכת; מחיקת קובץ קול שמשתמש בו מספר תחזיר אותו לברירת מחדל
• דוחות — תיאור המספר, התגיות והמשתמשים המשויכים מופיעים כעמודות בכל דוחות השיחות; שינוי התיאור משתקף בדוח הפירוט מיידית
• אוטומציה — כתובות דוא"ל ו‑SMS להתראה הן רק שדות יעד — כדי שהתראות יישלחו בפועל נדרש אירוע אוטומציה שמפעיל שליחה
• הקלטה — שינוי אחוז ההקלטה משפיע רק על שיחות חדשות; הקלטות קיימות נשמרות לתקופה מוגבלת ולאחר מכן נמחקות אוטומטית (ראו הקלטת שיחות)
• שעות עבודה — שעות שסומנו ב‑X גורמות לשיחה להגיע לקובץ "אין זמינות" או לטלפון חלופי; פעולה זו נרשמת בנתוני השיחה עם סטטוס מתאים
• לוג שינויים — כל שינוי במסך זה נרשם בלוג השינויים של המערכת לצורכי בקרה

ראו גם​

• ניהול מספרי מסקיו
• הוספת מספר מסקיו חדש
• שחרור מספר מסקיו
• IVR Studio
• ניהול קבצי השמע
• ניהול תגיות
• יצירת משתמש חדש
• ניהול אירועי אוטומציה

שחרור מספר מסקיו​

docs/numbers/manage/release-maskyoo-number.md

שחרור מספר מסקיו​

ניתן לשחרר מספר מסקיו מהמערכת במידה ואין בו צורך.

שלבי שחרור המספר​

1. יש לבחור בניהול מספרי מסקיו וללחוץ על ערוך במספר המסקיו שאותו נרצה לשחרר
2. במסך עריכת המספר יש ללחוץ על שחרור המספר

3. לאחר לחיצה על שחרור המספר, תופיע הודעת אזהרה שהשחרור לא ניתן לביטול. יש לסמן את תיבת הסימון המאשרת את שחרור המספר (התיבה מציגה את מספר המסקיו עצמו) וללחוץ על שחרר. כפתור שחרר מנוטרל עד שמסמנים את התיבה.

בחלונית השחרור מוצג במפורש גם התאריך לסיום הצינון (90 יום קדימה).

תקופת הצינון​

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

בחירת מספר חדש לרשומה משוחררת​

לאחר השחרור, רשומת המספר נשארת במערכת בסטטוס "משוחרר" — עם התיאור, ההגדרות, התגיות והיסטוריית השיחות שלה, אך ללא מספר מסקיו. במקום ליצור רשומה חדשה מאפס, ניתן להקצות לרשומה הקיימת מספר חדש:

1. יש להיכנס למסך העריכה של הרשומה המשוחררת דרך ניהול מספרי מסקיו
2. לצד שדה המספר (הריק) מופיע כפתור בחר מספר — במקום כפתור שחרור המספר (הכפתור מוצג בהתאם להרשאות המשתמש)
3. לחיצה על הכפתור פותחת חלון לבחירת מספר מתוך בנק המספרים — בדומה למסך הוספת מספר חדש, כולל מספרי הצינון של החשבון והמספרים הפנויים
4. לאחר בחירת המספר ואישור ההודעה על אפשרות של חיוב נוסף, המספר החדש מוקצה לרשומה והיא חוזרת לסטטוס פעיל
5. מומלץ לעבור על יתר הגדרות המספר, לעדכן במידת הצורך וללחוץ שמור

בדרך זו נשמרים כל ההגדרות והנתונים ההיסטוריים של הרשומה — תחת מספר מסקיו חדש. כך פועלים גם להקצאת מספר לרשומה שנוצרה באמצעות שכפול מספר מסקיו.

השפעות על המערכת​

שחרור מספר מסקיו הוא פעולה בלתי הפיכה וחייבת להתבצע בזהירות מיוחדת:

• רשומות שיחה היסטוריות — כל השיחות שבוצעו למספר עד לרגע השחרור נשמרות כמות שהן ונשארות נגישות בדוחות עם סימון סטטוס "משוחרר"
• קישורי משתמשים ותגיות — שיוכי המספר למשתמשים ולתגיות מוסרים, והמספר מפסיק להופיע ברשימות של משתמשים שהיו משויכים אליו
• אוטומציה — אירועים שהיו מסוננים למספר זה ספציפית יפסיקו לרוץ; אירועים גנריים (ללא מסנן מספר) יפסיקו פשוט להתייחס אליו כי אין עוד שיחות
• IVR — אם המספר היה מקושר לנתב ב‑IVR Studio, הקישור נמחק — הנתב עצמו נשאר במערכת ללא מספר המפעיל אותו
• בנק המספרים — המספר נכנס ל"תקופת צינון" של שלושה חודשים בה הוא זמין רק לחשבון ששחרר אותו; לאחר מכן עובר לבנק הכללי של מסקיו
• חיוב — השחרור מפסיק את החיוב החודשי עבור אותו מספר; מועד הפסקת החיוב המדויק כפוף לתנאים המסחריים של החשבון (מומלץ לוודא מול מנהל תיק הלקוח)

ראו גם​

• ניהול מספרי מסקיו
• עריכת מספר מסקיו
• הוספת מספר מסקיו חדש
• דו״ח פירוט שיחות
• לוג שינויים

אוטומציה​

docs/automation/index.mdx

אוטומציה​

מנוע האוטומציה של מסקיו מאפשר להגדיר אירועים וכללים שרצים אוטומטית על בסיס התנהגות השיחה — למשל שליחת SMS/דוא"ל, שליחת Webhook למערכת חיצונית (CRM), או הוספה לרשימה שחורה.

• 📋 האוטומציות שלי — צפייה, עריכה, שכפול ומחיקה של אוטומציות קיימות
  → ./events/events-management
• ➕ הוספת אירוע חדש — מדריך ראשי ליצירת אוטומציה חדשה
  → ./events/add-new-event
• 💬 שליחת SMS — שליחת הודעת SMS כפעולת אוטומציה
  → ./events/sms_new_event
• ✉️ שליחת דוא"ל — שליחת מייל אוטומטי בעקבות אירוע
  → ./events/email-new-event
• 🔗 שליחת Webhook — שליחת נתוני שיחה ל-URL חיצוני (למשל CRM)
  → ./events/url-callback
• 📊 אירוע Google Analytics — שליחת event ל-GA בעקבות שיחה
  → ./events/send-google-analytics-event
• 🛑 ניטרול מסקיו — השבתת מספר מסקיו באופן אוטומטי
  → ./events/disable-maskyoo
• 🚫 הוספה לרשימה שחורה — חסימת מספר מחייג באופן אוטומטי
  → ./events/add-number-to-blacklist-automation
• 📅 דוחות מתוזמנים — שליחת דוחות מובנים לפי לוח זמנים
  → ./scheduled-reports/timed-reports-management

השפעות על המערכת​

מנוע האוטומציה הוא מרכיב מרכזי המקשר בין השיחות לבין פעולות תפעוליות חיצוניות ופנימיות:

• הודעות יוצאות — פעולות SMS ודוא״ל משתמשות בהגדרות שולח המערכת ונרשמות כהתראות הזמינות בדוחות.
• אינטגרציות חיצוניות — שליחת Webhook, Google Analytics ו‑Facebook Analytics מאפשרים העברת נתוני שיחה למערכות CRM ושיווק חיצוניות. (פעולות Zapier שנוצרו בעבר ממשיכות לפעול ומוצגות כיום כ"שליחת Webhook"; אינטגרציות חדשות עם Zapier מוקמות דרך פעולת שליחת Webhook.)
• שינוי מצב מספרים — ניטרול מסקיו והוספה לרשימה שחורה משנים את מצב המספרים או את הרשימה השחורה באופן אוטומטי בתגובה לשיחה.
• תלות בפילטרים — כל אירוע מסתמך על תגיות, מספרים ומשתמשים לסינון; שינוי בנתונים אלה משפיע על ריצת האירוע.
• יומן ריצה קריא — מנוע האוטומציה כותב יומן ריצה בשפה פשוטה לכל שיחה: מדוע כלל רץ או לא רץ, אילו מסננים חלו, ומה תוצאת כל פעולה (הצליחה / נכשלה / דולגה). היומן אינו חושף נתונים טכניים פנימיים, וכתובות Webhook מקוצרות לשם הדומיין בלבד.
• תיעוד — כל הפעלה ופעולה נרשמת ביומן השינויים ובדוחות ההתראות לצורך מעקב.

ראו גם​

• יצירת אירוע חדש
• האוטומציות שלי
• דוחות מתוזמנים
• ניהול מספרים
• הגדרות מערכת

יצירת אירוע חדש​

docs/automation/events/add-new-event.md

יצירת אירוע חדש באוטומציה​

אוטומציה היא כלי באמצעותו ניתן ליצור פעולות אוטומטיות שיתרחשו במערכת בהתאם לאירוע שהוגדר מראש. לדוגמה: SMS למקבל השיחה על שיחות שלא נענו.

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

• כל השיחות במערכת
• כל השיחות שלא נענו
• כל השיחות שבוצעו למסקיו ספציפי
• כל השיחות שמשכן ארוך מ-30 שניות

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

סוגי פעולות זמינות​

שלבי יצירת אירוע חדש​

שלב 1 - פתיחת טופס הוספת אירוע​

בתפריט הראשי, יש לבחור אוטומציה ← הוספת אירוע חדש

שלב 2 - פרטים בסיסיים​

בחלונית שתיפתח, בלשונית "פרטים בסיסיים", יש להזין את שם האירוע. לדוגמה: "שיחות שלא נענו".

יש ללחוץ על הבא.

שלב 3 - תזמון הפעלה​

בלשונית "תזמון הפעלה", יש לבחור את סוג האירוע הרצוי.

עיתוי האירוע​

סוגי אירועים​

לאחר בחירת סוג האירוע, המסך יעבור אוטומטית ללשונית הבאה - "תנאים והגבלות".

שלב 4 - תנאים והגבלות​

בלשונית "תנאים והגבלות" ניתן להגדיר הגבלות ריצה וסינונים.

כמה פעמים להפעיל?​

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

פרמטרים להתאמה אישית​

על אילו שיחות להפעיל?​

יש ללחוץ על הבא.

שלב 5 - פעולות לביצוע​

בלשונית "פעולות לביצוע" ניתן ליצור, לערוך, להוסיף ולמחוק פעולות עבור האירוע שנוצר.

הוספת פעולה חדשה​

יש ללחוץ על הוספת פעולה חדשה ולבחור את סוג הפעולה הרצוי מהרשימה.

לפרטים נוספים על כל סוג פעולה, ראו את הקישורים בטבלת סוגי הפעולות למעלה.

השפעות על המערכת​

יצירת אירוע חדש מוסיפה רשומה פעילה למנוע האוטומציה ומייצרת תגובות מיידיות לשיחות:

• טריגר על שיחות — האירוע יופעל אוטומטית לפי עיתוי (תחילת שיחה, מענה, סיום, קבלת SMS) על כל שיחה המתאימה לפילטרים.
• פילטרים לפי מספרים ותגיות — סינון לפי מספר מסקיו, תגית, משתמש, סטטוס שיחה, דירוג ומשך; מצמצם את ההפעלות רק לשיחות הרלוונטיות.
• הפעלת פעולות מרובות — לכל אירוע ניתן לשייך כמה פעולות (SMS + דוא״ל + שליחת Webhook) שיופעלו ברצף.
• השפעה על מכסות חיצוניות — פעולות הכוללות שליחת SMS מחסרות קרדיט; שליחת Webhook יוצרת עומס על מערכות ה‑CRM הקולטות.
• מעקב ותיעוד — כל הפעלה של האירוע נרשמת ביומן השינויים ומאפשרת מעקב בניהול האוטומציות.

ראו גם​

• האוטומציות שלי
• שליחת SMS
• שליחת דוא״ל
• שליחת Webhook
• ניהול תגיות
• אוטומציה

האוטומציות שלי​

docs/automation/events/events-management.md

האוטומציות שלי​

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

כניסה לניהול אירועים​

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

כעת ניתן לצפות בכל האירועים ולבצע פעולות. להלן דוגמה של מסך ניהול אירועים:

חיפוש אירוע​

בראש המסך מוצגת חלונית חיפוש אירוע המאפשרת לסנן את רשימת האירועים:

לאחר בחירת המסננים יש ללחוץ על חיפוש; לחיצה על ניקוי מאפסת את המסננים.

עמודות הדוח​

עריכת אירוע​

בניהול אירועים ניתן ללחוץ על ערוך כדי לערוך את האירוע והפעולות שהוגדרו עבורו. ניתן לעבור בין הלשוניות של האירוע ולערוך את הנתונים.

מחיקת אירוע​

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

שכפול אירוע​

ניתן לשכפל אירוע אם ברצוננו לשמור את רוב ההגדרות של האירוע.

בניהול אירועים יש ללחוץ על שכפל בשורת האירוע הרצוי. החלון הבא יופיע:

השפעות על המערכת​

ניהול האירועים מאפשר שליטה מלאה במצב האוטומציה במערכת — כל שינוי משפיע מיד על התנהגות השיחות:

• ניטרול אירוע — הפיכת אירוע ללא פעיל עוצרת מיד את הטריגר; שיחות חדשות לא יפעילו את הפעולות המשויכות עד להפעלה מחדש.
• עריכת פילטרים — שינוי במספרים, בתגיות או בסטטוסי הסינון משנה את קבוצת השיחות שיפעילו את האירוע מכאן והלאה; לא חל רטרואקטיבית.
• מחיקת אירוע — מסירה את האירוע ואת כל הפעולות המשויכות; היסטוריית ההפעלות ונתוני ההתראות נשמרים בדו"ח ההתראות.
• שכפול אירוע — יוצר עותק עצמאי — ניתן לערוך את העותק בלי להשפיע על האירוע המקורי; שימושי לבדיקת גרסאות.
• יומן ריצה קריא — לצד יומן השינויים, כל הפעלה של אירוע נרשמת ביומן ריצה ידידותי המסביר מדוע כל כלל רץ או לא רץ ומה עלה בגורל כל פעולה.
• תיעוד שינויים — כל עריכה, מחיקה או ניטרול נרשמים ביומן השינויים למעקב.

ראו גם​

• יצירת אירוע חדש
• אוטומציה
• יומן שינויים
• ניהול תגיות

אוטומציה - הודעת SMS​

docs/automation/events/sms_new_event.md

אוטומציה - הודעת SMS​

זהו הסבר כללי על יצירת אוטומציה של שליחת SMS והוא מכיל את כל האופציות הקיימות.

אוטומציות שכיחות לשליחת SMS:

• שליחת SMS למקבל השיחה בתחילת השיחה
• שליחת SMS למקבל השיחה על שיחות שלא נענו
• שליחת SMS למקבל השיחה על כל השיחות
• שליחת SMS למחייג על שיחות שלא נענו
• שליחת SMS למחייג על שיחות שנענו
• שליחת SMS למחייג על כל השיחות

יצירת האירוע​

הבסיס של כל אוטומציה — יצירת האירוע, בחירת סוג האירוע, הגדרת מסננים — זהה לכל סוגי הפעולות. לפירוט מלא של שלבים 1–4 (שם אירוע, עיתוי, סוגי אירועים ומסננים) ראו מדריך יצירת אירוע חדש.

להלן הפרטים הספציפיים לפעולת הודעת SMS (שלב 5 בתהליך):

שלב 5 - הגדרת פעולת SMS​

בלשונית "פעולות להרצה", יש ללחוץ על ולבחור בהודעת SMS.

במידה ובחרנו בפעולה של שליחת SMS, תיפתח חלונית לעריכת פרטי ההודעה:

הגדרות הודעת SMS​

אפשרויות נמען​

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

אפשרויות שולח​

בבורר השולח קיימות שתי אפשרויות:

• מספר Maskyoo - מספר המסקיו שאליו בוצעה השיחה יופיע כשולח ההודעה.
• אחר - בחירת שולח מתוך רשימת השולחים הרשומים בחשבון ה-SMS (מספרים או שמות שולח שאושרו מראש). מתוך הרשימה ניתן גם לעבור להוספת שולח חדש בהגדרות המערכת.

שדות דינאמיים​

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

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

מעבר לנתוני השיחה הבסיסיים, ניתן לשבץ שדות META של מקור התנועה והקמפיין — לדוגמה utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, וכן כותרת/כתובת העמוד שממנו בוצעה השיחה. שדות אלה מתמלאים כשהמספר מפורסם עם פיקסל מסקיו.

שמירת האירוע​

יש ללחוץ על ולאחר מכן ללחוץ על

השפעות על המערכת​

פעולת שליחת SMS משפיעה על תקציב התקשורת, על חוויית המתקשר ועל הדיווח:

• חיוב קרדיט — כל הודעה נשלחת דרך ספק ה‑SMS ומחסרת קרדיט מחשבון הארגון; הודעות ארוכות עשויות להתפצל לכמה יחידות חיוב.
• מספר שולח — לפי הבחירה בפעולה: מספר המסקיו או שולח מרשימת השולחים הרשומים; את רשימת השולחים מנהלים בהגדרות הכלליות. השולח מופיע על צג הנמען.
• שדות דינאמיים — ערכי השיחה (ANI, משך, מספר מסקיו, תגיות וכו') מוזרקים לתוכן ההודעה בזמן השליחה; שמות שדות פרטיים נלקחים מההגדרות הכלליות.
• דוחות — כל הודעה נרשמת כ‑notification ומוצגת בדוחות ובווידג׳ט ה‑SMS בלוח הבקרה.
• דחיית שליחה — ניתן להגדיר עיכוב (דקות/שעות/ימים); בטווח הזמן הזה האירוע ממתין ולא שולח בפועל.

ראו גם​

• יצירת אירוע חדש
• שליחת דוא״ל
• הגדרות מערכת
• אוטומציה
• דוחות

אוטומציה - שליחת דוא"ל​

docs/automation/events/email-new-event.md

אוטומציה - שליחת דוא"ל​

מסמך זה מתאר את הגדרת פעולת שליחת דוא"ל בתוך אירוע אוטומציה.

יצירת האירוע​

שלבי יצירת האירוע (1–4: שם, סוג, עיתוי, מסננים) זהים לכל פעולה באוטומציה — לפירוט מלא ראו מדריך יצירת אירוע חדש.

להלן הפרטים הספציפיים לפעולת שליחת דוא"ל (שלב 5):

שלב 5 - הגדרת פעולת דוא"ל​

בלשונית "פעולות לביצוע", יש ללחוץ על ולבחור בהודעת דוא"ל.

במידה ובחרנו בפעולה של שליחת דוא"ל, תיפתח חלונית לעריכת פרטי ההודעה:

הגדרות הודעת דוא"ל​

אפשרויות נמען​

בבורר הנמען קיימות שתי אפשרויות:

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

שדות דינאמיים​

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

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

מעבר לנתוני השיחה הבסיסיים, ניתן לשבץ שדות META של מקור התנועה והקמפיין — לדוגמה utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, וכן כותרת/כתובת העמוד שממנו בוצעה השיחה. שדות אלה מתמלאים כשהמספר מפורסם עם פיקסל מסקיו.

שמירת האירוע​

יש ללחוץ על ולאחר מכן ללחוץ על

השפעות על המערכת​

פעולת שליחת דוא״ל היא חלק ממערך ההתראות של מסקיו, עם תלויות בתצורת המערכת:

• שולח ברירת מחדל — שם וכתובת השולח נלקחים מההגדרות הכלליות; שינוי שם השולח משפיע על כל האירועים שאינם מגדירים שולח ספציפי.
• יעדי שליחה — ניתן לשלוח לכתובות שהוגדרו במספר המסקיו (מקבל השיחה) או לנמענים קבועים (ניתן לציין מרובים).
• שדות דינאמיים בגוף ובנושא — נתוני השיחה מוזרקים אוטומטית; מידע נוסף משדות פרטיים נלקח מההגדרות הכלליות.
• תיעוד כ‑notification — כל הודעה נשמרת כ‑notification וזמינה בדוחות ההתראות לצורך מעקב.
• תלות בספק דוא״ל — המערכת שולחת דרך שירות הדוא״ל המוגדר (SES וכדומה); כשל זמני בספק יגרום לעיכוב בהודעות.

ראו גם​

• יצירת אירוע חדש
• שליחת SMS
• הגדרות מערכת
• אוטומציה
• דוחות

אוטומציה - שליחת Webhook​

docs/automation/events/url-callback.md

אוטומציה - שליחת Webhook​

פעולת שליחת Webhook מאפשרת שליחת נתוני השיחה בזמן אמת לכתובת חיצונית (למשל מערכת CRM, אפליקציה פנים-ארגונית וכו').

יצירת האירוע​

שלבי יצירת האירוע (1–4: שם, סוג, עיתוי, מסננים) זהים לכל פעולה באוטומציה — לפירוט מלא ראו מדריך יצירת אירוע חדש.

להלן הפרטים הספציפיים לפעולת שליחת Webhook (שלב 5):

שלב 5 - הגדרת פעולת שליחת Webhook​

בלשונית "פעולות להרצה", יש ללחוץ על ולבחור בשליחת Webhook.

פעולת שליחת Webhook מאפשרת שליחת נתוני השיחה לכתובת חיצונית כלשהי (כמו מערכת CRM וכדומה).

במידה ובחרנו בפעולה של שליחת Webhook, תיפתח חלונית לעריכת פרטי הקישור:

הגדרות שליחת Webhook​

הגדרת פרמטרים​

ניתן להוסיף פרמטרים ללא הגבלה:

• המפתח - שם הפרמטר, השדה המקבל.
• הערך - מה שנרצה לשלוח לאותו שדה. ניתן להזין ערך קבוע או שדה דינאמי של נתוני השיחה.

בדיקת קישור​

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

שמירת האירוע​

יש ללחוץ על ולאחר מכן ללחוץ על

השפעות על המערכת​

שליחת Webhook מחברת את מסקיו למערכות חיצוניות בזמן אמת, עם השפעות תפעוליות:

• קריאת HTTP — פעולה זו יוצרת בקשת GET או POST לכתובת חיצונית (CRM, Webhook, אפליקציה פנימית) עם פרמטרים שהוגדרו.
• שדות דינאמיים — ניתן להזרים נתוני שיחה (מספר המתקשר, משך השיחה, מספר היעד ועוד) כערכי פרמטרים; מאפשר אינטגרציה מלאה ללא פיתוח נוסף. בנוסף זמינה קבוצת שדות META של מקור התנועה והקמפיין (utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, fbclid, ga4cid וכן כותרת/כתובת העמוד שממנו בוצעה השיחה) — שדות אלה מתמלאים כשהמספר מפורסם עם פיקסל מסקיו.
• פרמטרים ברירת מחדל — סימון התיבה מוסיף אוטומטית את כל השדות התקניים של מסקיו; ביטול הסימון יגביל לפרמטרים ידניים בלבד.
• כשלים וטיפול — תשובת השרת החיצוני לא נשמרת במלואה; תוצאת הפעולה (הצליחה / נכשלה) נרשמת ביומן ריצה קריא-ללקוח, וכתובת ה-Webhook מקוצרת בו לשם הדומיין בלבד.
• עומס על היעד — שיעור גבוה של שיחות יגרום לשיעור גבוה של קריאות ה‑HTTP; יש להבטיח שמערכת ה‑CRM תעמוד בקצב.
• בדיקת קישור — כפתור "בדוק קישור" שולח קריאה ניסיונית מיד לווידוא תקינות ההגדרה לפני הפעלת האירוע בפועל.

ראו גם​

• יצירת אירוע חדש
• תיעוד API
• אוטומציה

אוטומציה - אירוע Google Analytics​

docs/automation/events/send-google-analytics-event.md

אוטומציה - אירוע Google Analytics​

מאמר זה מדבר על שליחת אירוע לגוגל אנליטיקס.

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

להוראות חיבור מלא לממשקי גוגל, יש ללחוץ על הקישור הבא: חיבור לממשקי גוגל

יצירת האירוע​

שלבי יצירת האירוע (1–4: שם, סוג, עיתוי, מסננים) זהים לכל פעולה באוטומציה — לפירוט מלא ראו מדריך יצירת אירוע חדש.

להלן הפרטים הספציפיים לפעולת Google Analytics (שלב 5):

שלב 5 - הגדרת פעולת Google Analytics​

בלשונית "פעולות לביצוע", יש ללחוץ על ולבחור באירוע Google Analytics.

במידה ובחרנו בפעולה של אירוע Google Analytics, תיפתח החלונית הבאה:

הגדרות אירוע Google Analytics​

לצד כל שדה מפתח ולצד כל שדה ערך קיים תפריט בחירה (סמל הנורה): בצד המפתח ניתן לבחור פרמטרים נפוצים (כגון מספר מסקיו, מספר מתקשר, סטטוס שיחה ומשך שיחה), ובצד הערך ניתן לבחור ערכים דינאמיים — נתוני השיחה שיוזרקו לערך הפרמטר בזמן השליחה. ניתן כמובן גם להקליד ערכים קבועים באופן חופשי.

פרמטרי ברירת המחדל​

פעולה חדשה נוצרת עם ארבעה פרמטרים מובנים, שניתן לערוך, להסיר או להוסיף עליהם פרמטרים נוספים:

שמירת האירוע​

יש ללחוץ על ולאחר מכן ללחוץ על

השפעות על המערכת​

שליחת אירוע ל‑Google Analytics סוגרת את מעגל המדידה השיווקית של שיחות הטלפון:

• conversion ב‑GA4 — כל שיחה מתאימה נרשמת כ‑event ב‑Google Analytics (GA4 בלבד, דרך Measurement Protocol) ומשפיעה על יעדי conversion, מודלי ייחוס ו‑goals. התמיכה ב-Universal Analytics (UA) הוסרה לאחר שהשירות הושבת על ידי Google.
• דורש פיקסל מסקיו באתר — ללא הטמעת קוד ה‑Google Analyze באתר המפרסם, לא יהיה קישור בין השיחה לבין מקור התנועה.
• פרמטרים דינאמיים — ניתן להעביר כל פרמטר עם ערכים קבועים או דינאמיים לפי נתוני השיחה (סטטוס, משך, מזהה שיחה ועוד) להתאמה מדויקת של דיווחי ה‑GA.
• נראות בדוחות Google — האירועים זמינים בדוח המובנה של Google באמצעות Google Reports ומשולבים בלוחות הבקרה של מערך הפרסום.
• נשלח רק לשיחות עם נתוני גלישה — האירוע נשלח רק כאשר לשיחה צמודים נתוני גלישה עם מזהי Google Analytics שנאספו על ידי פיקסל מסקיו בעמוד המפרסם; בשיחות ללא נתונים אלה הפעולה מדולגת, והדבר נרשם ביומן הריצה של האירוע.

ראו גם​

• תוסף Google Analyze
• יצירת אירוע חדש
• שליחת Webhook
• דוחות Google
• אוטומציה

אוטומציה - אירוע Facebook Analytics​

docs/automation/events/send-facebook-analytics-event.md

אוטומציה - אירוע Facebook Analytics​

פעולת Facebook Analytics שולחת אירוע עם פרטי השיחה למערכת האנליטיקה (פיקסל) של Facebook. כך ניתן למדוד שיחות טלפון כהמרות בקמפיינים של Facebook — בדומה לשליחת אירוע Google Analytics.

דרישות מקדימות​

שליחת האירוע ל-Facebook היא חלק מחיבור רחב יותר ואינה עומדת בפני עצמה:

• מספר המסקיו צריך להיות מפורסם בעמוד אינטרנט שבו מוטמע פיקסל מסקיו, ושבו פועל גם פיקסל של Facebook.
• האירוע נשלח רק עבור שיחות שאליהן צורפו נתוני גלישה עם מזהי הפיקסל של Facebook (למשל, שיחה של גולש שהגיע לאתר דרך מודעת Facebook). בשיחות ללא נתוני גלישה כאלה הפעולה מדולגת, והדבר נרשם ביומן הריצה של האירוע.

יצירת האירוע​

שלבי יצירת האירוע (1–4: שם, סוג, עיתוי, מסננים) זהים לכל פעולה באוטומציה — לפירוט מלא ראו מדריך יצירת אירוע חדש.

להלן הפרטים הספציפיים לפעולת Facebook Analytics (שלב 5):

שלב 5 - הגדרת פעולת Facebook Analytics​

בלשונית "פעולות לביצוע", יש ללחוץ על הוספת פעולה חדשה ולבחור בFacebook Analytics.

הגדרות הפעולה​

שמירת האירוע​

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

השפעות על המערכת​

• מדידת המרות ב-Facebook — כל שיחה מתאימה נרשמת כאירוע בפיקסל של Facebook ויכולה לשמש למדידת המרות ולאופטימיזציה של קמפיינים.
• תלות בנתוני הגלישה — האירוע משויך לביקור המקורי של הגולש באתר; ללא פיקסל מסקיו בעמוד המפרסם לא ייווצר הקישור בין השיחה למקור התנועה.
• דילוג שקוף — שיחות ללא מזהי פיקסל של Facebook אינן נשלחות; הפעולה מדולגת והדבר נרשם ביומן הריצה של האירוע.

ראו גם​

• יצירת אירוע חדש
• אירוע Google Analytics
• האוטומציות שלי
• תוספים
• אוטומציה

אוטומציה - ניטרול מסקיו​

docs/automation/events/disable-maskyoo.md

אוטומציה - ניטרול מסקיו​

פעולת ניטרול מסקיו הופכת את מספר המסקיו אליו בוצעה השיחה למושהה — כלומר הוא מפסיק לקבל שיחות.

מתי להשתמש בפעולה זו​

• כאשר רוצים להגביל את כמות השיחות לאותו מסקיו (למשל, ניתן לכבות מספר לאחר X שיחות ביום)
• כדי להשבית מספר אחרי שהלקוח ביקש להפסיק קבלת שיחות
• שימושי בקמפיינים מוגבלי תקציב

יצירת האירוע​

שלבי יצירת האירוע (1–4: שם, סוג, עיתוי, מסננים) זהים לכל פעולה באוטומציה — לפירוט מלא ראו מדריך יצירת אירוע חדש.

להלן הפרטים הספציפיים לפעולת ניטרול מסקיו (שלב 5):

שלב 5 - הגדרת פעולת ניטרול​

בלשונית "פעולות לביצוע", יש ללחוץ על ולבחור בניטרול מסקיו.

הגדרת הפעולה​

בחלון שייפתח יש לתת שם לפעולה. לדוגמה: "ניטרול מסקיו לקוח X".

שמירת האירוע​

יש ללחוץ על ולאחר מכן ללחוץ על

השפעות על המערכת​

פעולת ניטרול מסקיו משנה את מצב המספר בזמן אמת ויש לה השלכות תפעוליות משמעותיות:

• שינוי סטטוס ה‑DDI — מספר המסקיו יועבר מיד לסטטוס "מושהה"; שיחות חדשות יידחו (busy/unreachable).
• השפעה על קמפיינים — אם המספר משוייך לקמפיין פרסום חיצוני, המספר עדיין יופיע שם אך יתנהג כחסום — דבר שעלול להטעות לקוחות.
• הפעלה מחדש ידנית — הפעלה מחדש של המספר מתבצעת באופן ידני דרך ניהול המספרים. אין פעולת אוטומציה שמפעילה מספר מנוטרל בחזרה — הניטרול הוא חד‑כיווני ומחייב הפעלה ידנית.
• התראות בדוא"ל — בעת ניטרול אוטומטי נשלחות גם הודעות דוא"ל התראה על השבתת המספר.
• תיעוד אוטומטי — הפעולה נרשמת ביומן השינויים עם ציון המקור (אירוע האוטומציה שהפעיל אותה).
• לא מוחק נתונים — נתוני CDR, הקלטות ותגיות של המספר נשמרים; רק מצב ההפעלה שלו משתנה.
• שימושי לקמפיינים תקציביים — מתאים להגבלת עלויות: כיבוי המספר לאחר X שיחות ליום או השבתה בסיום תקציב.

ראו גם​

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

אוטומציה - הוספה לרשימה שחורה​

docs/automation/events/add-number-to-blacklist-automation.md

אוטומציה - הוספה לרשימה שחורה​

פעולת הוספה לרשימה שחורה מוסיפה אוטומטית את מספר המחייג לרשימה השחורה של המערכת — ומנתקת באופן אוטומטי כל שיחה עתידית ממספר זה.

מתי להשתמש בפעולה זו​

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

יצירת האירוע​

שלבי יצירת האירוע (1–4: שם, סוג, עיתוי, מסננים) זהים לכל פעולה באוטומציה — לפירוט מלא ראו מדריך יצירת אירוע חדש.

להלן הפרטים הספציפיים לפעולת הוספה לרשימה שחורה (שלב 5):

שלב 5 - הגדרת פעולת חסימה​

בלשונית "פעולות לביצוע", יש ללחוץ על ולבחור בהוספה לרשימה שחורה.

הגדרת הפעולה​

בחלון שייפתח יש לתת שם לפעולה. לדוגמה: "חסימת מתקשר לאחר 10 שיחות ביום".

שמירת האירוע​

יש ללחוץ על ולאחר מכן ללחוץ על

השפעות על המערכת​

הוספה אוטומטית לרשימה שחורה מגנה על הארגון אך משפיעה רוחבית על כל המספרים:

• חסימה גורפת — כאשר המתקשר מתווסף לרשימה השחורה, הוא יידחה בכל שיחה לכל מספרי המסקיו בארגון — לא רק למספר המסקיו שהפעיל את האירוע.
• שיחות עתידיות — כל חיוג עתידי מהמספר החסום ייענה אוטומטית בחיווי עסוק/נתק בלי להגיע למספר היעד.
• התראות בדוא"ל — בעת הוספה אוטומטית של מספר לרשימה השחורה נשלחת הודעת דוא"ל התראה למנהלי המערכת, עם פרטי המספר שנחסם ושם האירוע שהפעיל את החסימה.
• הסרה ידנית — ניתן להסיר את המספר מהרשימה השחורה רק דרך ניהול הרשימה השחורה; אין אוטומציה להסרה.
• שילוב בזיהוי spam — מתאים לאירועי "X שיחות ביום מאותו מתקשר" כהגנה מפני התקפות ספאם או טלפונים חוזרים מטרידים.
• תיעוד — כל הוספה נרשמת ביומן השינויים עם מקור האירוע; מספרים שנחסמו באופן אוטומטי מסומנים בהתאם.

ראו גם​

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

יצירת דו"ח מתוזמן​

docs/automation/scheduled-reports/create-timed-report.md

יצירת דו"ח מתוזמן​

ניתן להגדיר שליחת דוחות ספציפיים נבחרים באופן קבוע בדוא"ל.

שלבי יצירת דו"ח מתוזמן​

1. בתפריט הראשי יש לגשת לדוחות

2. יש לבחור את סוג הדוח הרצוי

   

3. ללחוץ על כפתור שנמצא בצד שמאל מתחת לסיכומי השיחות

4. תיפתח החלונית הבאה:

   

שדות הטופס​

שמירת הדו"ח המתוזמן​

ניתן ללחוץ על שמור או על שמור + ריצת ניסיון (במקרה זה הדו"ח יישלח באותו רגע כניסיון לכתובת הדוא"ל המוגדרת).

השפעות על המערכת​

יצירת דו״ח מתוזמן רושמת אותו ללוח הזמנים, והמערכת תשלח אותו אוטומטית במועדים שנקבעו:

• תזמון — המערכת תריץ את הדו״ח בשעה ובתדירות שנקבעו; ריצות שהוחמצו (למשל בגלל תחזוקה) לא יפוצו אוטומטית.
• סינון לפי הרשאות הנמען — הדו״ח מסונן לפי המספרים הנגישים למשתמש שנבחר כנמען; שינוי בהרשאות ישפיע על תוכן הדו״ח הבא.
• שולח דוא״ל — ההודעה תישלח מהכתובת שהוגדרה בהגדרות הכלליות כשולח המערכת.
• פורמט הקובץ — CSV/XLSX/XML/דוא״ל רגיל משפיע על הגודל והתצוגה אצל הנמען; פורמטים גדולים עלולים להיחסם בשירות הדוא״ל הנמענים.
• ריצת ניסיון — לחיצה על "שמור + ריצת ניסיון" שולחת את הדו״ח מיד לכתובת שהוגדרה לנמען, ללא חיכוי לתזמון.
• דו״ח ריק — ניתן להגדיר התנהגות כאשר אין שיחות בתקופה (לשלוח בכל מקרה או לדלג על השליחה).

ראו גם​

• ניהול דוחות מתוזמנים
• שליחת דו״ח מובנה בדוא״ל
• ניהול משתמשים
• דוחות
• הגדרות מערכת

ניהול דו"חות מתוזמנים​

docs/automation/scheduled-reports/timed-reports-management.md

ניהול דו"חות מתוזמנים​

עבור דו"חות מתוזמנים קיימים, ניתן לצפות, לערוך, למחוק, לנטרל ולבצע שליחת ניסיון.

גישה לניהול דו"חות מתוזמנים​

בכדי לבצע את אחת מפעולות אלו יש לגשת בתפריט הראשי לאוטומציה ← דוחות מתוזמנים.

כעת יופיעו כל הדוחות המתוזמנים שהוגדרו במערכת.

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

סינון הרשימה​

מעל הרשימה מוצגת חלונית סינון דוחות מתוזמנים עם המסננים הבאים:

עמודות הרשימה​

דרך תפריט רשימת העמודות ניתן להוסיף לתצוגה עמודות נוספות: מסנני דו"ח (המסננים שנשמרו בדו״ח), תזמון שליחת הדו"ח (חודשים / תאריכים / ימים, כולל מועדי הריצה הבאה והקודמת), תוצרים (סוג השליחה, הנושא, שליחת דו״ח ריק ושימוש בכתובות נוספות) ותאריך עדכון.

פעולות זמינות​

בעמודת פעולות ניתן לבחור:

• עריכה - עריכת הגדרות הדו״ח (ראו בהמשך)
• מחיקה - מחיקת הדוח המתוזמן
• צפייה בדו"ח - פתיחת תצוגה מקדימה של נתוני הדוח במסך הדוחות, בחלון נפרד
• נטרול / הפעלה - שינוי מצב הדו״ח בין פעיל ללא-פעיל (החלפת מצב; דוח פעיל ניתן לנטרל ודוח מנוטרל ניתן להפעיל מחדש)
• שליחת ניסיון - קבלת הדוח באותו רגע בדוא"ל

עריכת דוח מתוזמן​

1. יש ללחוץ על ערוך בעמודת פעולות

2. תיפתח החלונית הבאה:

   

3. יש ללחוץ על המשך

4. ללחוץ על כפתור

5. לערוך את השדות הרצויים (להסבר על שדות הדו"ח ראו יצירת דו"ח מתוזמן)

6. ללחוץ על שמור או על שמור + ריצת ניסיון

השפעות על המערכת​

ניהול דוחות מתוזמנים קובע את מצב השליחות במערכת — פעולות כאן משפיעות מיד על שליחות הדו״חות המתוזמנות הבאות:

• ניטרול דו״ח — הפיכה ללא פעיל עוצרת את השליחות העתידיות; ההיסטוריה (דוחות שכבר נשלחו) לא נמחקת.
• מחיקת דו״ח — הסרת ההגדרה מהמערכת; אין הפעלות נוספות עד יצירת הגדרה חדשה.
• שליחת ניסיון — מפיקה ושולחת מיד את הדו״ח באותו רגע לנמען שהוגדר; שימושית לבדיקת פורמט ותוכן לפני ההפעלה התזמונית.
• עריכה — שינוי בתזמון, נמענים או פורמט משפיע רק על שליחות מכאן והלאה; דוחות שכבר נשלחו לא משתנים.
• תלות בנמען — אם המשתמש הנמען נמחק או שהרשאותיו ירדו, הדו״ח עלול להופק ריק או להיכשל; מומלץ לבדוק מדי פעם את רשימת הנמענים.

ראו גם​

• יצירת דו״ח מתוזמן
• שליחת דו״ח מובנה בדוא״ל
• דוחות
• ניהול משתמשים
• אוטומציה

שליחת דו"ח מובנה בדוא"ל​

docs/automation/scheduled-reports/automatic-email-reports.md

שליחת דו"ח מובנה בדוא"ל​

ניתן להגדיר דוחות אוטומטיים קבועים שיישלחו למשתמש ברמה היומית, השבועית והחודשית. מדובר על דוחות מובנים של מסקיו.

הדוחות יישלחו בסוף יום לכתובת הדוא"ל שהוגדרה בשם המשתמש.

דוגמא מהדוח:

הגדרת שליחת דוחות אוטומטיים​

1. בתפריט הראשי יש לבחור משתמשים ← ניהול משתמשים
2. יש לבחור את המשתמש אליו נרצה לשלוח דוח אוטומטי וללחוץ על ערוך
3. לבחור בלשונית שליחת דוחות בדוא"ל
4. יש לסמן ב-V את הדוח הרצוי

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

שליחת הדוחות לכתובת דוא"ל נוספות​

ניתן להוסיף כתובות דוא"ל נוספות שיקבלו את הדוחות האוטומטיים.

לאחר שהוגדרו ההגדרות הרצויות וסומנו הדוחות שיישלחו למשתמש, יש ללחוץ על שמור.

השפעות על המערכת​

שליחת דו״ח מובנה בדוא״ל היא הגדרה ברמת המשתמש ופועלת במסלול נפרד מדוחות מתוזמנים:

• מופעל ברמת המשתמש — ההגדרה נשמרת בכרטיס המשתמש עצמו, ולא כאוטומציה נפרדת; כל משתמש יכול לקבל דוחות יומיים/שבועיים/חודשיים.
• נשלח לכתובת הדוא״ל של המשתמש — ברירת המחדל היא הכתובת שהוגדרה בכרטיס המשתמש; ניתן להוסיף כתובות נוספות לקבלת עותק.
• דו״ח מובנה מהמערכת — הפורמט והנתונים קבועים לפי סוג הדו״ח הנבחר; אין אפשרות להתאים עמודות או מסננים כמו בדו״ח מתוזמן רגיל.
• סינון לפי הרשאות — תוכן הדו״ח מוגבל למספרים הנגישים למשתמש לפי ההרשאות שהוגדרו לו.
• שליחה אוטומטית — מדי יום המערכת עוברת על רשימת המשתמשים ומפיקה דו״חות לפי הסימונים שבלשונית; אין צורך להגדיר כל דו״ח בנפרד.
• דו״ח ריק — ניתן לבחור האם לשלוח את הדו״ח גם אם אין נתונים באותה תקופה.

ראו גם​

• יצירת דו״ח מתוזמן
• ניהול דוחות מתוזמנים
• ניהול משתמשים
• דוחות
• אוטומציה

נתב שיחות (IVR)​

docs/ivr/index.mdx

נתב שיחות (IVR)​

נתב השיחות (IVR — Interactive Voice Response) של מסקיו מאפשר לבנות תרחישי ניתוב טלפוניים מורכבים — תפריטים קוליים, הקלטות, ניתוב לפי לחיצות DTMF, הודעות לפי שעות עבודה, קריאת נתונים מ-API חיצוניים, שליחת הודעות (SMS/דוא"ל), ועוד — ללא צורך בכתיבת קוד.

המערכת כוללת שני מסכים:

• 📋 ניהול נתבי שיחות (IVR) — רשימה של כל הנתבים בחשבון — יצירה, עריכה, שכפול ומחיקה
  → ./manage-ivrs
• 🎨 IVR Studio — עורך ויזואלי מבוסס drag & drop ליצירת ועריכת תרחישי IVR
  → ./ivr-studio

השפעות על המערכת​

תכונת ה-IVR Studio מסומנת BETA בממשק.

נתב שיחות (IVR) הוא נקודת כניסה של שיחה לעסק — ולכן משפיע על רוב תתי‑המערכות:

• מספרי מסקיו — נתב שפורסם זמין לבחירה רק כאשר נבחר אלגוריתם החיוג נתב שיחות מתקדם (גרסת בטה); שינוי הנתב משפיע על כל המספרים שקושרו אליו
• שיחות (CDR) — התרחיש יכול להוסיף מידע ל‑CDR (רכיב "פרמטרים ל‑CDR"), להקליט את השיחה, ולתייג אותה לצורך דוחות
• אוטומציה — תוצאת הניתוב (נענה / לא נענה / ניתוק / העברה לתא קולי) היא הטריגר שמפעיל אירועי אוטומציה בסינון לאותו מספר
• רשימה שחורה — רכיבי IVR יכולים לבדוק ולהוסיף מספרים לרשימה השחורה תוך כדי השיחה
• קבצי שמע (הקלטות / TTS) — תלות ישירה בקבצים ב[ניהול קבצי הקול]; שפת ברירת מחדל של הנתב קובעת גם את קול ה‑TTS
• SMS / דוא״ל — רכיבי שליחה מייצרים הודעות יוצאות שנספרות בדוחות ההתראות
• Webhooks ומשתנים — קריאות ל‑API חיצוני יכולות להשפיע על מסלול השיחה בזמן אמת

ראו גם​

• ניהול נתבי שיחות (IVR)
• IVR Studio
• הגדרות טלפוניה מתקדמות
• ניהול קבצי הקול
• ניהול רשימה שחורה
• אירועי אוטומציה

ניהול נתבי שיחות (IVR)​

docs/ivr/manage-ivrs.md

ניהול נתבי שיחות (IVR)​

מסך זה מציג את כל נתבי השיחה (IVRs) שהוגדרו בחשבון ומאפשר לנהל אותם באופן מרוכז.

כניסה למסך​

בתפריט הראשי יש ללחוץ על נתב שיחות (IVR) ← ניהול נתבי שיחות.

פעולות זמינות במסך​

• צור IVR חדש — פותח את IVR Studio עם קנבס ריק לבניית נתב חדש
• ערוך — פותח את IVR Studio עם התרחיש הקיים לעריכה
• שכפל — יצירת עותק של נתב קיים (שימושי ליצירת וריאציות על אותו תרחיש)
• מחק — הסרת הנתב מהמערכת

הרשימה מציגה את נתבי השיחה בחשבון, מהחדש לישן; ניתן למיין בלחיצה על כותרות העמודות.

שיוך IVR למספר מסקיו​

כדי שנתב ישמש עבור מספר מסקיו, יש להגדיר את המספר כך:

1. יש להיכנס לניהול מספרי מסקיו ולערוך את המספר הרצוי
2. באזור הגדרות טלפוניה מתקדמות יש לבחור אלגוריתם לחיוג ← נתב שיחות מתקדם (גרסת בטה)
3. לבחור את ה-IVR הרצוי מתוך הרשימה
4. לשמור את השינויים

השפעות על המערכת​

ניהול נתבי שיחות משפיע ומושפע:

• מספרי מסקיו — כל נתבי השיחה בחשבון זמינים לבחירה בהגדרות טלפוניה מתקדמות, כולל נתבים שנשמרו כטיוטה בלבד; לכן יש לוודא שהנתב הנבחר פורסם לפני שיוכו למספר. מספרים שכבר מקושרים לנתב ימשיכו לנתב לפיו עד לעדכון המספר
• מחיקת נתב — המערכת אינה חוסמת מחיקה של נתב שמספר מסקיו מנותב אליו; לפני מחיקה יש לוודא שאף מספר אינו מנותב לנתב זה
• שכפול נתב — יוצר עותק עצמאי עם היסטוריית גרסאות חדשה; אינו משייך אותו לאף מספר
• לוג שינויים — רק פעולת שמור ופרסם (מתוך IVR Studio) נרשמת בלוג השינויים; פעולות מחיקה, שכפול, שמירת טיוטה ושינוי שם אינן נרשמות
• שיחות פעילות — עדכון ופרסום גרסה חדשה משפיע רק על שיחות חדשות; שיחות שכבר נכנסו ימשיכו לפי הגרסה הישנה עד לסיומן

ראו גם​

• IVR Studio — עורך ויזואלי
• הגדרות טלפוניה מתקדמות
• ניהול מספרי מסקיו
• לוג שינויים
• ניהול קבצי הקול

IVR Studio​

docs/ivr/ivr-studio.md

IVR Studio — עורך ויזואלי לתרחישי נתב שיחות​

IVR Studio (סטודיו לפיתוח IVR) הוא עורך ויזואלי מתקדם המאפשר לבנות תרחישי ניתוב שיחה מורכבים באמצעות גרירה ושחרור (drag & drop) של רכיבים מוכנים מראש — ללא צורך בכתיבת קוד.

באמצעות Studio ניתן לבנות תפריטי IVR רב-רמתיים, להגדיר תנאים, לקרוא נתונים ממערכות חיצוניות (webhooks), לשלוח הודעות, להקליט שיחות, ועוד — והכל מתוך ממשק גרפי יחיד.

גישה למסך​

1. בתפריט הראשי יש ללחוץ על נתב שיחות (IVR) ← ניהול נתבי שיחות
2. ללחוץ על צור IVR חדש כדי להתחיל מחדש, או על ערוך ליד IVR קיים
3. ייפתח מסך ה-IVR Studio

חלקי המסך​

• ארגז כלים (בצד הכלים) — רשימת כל הרכיבים הזמינים מקובצים לקטגוריות
• קנבס עריכה (מרכז המסך) — אזור הבנייה של התרחיש; גוררים לכאן רכיבים מארגז הכלים ומחברים אותם בקווי זרימה
• פאנל מאפיינים (בצד השני) — הגדרות של הרכיב הנבחר
• סרגל כלים עליון — כולל:
  • שם ה-IVR (ניתן לעריכה; לא ניתן לשמור שם שכבר קיים בנתב אחר — המערכת תציג שגיאה)
  • בוחר גרסאות היסטוריה
  • כפתור חדש ליצירת IVR נקי
  • כפתור שמור (שמירת טיוטה) וכפתור שמור ופרסם
  • כפתור הרץ דיבאג לסימולציית שיחה, וכפתור עצור דיבאג המופיע בזמן הרצת הדיבאג

הגדרות ברירת מחדל​

כל תרחיש מאפשר הגדרת ברירות מחדל שישמשו אם לא הוגדרו ערכים ספציפיים ברכיב:

• שפת ברירת מחדל — עברית / אנגלית / רוסית / ערבית
• קובץ השמעה על הקשה לא תקינה (invalid input)
• קובץ השמעה על חוסר תגובה (no response)
• קובץ השמעה לאחר מספר ניסיונות (too many attempts)
• מספר ניסיונות מקסימלי — 1 עד 10 (ברירת מחדל: 3)
• Caller ID לחיוג יוצא — המספר שיוצג למקבל השיחה; נבחר מרשימה: מספר המסקיו / מספר המחייג / אנונימי
• תיאור — שדה טקסט חופשי לתיאור זרימת ה-IVR (למשל: "תרחיש IVR ראשי לתמיכה")

רכיבים זמינים בארגז הכלים​

הרכיבים בארגז הכלים מקובצים לארבע קטגוריות: טלפוניה, תנאים, אינטגרציה ואחר.

טלפוניה​

לתפריט IVR אין ענף "ברירת מחדל" נפרד: לאחר מיצוי מספר הניסיונות המרבי (הקשה לא תקינה או חוסר תגובה), או אם המתקשר ביטל, השיחה ממשיכה ברצף התרחיש — ברכיב שאחרי צומת התפריט. בכל ניסיון לא תקין מושמע קובץ "הקשה לא תקינה" / "חוסר תגובה", ולאחר חריגה ממספר הניסיונות מושמע קובץ "מספר ניסיונות" והשיחה ממשיכה כאמור. ניתן גם לשמור את ההקשה שהתקבלה למשתנה.

רכיב "החלפת שפה" מחליף את השפה הפעילה לכל הרכיבים שאחריו. מרכיב זה והלאה, רכיב "נגן - קובץ" מוסיף סיומת _<שפה> לשם הקובץ — לדוגמה כשנבחרת אנגלית, welcome.wav יושמע כ-welcome_en.wav (אין תיקיות שפה — רק שם הקובץ משתנה). עברית היא שפת הבסיס ואינה מוסיפה סיומת _he. אם שם הקובץ כבר מסתיים ב-_he/_en/_ru/_ar הוא מושמע כפי שהוא. גם ה-TTS ברכיב "נגן - טקסט" עובר לשפה החדשה.

תנאים​

אינטגרציה​

אחר​

סוג הפעולה "ולידציה" ברכיב "פעולות במשתנים" בודק משתנה מקור לפי סוג: ת"ז ישראלית, טלפון נייח, נייד, תאריך (ddmmyyyy או mmyy), שעה (hhmm), וכרטיס אשראי (Luhn). התוצאה נשמרת כ-1 (תקין) או 0 (לא תקין) במשתנה היעד.

פעולת "מספר אקראי" מגרילה מספר שלם בטווח בין מינימום למקסימום שמגדירים, ושומרת אותו במשתנה היעד.

לכל תווית (Label) מוקצה צבע, ורכיבי "עבור אל" שמפנים אליה מקבלים מסגרת מקווקוות באותו צבע — כך קל לזהות ויזואלית לאן כל קפיצה מובילה. בעת בחירת יעד ברכיב "עבור אל" מוצג כפתור "הצג יעד" שמדגיש את התווית בקנבס. שינוי שם תווית מעדכן אוטומטית את כל רכיבי ה-GoTo שמפנים אליה. קיימת הגנה מפני לולאות אינסופיות.

משתני מערכת זמינים​

בכל רכיב שתומך בטקסט (כולל TTS, SMS, Email, Webhook) ניתן להשתמש במשתנים בסוגריים מסולסלים כפולים:

משתני המשתמש:

• {{Variable1}} – {{Variable10}} — 10 משתנים מותאמים אישית
• {{SystemRec1}} – {{SystemRec10}} — 10 הקלטות מערכת

משתני מערכת: (בבורר המשתנים הם מקובצים לקטגוריות "משתני שיחה" ו"משתני תאריך/שעה")

משתני שיחה:

• {{CALLERID}} — מספר המחייג
• {{MASKYOO}} — מספר המסקיו
• {{UNIQUEID}} — מזהה ייחודי של השיחה

משתני תאריך/שעה:

• {{DATE}}, {{TIME}}, {{TIMESTAMP}}, {{DATE_ISO}} — תאריך, שעה, חותמת זמן, ותאריך בפורמט ISO
• {{YEAR}}, {{MONTH}}, {{DAY}}, {{WEEKDAY}} — שנה, חודש, יום, ויום בשבוע
• {{HOUR}}, {{MINUTE}} — שעה ודקה

מצב דיבאג (סימולציית שיחה)​

כדי לבדוק תרחיש לפני פרסום:

1. יש ללחוץ על הרץ דיבאג בסרגל הכלים העליון
2. בעת הגעה לרכיב המבקש הקשה (תפריט IVR / קבלת DTMF) נפתח חייגן ויזואלי נגרר המדמה לחיצות. בחיוג יוצא מושמע צליל חיוג (ringback) מסונתז, וברכיב "תא קולי" מושמע צליל BEEP מסונתז לאחר הודעת הפתיחה — כהדמיה בלבד
3. ה-Studio יציג בזמן אמת:
   • הרכיב הפעיל כעת (מודגש בקנבס)
   • ערכי המשתנים בכל רגע
   • קבצי השמע המושמעים (סימולטיבי — ללא השמעה בפועל)
4. קונסול הדיבאג נפתח בלחיצה על כפתור ייעודי בסרגל הבקרה (במרכז-תחתית הקנבס) ומוצג בחלון נפרד. הקונסול תמיד באנגלית ובכיוון LTR (גם כשממשק ה-Studio בעברית), וכולל כפתור העתקה ללוח של כל יומן הריצה
5. ניתן להשהות את ההרצה באמצעות רכיב "הדפסה לקונסול": כשהמתג "השהה דיבאג בהתראה" דולק, ההרצה מושהית ומוצג ערך המשתנה, וניתן להמשיך אותה לאחר אישור המשתמש

שמירה ופרסום​

• שמור — שומר את השינויים כטיוטה אך לא מפעיל אותם על שיחות אמת; מועיל לעבודה מרובת-שלבים
• שמור ופרסם — שומר ומעביר את התרחיש למצב פעיל — השיחות החדשות יתחילו להשתמש בו מיד

היסטוריית גרסאות​

כל פרסום נשמר כגרסה נפרדת. ניתן לבחור גרסה היסטורית מהבוחר בסרגל הכלים כדי:

• לצפות בגרסה ישנה
• לטעון אותה לעריכה ולפרסם מחדש אם נדרש rollback

בהיסטוריה נשמרות עד 10 גרסאות; בפרסום גרסה נוספת מעבר למגבלה, הגרסה הישנה ביותר נמחקת.

קישור למספר מסקיו​

בסיום בניית התרחיש יש לשייך אותו למספר מסקיו:

1. לערוך את מספר המסקיו בניהול מספרים
2. בהגדרות טלפוניה מתקדמות לבחור את אלגוריתם החיוג נתב שיחות מתקדם (גרסת בטה)
3. לבחור את ה-IVR שנבנה מהרשימה
4. לשמור את השינויים

השפעות על המערכת​

פרסום תרחיש IVR חדש / עריכת תרחיש קיים משפיעים:

• מספרי מסקיו — כל מספר המוגדר עם אלגוריתם נתב שיחות מתקדם (גרסת בטה) ומשתמש בתרחיש הזה יתחיל לפעול לפיו מיד לאחר הפרסום
• רשימת שיחות (CDR) — רכיב "פרמטרים ל‑CDR" מוסיף זוגות key/value לשיחה, וייחשפו בדו״ח פירוט שיחות
• רשימה שחורה — רכיבי "בדיקת רשימה שחורה" ו"הוספה לרשימה שחורה" קוראים ומעדכנים ישירות את הרשימה השחורה של החשבון
• SMS / דוא״ל — רכיבי שליחה מייצרים הודעות יוצאות שנרשמות כהתראות ונספרות בדו״ח ההתראות
• קבצי שמע — רכיבי "נגן קובץ" תלויים בקבצים ב[ניהול קבצי קול]; מחיקת קובץ פעיל תגרום לכשל ברכיב
• אוטומציה — תוצאת השיחה (נענתה / תפוסה / כשל / הועברה) היא מה שמפעיל את אירועי האוטומציה המסוננים לאותו מספר
• הקלטות — רכיב "הקלטת שיחה" יוצר קובץ שמע שנשמר ומשויך ל‑CDR
• Webhooks / אינטגרציה — קריאות חיצוניות לשרתי צד שלישי משנות את מצב התרחיש בזמן ריצה בהתאם לתשובה

ראו גם​

• ניהול נתבי שיחות (IVR)
• הגדרות טלפוניה מתקדמות
• ניהול קבצי הקול
• ניהול רשימה שחורה
• דו״ח פירוט שיחות
• אירועי אוטומציה

משתמשים​

docs/users/index.mdx

משתמשים​

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

• ➕ הוספת משתמש — יצירת חשבון משתמש חדש עם הרשאות, תגיות ומספרים
  → ./add/create-new-user
• 👥 ניהול משתמשים — חיפוש, עריכה וניטרול משתמשים קיימים
  → ./manage/manage-users

ההגדרות האישיות של המשתמש המחובר (פרטים אישיים, סיסמה, ערכת עיצוב ודוחות אישיים) מנוהלות בעמוד הגדרת חשבון מסקיו — "הפרופיל שלי" שבפרק "תחילת עבודה". תהליך ההתחברות, האימות הדו-שלבי ושחזור הסיסמה מתוארים בעמוד כניסה למערכת והזדהות.

השפעות על המערכת​

משתמשים הם עמוד השדרה של בקרת הגישה בכל המערכת:

• מספרי מסקיו — כל משתמש שאינו מנהל מערכת (וללא הרשאת "גישה לכל המספרים") רואה רק את המספרים ששויכו אליו; שינוי שיוך משפיע מידית על מה שהמשתמש יראה בלוח הבקרה, בדוחות ובניהול המספרים
• דוחות — כל דו״ח נבנה עם סינון לפי רשימת המספרים הנגישים; הרשאה ספציפית מפעילה/מסתירה סוגי דוחות
• אוטומציה — ניתן לסנן אירועים לפי משתמש; הפעולות שולחות SMS/דוא״ל לכתובת המשתמש
• הרשאות תפעוליות — ניתן להעניק הרשאות תפעוליות ממוקדות (נתבי שיחות, אוטומציות, קבצי שמע, רשימה שחורה, קריאות שירות, תוספים) למשתמשים שאינם מנהלי מערכת, באמצעות תבנית "מנהל תפעולי" או סימון פרטני בעץ ההרשאות
• API — טוקן ה‑REST API הוא ברמת החשבון (הפלטפורמה) ואינו משויך למשתמש מסוים; מחיקת משתמש אינה משפיעה עליו. הטוקן נשאר בתוקף עד לפקיעתו או עד להנפקתו מחדש בהגדרות המערכת
• 2FA והגבלת IP — מופעלים ברמת המשתמש; חסימת IP תחסום כל ניסיון כניסה מחוץ לרשימה
• לוג גישה + לוג שינויים — כל פעולת התחברות או עריכה נרשמת עם שם המשתמש
• "השתלט" — מנהל יכול לבצע פעולות כמשתמש אחר; הפעולות נרשמות בשם אותו משתמש

ראו גם​

• יצירת משתמש חדש
• ניהול משתמשים
• הגדרת חשבון מסקיו (הפרופיל שלי)
• כניסה למערכת והזדהות
• הגדרות מערכת כלליות
• לוג גישה
• לוג שינויים
• ניהול מספרי מסקיו

יצירת משתמש חדש​

docs/users/add/create-new-user.md

יצירת משתמש חדש​

כדי ליצור משתמש חדש, יש לגשת בתפריט הראשי למשתמשים ← הוסף משתמש.

ניתן לעבור בין חמש לשוניות אשר כל אחת אחראית על הגדרות אחרות:

חשבון​

לשונית זו מגדירה הגדרות בסיסיות של החשבון:

• שם משתמש (חשבון דוא"ל) - שם המשתמש איתו ייכנס המשתמש למערכת. חייב להיות בפורמט של דוא"ל.
• סיסמא - סיסמא שקובע מנהל המערכת, אותה ניתן לשנות בכל עת. הסיסמה חייבת לעמוד במדיניות הסיסמאות המוגדרת בהגדרות המערכת (אורך מינימלי ודרישות מורכבות).
• כינוי משתמש - שם המשתמש שיופיע ברשימת המשתמשים. אם משאירים את השדה ריק, הכינוי נגזר אוטומטית מכתובת הדוא"ל (החלק שלפני ה-@).
• טלפון המשתמש - אופציונלי
• טלפון SMS - אופציונלי עבור משתמש רגיל. עבור משתמש המסומן כמנהל מערכת השדה הופך לחובה, ויש להזין בו מספר המסוגל לקבל הודעות SMS.
• אזור זמן, פורמט תאריך, פורמט שעה ושפת מערכת - בברירת המחדל שדות אלו כבר מוגדרים לפי אזור זמן של ישראל ובשפה העברית. בשדה פורמט שעה בוחרים כיצד תוצג השעה במערכת עבור המשתמש: תצוגת 24 שעות או תצוגת AM/PM, עם או בלי שניות. אין צורך לשנות שדות אלו, אלא אם המשתמש רוצה הגדרות אחרות.
• משתמש פעיל כן/לא - מסומן ב-V, מה שאומר שהמשתמש פעיל. ניתן לשנות הגדרה זו ולהקפיא את המשתמש בכל עת.

הרשאות​

ניתן להגדיר אילו הרשאות יקבל המשתמש למערכת:

הרשאות כלליות מובנות​

ניתן לבחור מבין ארבע תבניות הרשאה מובנות:

• משתמש דוחות - משתמש דוחות יוכל להיכנס ולצפות אך ורק בדוחות המערכת ובלוח הבקרה. הוא לא יוכל לצפות ולנהל מספרים, משתמשים, אוטומציות והתראות או כל הגדרה נוספת. יש לשייך למשתמש מסוג זה את המספרים הרלוונטיים עבורו לצפייה.
• מנהל מספרים - צפייה בדוחות, ניהול והוספת מספרי מסקיו, וניהול תגיות אישיות. אינו רואה אוטומטית את כל מספרי המערכת אלא רק את המספרים ששויכו אליו, ואינו מנהל מערכת.
• מנהל תפעולי - הרשאות תפעול מתקדמות מעבר ל"מנהל מספרים", אך מבלי להיות מנהל מערכת מלא. כולל ניהול נתבי שיחות (IVR), ניהול אוטומציות, ניהול קבצי שמע, ניהול רשימה שחורה, פתיחה וצפייה בקריאות שירות, וניהול תוספים — בנוסף לגישה לכל המספרים, ניהול מספרים, תגיות ודוחות.
• מנהל מערכת - גישה מלאה לכל התכונות: ניהול והוספת מספרים, צפייה בדוחות, הוספה ועריכה של כללים, אוטומציות, נתבי שיחות, משתמשים, ושינוי הגדרות מערכת.

הרשאות ספציפיות​

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

עץ ההרשאות הספציפיות מסודר לפי סדר התפריט הראשי: לוח בקרה, דוחות, מספרי מסקיו, ניהול אוטומציות, ניהול IVR, ניהול תוספים, תגיות, ולאחריהם קבוצת "ניהול מערכת" (ניהול רשימה שחורה, ניהול קבצי שמע, פתיחה וצפייה בקריאות שירות). כל ענף ניתן לסימון נפרד כדי לבנות הרשאות בהתאמה אישית.

תחת קבוצת "תגיות" קיימת אפשרות לאפשר למשתמש שאינו מנהל מערכת לנהל את מאגר התגיות הגלובלי (תגיות המשותפות לכל המשתמשים), ולא רק את התגיות האישיות שלו.

בנוסף, בחלקו העליון של עץ ההרשאות קיימת הרשאה עצמאית "ייצוא נתונים לקובץ", הקובעת האם המשתמש רשאי לייצא דוחות ונתונים לקובץ. עבור משתמש חדש הרשאה זו כבויה כברירת מחדל — כדי לאפשר למשתמש לייצא, יש לסמן אותה במפורש.

מספרי טלפון המוקצים למשתמש​

לשונית זו אינה רלוונטית עבור משתמש שהוא מנהל מערכת או מנהל תפעולי, כי הם יכולים לראות את כל המספרים בכל מקרה.

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

יש לבחור את המספרים הרלוונטיים בחלונית השמאלית וללחוץ על .

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

הגדרות אבטחה​

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

• כניסה דו שלבית - הכניסה הדו-שלבית מחויבת עבור כל משתמשי המערכת, ולכן התיבה מסומנת ונעולה ולא ניתן לבטלה. שיטת האימות אחידה לכל החשבון ונקבעת בשדה "סוג כניסה דו-שלבית" שבלשונית הגדרות האבטחה בהגדרות המערכת: קוד בן שש ספרות הנשלח בדוא"ל (ברירת המחדל), קוד הנשלח ב-SMS, שילוב של שניהם, או אפליקציית אימות כדוגמת Google Authenticator — שבה בכניסה הראשונה מוצג למשתמש ברקוד (QR) לסריקה באפליקציה, ולאחר מכן הוא מזין בכל התחברות את הקוד מהאפליקציה. פירוט מלא של תהליך ההתחברות מופיע בעמוד כניסה למערכת והזדהות.
• הגבלת גישת משתמש לכתובות IP - ניתן להזין כתובות IP ספציפיות שרק מהן יוכל המשתמש/ים להיכנס למערכת. כל ניסיון התחברות מכתובת IP שאינה מוגדרת לא יתאפשר.

שליחת דוחות בדוא"ל​

בחלק זה ניתן להגדיר דוחות אוטומטיים קבועים שיישלחו למשתמש ברמה היומית, השבועית והחודשית. מדובר על דוחות מובנים של מסקיו.

הדוחות יישלחו בסוף יום לכתובת הדוא"ל שהוגדרה בשם המשתמש.

דוגמא מהדוח:

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

שליחת הדוחות לכתובת דוא"ל נוספות​

ניתן להוסיף כתובות דוא"ל נוספות שיקבלו את הדוחות האוטומטיים.

לאחר שהוגדרו ההגדרות הרצויות וסומנו הדוחות שיישלחו למשתמש, יש ללחוץ על שמור.

בדיקת תקינות​

ניתן לבצע בדיקה האם המשתמש הוגדר באופן תקין ורצוי לפני שנעביר לו את פרטי הגישה.

1. בניהול המשתמשים, יש למצוא את שורת המשתמש שהקמנו, ובעמודת פעולות יש ללחוץ על השתלט:

2. כעת נתחבר למערכת בשמו של אותו משתמש ונוכל לראות מה הוא רואה כשהוא נכנס למערכת, כך נוודא שיש לו גישה רק לממשקים הרצויים.

3. לאחר 'השתלט' מוצג בראש המסך פס התראה ("צופה כמשתמש: ... מחובר כ: ...") עם כפתור "חזור לחשבון שלי". משסיימנו את הבדיקה, יש ללחוץ עליו כדי לחזור מיד לחשבון המקורי — אין צורך להתנתק ולהתחבר מחדש.

השפעות על המערכת​

יצירת משתמש חדש משפיעה מידית על מספר תחומים במערכת:

• הרשאות — התבנית הנבחרת (משתמש דוחות / מנהל מספרים / מנהל תפעולי / מנהל מערכת) קובעת אילו מסכים יהיו נגישים; ניתן לשנות בכל עת בעריכה
• שיוך למספרים — לשונית "מספרים המוקצים" קובעת מה המשתמש רואה בדוחות, לוח הבקרה וניהול המספרים; אינה רלוונטית למנהל מערכת שרואה הכל
• כניסה דו‑שלבית (2FA) — מחויבת עבור כל המשתמשים; בכל התחברות נדרש קוד אימות לפי השיטה שנקבעה בהגדרות המערכת (דוא"ל, SMS או אפליקציית אימות)
• הגבלת IP — רשימת IP‑ים מוגדרת חוסמת כניסה מכל מקום אחר; מתנהלת בעת ניסיון הכניסה
• דוחות אוטומטיים למייל — ההגדרה יוצרת דוחות מתוזמנים שנשלחים למשתמש באופן אוטומטי ברמה היומית/שבועית/חודשית
• טלפון SMS — מספר זה הוא היעד של אירועי אוטומציה מסוג SMS לכתובת המשתמש
• "השתלט" — מנהל יוכל להתחבר כמשתמש; פעולות שיבצע בזמן ההשתלטות יירשמו בלוג השינויים בשם המשתמש שעליו השתלט, ולא בשם המנהל

ראו גם​

• ניהול משתמשים
• כניסה למערכת והזדהות
• דוחות מתוזמנים
• אירועי אוטומציה
• ניהול מספרי מסקיו
• הגדרות מערכת

ניהול משתמשים​

docs/users/manage/manage-users.md

ניהול משתמשים​

כדי לצפות במשתמשים קיימים ולערוך הגדרות שהוגדרו עבורם, יש ללחוץ על משתמשים ← ניהול משתמשים.

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

חיפוש וסינון​

• חיפוש טקסט חופשי — חיפוש לפי כינוי המשתמש, כתובת הדוא"ל, טלפון המשתמש וטלפון ה-SMS (וכן לפי כתובות דוא"ל נוספות שהוגדרו לקבלת דוחות).
• מצב המשתמש — סינון הרשימה לפי סטטוס: הכל / פעיל / מושהה.

בין עמודות הרשימה: שם המשתמש, כתובת הדוא"ל, סטטוס, כמות המספרים שהוקצו למשתמש, טלפון, טלפון SMS, תאריך הכניסה האחרונה (לצד סטטוס הכניסה וכתובת ה-IP שלה), תאריך ההרשמה, ועמודת פעולות (עריכה, מחיקה והשתלטות).

תכונות נוספות​

השתלט​

יש אפשרות ללחוץ על השתלט ואז מתבצעת כניסה אוטומטית לחשבון המשתמש, כך שניתן לראות את מה שהמשתמש רואה ולוודא שההגדרות עבורו הוגדרו כיאה. לאורך כל זמן ה'השתלט' מוצג פס התראה קבוע בראש כל מסך עם שם המשתמש שצופים בו ושם המנהל המקורי, וכפתור "חזור לחשבון שלי" לסיום מיידי.

צפייה בדוחות אוטומטיים​

עבור משתמש קיים, ניתן לצפות בדוגמא של הדוח האוטומטי (יומי/שבועי/חודשי) שיישלח אליו. יש ללכת לעריכת המשתמש, ללשונית שליחת דוחות בדוא"ל וללחוץ על .

שליחה יזומה של דוחות​

במידה ורוצים לשלוח את הדוח האחרון שנשלח למשתמש, יש ללכת לעריכת המשתמש, ללשונית שליחת דוחות בדוא"ל וללחוץ על כפתור "שלח בדוא"ל" .

שכפול משתמש​

כדי להקים משתמש חדש עם אותן הגדרות של משתמש קיים, יש להיכנס למסך העריכה של המשתמש הקיים, ללחוץ על תפריט "פעולות נוספות" ולבחור "שכפל". בחלונית שתיפתח מזינים כתובת דוא"ל (שאינה קיימת במערכת) וסיסמה עבור המשתמש החדש.

המערכת יוצרת משתמש חדש ומעתיקה אליו מהמשתמש המקורי את ההרשאות, את שיוך המספרים, את התגיות ואת הגדרות שליחת הדוחות בדוא"ל, וכן את ההעדפות האישיות (אזור זמן, שפה וכדומה). כינוי המשתמש החדש נגזר אוטומטית מכתובת הדוא"ל שהוזנה. בסיום מוצגת הודעת הצלחה, ועם סגירתה עוברים אוטומטית למסך העריכה של המשתמש החדש.

השפעות על המערכת​

ניהול המשתמשים משפיע ישירות על גישה, אבטחה וזרימת התראות:

• ניטרול משתמש — הופכת את המשתמש ללא פעיל, חוסמת התחברות ומבטלת שליחת דוחות אוטומטיים; רשומות היסטוריות נשמרות
• מחיקה — הסרת המשתמש מסירה גם את שיוכיו למספרים; דוחות שהסתמכו על המשתמש כנמען מפסיקים להישלח אליו. המחיקה חסומה עבור המשתמש שאיתו מחוברים כעת ועבור המשתמש היחיד במערכת — עבורם לא מוצגת פעולת מחיקה
• "השתלט" — מעבירה מידית לסשן של המשתמש הנבחר; כל פעולה שתבוצע תיחשב כפעולה של אותו משתמש בלוג השינויים
• שינוי הרשאות — תוקף מיידי בטעינת הדף הבאה; משתמש מחובר יתעדכן בלי צורך בהתנתקות
• חידוש סיסמה על ידי מנהל — מבטל את הסיסמה הישנה; הגדרות הכניסה הדו-שלבית של המשתמש נשמרות (לא מתאפסות)
• שיוך למספרים — עדכון רשימת המספרים שמשתמש רואה משפיע על סינון הדוחות ולוח הבקרה בזמן אמת
• לוג שינויים — כל פעולה (יצירה, עריכה, ניטרול, מחיקה) נרשמת עם משתמש מבצע

ראו גם​

• יצירת משתמש חדש
• לוג גישה
• לוג שינויים
• הגדרות מערכת
• API Token

הגדרות מערכת​

docs/system-settings/index.mdx

הגדרות מערכת​

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

• ⚙️ הגדרות — זהות הארגון, מיתוג, הגדרות כלליות
  → ./general
• 🏷️ ניהול תגיות — ארגון מספרים ומשתמשים לקבוצות לוגיות
  → ./manage-tags
• 🎵 ניהול קבצי קול — ספריית הברכות והודעות קוליות של הארגון
  → ./manage-sound-files
• 🚫 ניהול רשימה שחורה — חסימת מספרי מחייג ברמת הארגון
  → ./manage-blacklist
• 📜 יומן כניסות למערכת — מעקב אחר גישות משתמשים
  → ./access-log
• 🔐 הסרת מידע שיווקי (GDPR) — איפוס נתוני מחייג לפי בקשה
  → ./gdpr-client-marketing-data-cleaner
• 📝 יומן שינויים — רישום כל הפעולות והשינויים במערכת
  → ./changes-log

השפעות על המערכת​

הגדרות המערכת משפיעות באופן רוחבי על כל מסכי המערכת ועל התנהגות כלל הארגון:

• מדיניות אבטחה — מדיניות סיסמאות, אימות דו‑שלבי והגבלות IP קובעות מי יוכל להתחבר למערכת ואיך יבוצעו הכניסות ברמת כל המשתמשים.
• זהות בתקשורת יוצאת — שם שולח ה‑SMS וכתובת שולח הדוא״ל משפיעים על כל ההודעות שיוצאות מאירועי אוטומציה ומדוחות מתוזמנים.
• אזור זמן ופורמט תאריך — משפיעים על תצוגת הזמנים בכל הדוחות, בלוח הבקרה וב‑CDR של השיחות.
• תגיות וקבצי קול — משמשים בניהול המספרים, ב‑IVR ובאירועי אוטומציה; שינוי או מחיקה מחייב בדיקה בכל השימושים.
• מחיקה אוטומטית — קובעת כמה זמן נשמרים נתוני השיחות, ההתראות ונתוני תוספי גוגל; פועלת מדי יום וכוללת נתונים תפעוליים.
• GDPR ויומני מערכת — מאפשרים עמידה ברגולציה וניטור אבטחה של פעולות משתמשים.

ראו גם​

• הגדרות כלליות
• ניהול תגיות
• ניהול קבצי קול
• ניהול רשימה שחורה
• יומן כניסות למערכת
• הסרת מידע שיווקי (GDPR)
• יומן שינויים

הגדרות​

docs/system-settings/system-settings.md

הגדרות​

הגדרות כלליות​

זהות ארגונית​

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

פרטי הזדהות בתקשורת יוצאת​

• הגדרת כתובת שולח הדוא"ל - כתובת הדוא"ל שתופיע ככתובת השולח להתראות ודוחות אוטומטיים מהמערכת.
• הגדרת שם שולח הדוא"ל - ניתן להזין שם שולח שיופיע כשולח הדוא"ל.

מספר שולח הודעות ה-SMS אינו מוגדר בלשונית זו — ראו סעיף שולח SMS (ניהול מספרי שולח מורשים) בהמשך עמוד זה.

הגדרות אבטחה​

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

מדיניות סיסמאות משתמשים​

דרישות מרכיבי הסיסמה קבועות במערכת ואינן ניתנות לעריכה: כל סיסמה חייבת לכלול אות אנגלית קטנה, אות גדולה, ספרה אחת וסימן מיוחד, ולהכיל לפחות 8 תווים. במסך מוצגת הודעת מידע על דרישות אלו.

ניתן עדיין לקבוע:

• מניעת שימוש חוזר בסיסמאות ישנות - כמות הסיסמאות האחרונות שיישמרו ושלא ניתן יהיה לחזור עליהן (1–5).
• חיוב החלפת סיסמה - חיוב המשתמשים להחליף סיסמה בתדירות קבועה (7–365 ימים).

אבטחת חשבון משתמש​

• הצגת קוד אימות בתמונה (CAPTCHA) לאחר מספר ניסיונות התחברות - לאחר מספר ניסיונות כניסה כושלים (3–15), דף ההתחברות ידרוש בנוסף פענוח של קוד אימות בתמונה.
• נטרול משתמש לאחר מספר ניסיונות התחברות כושלים - ניתן להפעיל נעילת חשבון לאחר מספר ניסיונות כניסה כושלים (3–20). כאשר האפשרות מופעלת, נפתח שדה אימייל לדיווח על ניטרול משתמש, שאליו תישלח התראה על כל חשבון שנוטרל.
• נטרול חשבון לאחר ימים ללא פעילות - חשבון משתמש שלא התחבר למערכת במשך התקופה שהוגדרה (7–365 ימים) ינוטרל אוטומטית.
• ניתוק משתמש לא פעיל - משתמש מחובר שאינו מבצע פעולות ינותק מהמערכת אוטומטית בתום פרק הזמן שהוגדר (5–720 דקות).

הגדרות גישה למערכת​

• סוג כניסה דו-שלבית - כאשר האימות הדו-שלבי מופעל, כל כניסה למערכת מחייבת גם הזנת קוד חד-פעמי בן שש ספרות, בנוסף לסיסמת המשתמש. ניתן לבחור את אופן קבלת הקוד מבין ארבע שיטות:
  • דוא"ל (ברירת המחדל) - הקוד נשלח לכתובת הדוא"ל של המשתמש.
  • Google - הקוד מופק באפליקציית Google Authenticator; בכניסה הראשונה מוצג ברקוד (QR) לצימוד האפליקציה.
  • SMS - הקוד נשלח בהודעת SMS למספר הטלפון הנייד של המשתמש.
  • SMS/דוא"ל - הקוד נשלח גם בהודעת SMS (כאשר מוגדר למשתמש מספר נייד) וגם לדוא"ל.

כתובות IP מורשות לגישה למערכת​

אפשרות להגביל גישה כוללת למערכת, אלא רק מכתובות IP ספציפיות. כאשר הרשימה ריקה, ניתן לגשת למערכת מכל כתובת IP.

הגדרות זמן ותאריך​

• אזור זמן - אזור זמן מוגדר על ישראל בברירת המחדל, ניתן לשנות זאת בשדה זה.
• פורמט תאריך - פורמט התאריך מוגדר על מבנה תאריך בפורמט ישראלי, ניתן לשנות זאת לפורמט תאריך אחר.
• יום תחילת שבוע - ניתן לבחור ביום שני כיום תחילת השבוע (רלוונטי למי שעובד משני עד שבת ויום המנוחה הוא ראשון)
• פורמט שעה - ניתן לבחור מבין ארבע תצוגות: 24 שעות עם שניות (00:00:00), 12 שעות עם שניות (12:00:00 AM), 24 שעות ללא שניות (00:00) ו-12 שעות ללא שניות (12:00 AM)
• שפת מערכת - מוגדרת על עברית בברירת המחדל, אלא אם יוגדר אחרת.

הגדרות מחיקה אוטומטית​

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

מדי יום המערכת תבצע מחיקה אוטומטית של המידע אודות: השיחות, ההתראות ותוספי גוגל.

מחיקה זו מתבצעת בהתאם לתקופת השמירה שתגדירו:

• פעיל/לא פעיל - מתג ההפעלה של המחיקה האוטומטית. כאשר האפשרות אינה פעילה, לא יימחקו רשומות.
• אבקש לשמור מידע רק לתקופה של ... (ימים) - תקופת השמירה בימים (60–9999). לא ניתן למחוק רשומות מ-60 הימים האחרונים.

פעולת מחיקת המידע תתחיל במהלך 24 השעות שלאחר שינוי ההגדרה. המידע שנמחק אינו ניתן לשחזור.

לחלופין, ניתן למסך פרטים מזהים בנתונים ישנים במקום למחוק את הרשומות — ראו הגדרות ריטוש אוטומטית בהמשך.

הגדרות ריטוש אוטומטית​

בנוסף למחיקה האוטומטית, המערכת מאפשרת ריטוש אוטומטי — מיסוך של פרטים מזהים בנתונים ישנים, להבדיל ממחיקת הרשומות עצמן: הרשומות נשארות במערכת לצורכי דוחות וסטטיסטיקה, אך מספרי הטלפון של המתקשרים ופרטים מזהים נוספים ממוסכים ואינם ניתנים לזיהוי.

דוגמה לריטוש:

מדי יום המערכת תבצע ריטוש אוטומטי של המידע אודות השיחות וההתראות, בהתאם לתקופת השמירה שתגדירו:

• פעיל/לא פעיל - מתג ההפעלה של הריטוש האוטומטי. כאשר האפשרות אינה פעילה, לא ירוטשו רשומות.
• אבקש לשמור מידע רק לתקופה של ... (ימים) ללא ריטוש - תקופת השמירה בימים (1–9999). לא ניתן לרטש רשומות מהיום האחרון.

פעולת ריטוש המידע תתחיל במהלך 24 השעות שלאחר שינוי ההגדרה. המידע שרוטש אינו ניתן לשחזור.

בדומה למחיקה האוטומטית, שינוי ערך תקופת השמירה מחייב אישור בחלון עם קוד אימות בתמונה (קפצ'ה) בעת השמירה.

הגדרות API​

מערכת מסקיו מאפשרת לבצע את רוב פעולות המערכת באמצעות API.

על מנת לאפשר אופציות אלו, הינך נדרש/ת לבצע תהליך זיהוי כפול הכולל:

1. כתובות IP מורשות לגישה ל-API - פניות מכתובות IP המוגדרות מראש במערכת. רק כתובות IP ברשימה יוכלו לגשת לשירותי ה-API.
2. קוד גישה לממשקי API - הזדהות באמצעות טוקן המוגדר מראש במערכת. ללא הטוקן כחלק מהקריאה, הקריאה לא תתבצע.

חידוש קוד הגישה (טוקן)​

החלפת הטוקן מתבצעת בתהליך דו-שלבי:

1. חידוש קוד גישה - לחיצה על כפתור החידוש שלצד השדה מייצרת טוקן חדש וממלאת אותו בשדה בלבד — בשלב זה הטוקן החדש עדיין אינו בתוקף.
2. שמירה - הטוקן החדש נכנס לתוקף רק לאחר לחיצה על שמור. לאחר ההחלפה יש לעדכן את המערכות המשתמשות בטוקן, ולשמור על הטוקן בסודיות.

קישור העתק טוקן שמתחת לשדה מעתיק את הטוקן ללוח (Clipboard).

תיעוד API מלא ניתן לעיונך בתיעוד API.

הגדרות ברירות מחדל​

בחלק זה ניתן להגדיר הגדרות ברירת מחדל שיחולו על כל המספרים העתידיים (כאלה שטרם נוספו למערכת). כל ההגדרות שיוגדרו כאן יחולו על כל מספר חדש שיתווסף למערכת.

בהגדרות ברירת המחדל ניתן לקבוע:

ברירות מחדל להגדרות טלפוניה מתקדמות​

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

ברירות מחדל לקבצי השמע​

• פתיח קצר למחייג השיחה - בחירת הפתיח הקולי למחייג
• מנגינת צליל חיוג - צליל ההמתנה למענה
• פתיח קצר למקבל השיחה - בחירת קובץ השמעה למקבל השיחה

ברירות מחדל להקלטת שיחות​

סעיף זה מוצג רק כאשר הקלטת שיחות מופעלת בחשבון.

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

שמות שדות פרטיים​

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

לדוגמא - את שם שדה פרטי 1 נשנה ל-מספר לקוח, את שם שדה פרטי 2 נשנה ל-שם לקוח וכדומה.

ספי אחוז מענה​

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

• רמת אזהרה - אחוז מענה מתחת לסף זה (ברירת מחדל 70%) נצבע בצהוב.
• רמת קריטי - אחוז מענה מתחת לסף זה (ברירת מחדל 50%) נצבע באדום.

שורות עם אחוז מענה מתחת לסף הרלוונטי נצבעות בהתאם, כדי להבליט ביצועים חריגים.

דוחות וטבלאות​

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

שולח SMS (ניהול מספרי שולח מורשים)​

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

• מספר שולח הודעות SMS - בחירת המספר או השם שממנו המערכת תשלח הודעות SMS (אימות דו-שלבי והתראות מערכת). ניתן לבחור אך ורק שולח שאושר ברשימת השולחים המורשים.

הוספת שולח טקסטואלי​

בהתאם להנחיות משרד התקשורת, ניתן להזדהות בשדה השולח באמצעות מזהה טקסטואלי באורך 3–11 תווים. שדה השולח:

• יכול להכיל אותיות באנגלית (A–Z, a–z), ספרות, קו תחתון (_) ומקף (-) — ללא רווחים.
• אינו יכול להתחיל בספרה, ועליו לכלול לפחות 3 אותיות באנגלית.

בנוסף ניתן להזין הערות ותיאור (לשימוש פנימי). בסיום יש ללחוץ על הוסף, והשולח יתווסף לטבלת השולחים המורשים.

הוספת שולח בזיהוי מספר טלפון​

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

1. יש להזין את המספר בשדה מספר טלפון לאישור.
2. יש ללחוץ על שלחו לי סיסמה לאימות ולבחור את אופן הקבלה — סיסמה בהודעות SMS או סיסמה בשיחה טלפונית.
3. יש להזין את הקוד בן 6 הספרות שהתקבל בשדה שנפתח, וללחוץ על הוסף.

אם הסיסמה לא התקבלה, ניתן לשלוח אותה שוב בתום ספירה לאחור של 60 שניות.

טבלת השולחים המורשים​

בתחתית הלשונית מוצגת טבלה של כל השולחים שאושרו בחשבון, עם העמודות: שדה השולח, סטטוס, הערות, תאריך ושעת הוספה ופעולות. לחיצה על מחק בשורת שולח (בצירוף אישור) מסירה אותו מרשימת השולחים המורשים.

השפעות על המערכת​

ההגדרות הכלליות קובעות את ההתנהגות הבסיסית של המערכת כולה:

• זהות ארגונית — שם הארגון והלוגו מופיעים בכל הדוחות המופקים ובדף ההתחברות; שינוי משפיע מיד על כל המשתמשים.
• מדיניות סיסמאות ו‑2FA — חלים על כל משתמשי המערכת; דרישות מרכיבי הסיסמה (אות קטנה, אות גדולה, ספרה וסימן מיוחד, לפחות 8 תווים — ולפחות 12 תווים בהחלפת סיסמה עצמית) קבועות. קביעת מועד לחיוב החלפת סיסמה תכפה על משתמשים קיימים להחליף סיסמה בכניסה הבאה.
• שולח SMS ודוא״ל — ברירת המחדל לכל אירועי אוטומציה שמפיקים הודעות ולכל הדוחות המתוזמנים.
• מחיקה אוטומטית — משפיעה על נתוני CDR, ההתראות ותוספי גוגל; נתונים שנמחקו לא ניתנים לשחזור ולא יופיעו בדוחות היסטוריים.
• ריטוש אוטומטי — ממסך פרטים מזהים בנתוני השיחות וההתראות בתום התקופה שהוגדרה; הרשומות נשמרות לדוחות, אך המידע שרוטש אינו ניתן לשחזור.
• ברירות מחדל למספרים חדשים — כל מספר מסקיו חדש יקבל את ההגדרות שבוחרים כאן (אלגוריתם חיוג, קבצי שמע, אחוז הקלטה).
• הרשאות API — IP מורשה וטוקן קובעים מי יכול להפעיל את ממשקי ה‑API; ללא הגדרה תקינה, שיחות API חיצוניות יידחו.

ראו גם​

• הגדרות מערכת
• ניהול משתמשים
• תיעוד API
• ניהול מספרים
• אוטומציה
• יומן שינויים

ניהול תגיות​

docs/system-settings/manage-tags.md

ניהול תגיות​

בחלק זה ניתן ליצור ולנהל תגיות.

הוספת תגית​

כדי להוסיף תגית חדשה, יש ללחוץ על . כעת תיפתח תיבה בה ניתן להזין את שם התגית:

חיפוש תגית​

ניתן להזין בחיפוש טקסט חופשי את שם התגית הרצויה וללחוץ על חיפוש.

עריכת שם תגית​

ניתן לערוך מחדש את שם התגית על ידי לחיצה על ערוך ושינוי השם.

ניהול תגית (ניהול מספרים המשויכים לתגית)​

כדי לשייך או להסיר מספרים מהתגית יש ללחוץ על נהל תגיות ובמסך שנפתח יש להעביר מספרים מהחלונית השמאלית לימנית כדי לשייכם לתגית. במידה ורוצים להסיר מספר מהתגית, יש ללחוץ על הסר בחלונית הימנית.

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

שורה של מספר שנמחק נשמרת בתגית לצורכי דוחות, ומסומנת בסימן אזהרה (אייקון משולש).

מחיקת תגית​

כדי למחוק תגית, יש ללחוץ על מחק בשורת התגית. יוצג חלון אישור עם שם התגית למחיקה.

אם לתגית משויכים חוקי אוטומציה (התראות), החלון יציג שאלה נוספת — מה לעשות עם החוקים לאחר מחיקת התגית — עם בחירה בין שתי אפשרויות:

• מחק (ברירת המחדל) — חוקי האוטומציה המשויכים יימחקו יחד עם התגית.
• נטרל — החוקים יישארו במערכת אך יושבתו וינותקו מהתגית.

מחיקת התגית מסירה גם את שיוכי המספרים אליה; המספרים עצמם אינם נמחקים.

השפעות על המערכת​

תגיות הן מנגנון לוגי לקיבוץ מספרים ומשפיעות על מספר אזורים במערכת:

• ניהול המספרים — מספר מסקיו יכול לשאת מספר תגיות במקביל; התגיות משמשות כפילטר בטבלת המספרים וכקיבוץ לוגי בהצגות.
• אוטומציה — ניתן להפעיל אירועי אוטומציה רק על מספרים הנושאים תגית מסוימת, במקום להגדיר אירוע נפרד לכל מספר.
• דוחות — דוחות לפי תגית וגרפים של מגמות לפי תגיות מתבססים ישירות על השיוכים המוגדרים כאן.
• הרשאות משתמשים — ניתן להגביל משתמש לגישה למספרים מתויגים בלבד, כך ששינוי תגית משפיע על מה שהמשתמש יראה.
• מחיקת תגית — מסירה את השיוכים (לא מוחקת את המספרים עצמם); חוקי אוטומציה המשויכים לתגית יימחקו או יושבתו בהתאם לבחירה בחלון המחיקה, ודוחות המסתמכים על התגית יושפעו.

ראו גם​

• ניהול מספרים
• יצירת אירוע אוטומציה
• דוחות
• ניהול משתמשים
• הגדרות מערכת

ניהול קבצי קול​

docs/system-settings/manage-sound-files.md

ניהול קבצי קול​

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

כאן תוכלו לטעון ולהקליט קבצי קול חדשים, להאזין ולמחוק קבצי קול קיימים.

רשימת קבצי קול​

לשונית של רשימת קבצי הקול מציגה את כל קבצי הקול הקיימים במערכת. בפועל מוצגות שתי טבלאות: קבצי מערכת — הקבצים שהעליתם או הקלטתם בעצמכם, וברירת מחדל של מערכת קבצים — קבצי המערכת המובְנים.

כל שורה כוללת מזהה (ID), תאריך ושעת העלאה ומשך הקובץ. קובץ חדש מסומן בהדגשה צבעונית כדי לאתרו בקלות.

לכל קובץ קול, בשתי הטבלאות, קיימות שלוש פעולות שורה: השמעה (האזנה והורדה), שינוי שם ומחיקה.

בלחיצה על שינוי שם נפתח חלון להזנת שם חדש (אותיות באנגלית, ספרות, קו תחתון _ או מקף - בלבד).

אולפן הקלטות טלפוני​

לשונית זו מאפשרת להקליט קובץ קול דרך הטלפון, שיעלה באופן אוטומטי למערכת מסקיו.

יש להזין מספר טלפון להקלטות ואז ללחוץ על כפתור חייג והקלט אותי.

בהצלחה מוצגת ההודעה "השיחה מתבצעת — הטלפון שלך אמור לצלצל בקרוב", וכאשר החיוג נכשל מוצגת הודעת שגיאה ברורה.

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

אולפן הקלטות אינטרנטי​

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

לתחילת ההקלטה יש ללחוץ על כפתור ההקלטה. בזמן ההקלטה מוצגת תצוגת גלי קול חיה שמשקפת את עוצמת הקול הנקלט, וניתן להשתמש בכפתורי השהיה (Pause) והשתקה (Mute).

עם סיום ההקלטה נפתח עורך עם ציר זמן המאפשר לקצץ את נקודת ההתחלה והסיום של הקטע, לצד נגן להאזנה. לאחר הקיצוץ מתבצע שלב שמירה נפרד שבו נפתח דיאלוג להזנת שם, עם שם ברירת מחדל אוטומטי.

העלאת קבצי קול​

ניתן לטעון קבצי קול מהמחשב למערכת. יש ללחוץ על צרף קובץ ולבחור את הקובץ הרצוי. מיד לאחר מכן, הקובץ שהועלה יופיע ברשימת קבצי הקול.

שימו לב: שם הקובץ חייב להיות באותיות אנגליות, ספרות, קו תחתון (_) או מקף (-) בלבד.

בהעלאת קובץ ששמו כבר קיים במערכת מוצגת בקשת אישור דריסה (Overwrite) של הקובץ הקיים.

אולפן קול ממוחשב (Text to Speech)​

לשונית זו מאפשרת לייצר קובץ קול ישירות מטקסט, ללא הקלטה עצמית ואף ללא צורך במיקרופון. שירות ההמרה מטקסט לדיבור של מסקיו ממיר את הטקסט שהוזן לקובץ WAV שישמש כמו כל קובץ קול אחר במערכת.

תהליך היצירה ב-4 שלבים​

1. שלב 1 — כתיבת הטקסט — בשדה הטקסט יש להקליד את המלל שתרצו שיושמע למתקשר. ניתן להשתמש בניקוד עברי כדי לשפר את איכות ההגייה.
2. שלב 2 — האזנה לתצוגה מקדימה — יש ללחוץ על כפתור להאזנה כדי לבדוק כיצד הטקסט מושמע. יופיע נגן עם קובץ השמע. ניתן לחזור ולערוך את הטקסט ולהאזין שוב עד לקבלת התוצאה הרצויה.
3. שלב 3 — קביעת שם לקובץ — יש להזין שם (באותיות אנגליות בלבד, עד 20 תווים). שם ברירת מחדל מוצע באופן אוטומטי עם חותמת זמן (למשל tts20260320153600) כדי למנוע התנגשויות.
4. שלב 4 — שמירה — לאחר האזנה לתצוגה המקדימה, כפתור שמור הופך לפעיל. לחיצה עליו תשמור את הקובץ ב-WAV ותוסיף אותו לרשימת קבצי הקול לשימוש בכל מספר מסקיו.

צירוף קובץ קול למספר מסקיו​

לאחר העלאה או הקלטה של קובץ קול חדש, יש לעבור לניהול המספרים, לעריכת מספר המסקיו, ובאזור ניהול קבצי השמע — לבחור את הקובץ הרצוי.

השפעות על המערכת​

קבצי הקול הם המצאי הקולי של הארגון ומשמשים בכמה זרמי שיחה:

• רכיבי IVR — רכיב "נגן קובץ" ב‑IVR Studio מתבסס על ספריית קבצי הקול; מחיקת קובץ שבשימוש פעיל תגרום לכשל ברכיב.
• מספרי מסקיו — פתיח קצר למחייג, מנגינת המתנה, פתיח למקבל השיחה והודעת תפוסה של כל מספר מסקיו מוקצים מתוך ספרייה זו.
• תא קולי ו‑SMS — הודעות פתיחה של תא קולי והודעות קוליות מתפריטים שונים מתבססות על אותם קבצים.
• TTS מובנה — קובצי Text‑to‑Speech שנשמרים דרך אולפן הקול הממוחשב הופכים לקבצי WAV רגילים וזמינים בכל ההקשרים.
• סנכרון שרתים — קובץ חדש יסונכרן לשרתי המדיה בתוך עד 15 דקות; עד אז השיחה תמשיך להשמיע את הקובץ הקודם.

ראו גם​

• IVR Studio
• ניהול מספרים
• הגדרות מערכת

ניהול רשימה שחורה​

docs/system-settings/manage-blacklist.md

ניהול רשימה שחורה​

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

כניסה למסך​

בתפריט הראשי יש ללחוץ על הגדרות מערכת ← רשימה שחורה.

צפייה וחיפוש ברשימה​

מעל הטבלה מוצגים שלושה כרטיסי סיכום: סך כל המספרים החסומים, מספרים שנחסמו בחודש האחרון, ומספרים שנחסמו בשבוע האחרון.

המסך מציג טבלה של כלל החסימות הקיימות, עם עמודות של:

חיפוש וסינון​

• חיפוש טקסט חופשי — ניתן לחפש מספר טלפון או טקסט בהערה. התוצאות מסוננות אוטומטית תוך כדי הקלדה.
• מיון עמודות — לחיצה על כותרת עמודה ממיינת לפיה (עולה/יורד). ניתן למיין לפי מספר, הערה ותאריך הוספה. עמודת מסקיו אינה ניתנת למיון.
• גודל עמוד — ברירת המחדל 50 רשומות בעמוד, ניתן להגדיל עד 1000.

הוספת מספר לרשימה השחורה​

יש ללחוץ על הוספת מספר לרשימת טלפונים חסומים ולהזין את הפרטים. בראש החלונית מוצגת הכותרת "אנא הזינו רשימת מספרי טלפון לחסימה", וניתן להפריד מספרים מרובים בפסיק או בירידת שורה ולחסום קידומות (למשל 023).

שדות הטופס​

הסרה​

• הסרה — לחיצה על אייקון המחיקה מסירה את המספר מהרשימה השחורה (לאחר אישור בהודעת אזהרה).

אין פעולת עריכה לרשומה קיימת — כדי לשנות רשומה יש למחוק אותה ולהוסיף מחדש.

השפעות על המערכת​

הגדרת רשימה שחורה משפיעה ומושפעת:

• שיחות נכנסות — מספר שנמצא ברשימה יידחה אוטומטית בשרת; המתקשר ישמע צלצול חיוג מדומה ולא יקבל מענה
• היקף החסימה — ללא בחירת מסקיו, הרשומה חוסמת את כל המספרים בחשבון; בחירת מסקיו ספציפי מגבילה את החסימה למספר זה בלבד
• קידומות — ניתן להזין קידומת (למשל 050) ולחסום בבת‑אחת כל מחייג מהסדרה; הזנת "0" חוסמת מחייגים אנונימיים
• אוטומציה — אירוע אוטומציה "הוספה לרשימה שחורה" מוסיף רשומות ללא התערבות ידנית (למשל לאחר 3 שיחות כשל ברצף)
• IVR — רכיבי "בדיקת רשימה שחורה" ו"הוספה לרשימה שחורה" ב‑IVR Studio קוראים וכותבים לאותה טבלה
• דוחות — שיחות שנדחו כתוצאה מרשימה שחורה מופיעות ב‑CDR עם סטטוס חסימה; ניתן לסנן אותן בדוחות
• לוג שינויים — כל הוספה או מחיקה של רשומה נרשמת ביומן השינויים עם שם המשתמש

ראו גם​

• אירוע אוטומציה — הוספה לרשימה שחורה
• יומן שינויים
• IVR Studio
• דו״ח פירוט שיחות
• מעקב אחר שיחות

יומן כניסות למערכת​

docs/system-settings/access-log.md

יומן כניסות למערכת​

יומן כניסות למערכת מציג את הכניסות האחרונות למערכת.

חיפוש וסינון​

מעל רשימת הכניסות קיים אזור חיפוש:

• חיפוש טקסט חופשי — חיפוש לפי שם המשתמש (כתובת הדוא"ל) שנכנס למערכת
• סינון לפי סטטוס כניסה — הכל / כניסות מוצלחות / כניסות שנכשלו

סיכומים​

בנוסף, מוצגים סיכומים של כמות כניסות למערכת:

• סך כל הכניסות שנרשמו במערכת
• בחודש האחרון
• בשבוע האחרון

נתונים המופיעים בפירוט הכניסות​

• כתובת הדוא"ל - שם המשתמש שנכנס למערכת
• תאריך ושעת כניסה
• סטטוס הכניסה
• כתובת ה-IP ממנה בוצעה הכניסה

השפעות על המערכת​

יומן הכניסות הוא מנגנון audit בלבד — לא ניתן לערוך אותו — ומשפיע בעיקר על ניטור אבטחה:

• ניטור אבטחתי — כל ניסיון התחברות (הצלחה או כישלון) נרשם עם כתובת ה‑IP ושם המשתמש; מאפשר זיהוי מוקדם של ניסיונות פריצה.
• זיהוי brute‑force — נתוני הכישלונות משמשים את מנגנון החסימה האוטומטית למניעת הצפות ניסיונות התחברות מאותו IP.
• בדיקת פעילות משתמש — מאפשר לוודא שמשתמש מערכת התחבר בזמן ובמקום הצפויים, ללא פעילות חריגה.
• עמידה בדרישות רגולציה — ה‑log משמש כראיה לפעילות גישה ונדרש במסגרת GDPR ובקרות פנים‑ארגוניות.
• יומן בלתי עריך — המידע ניתן לצפייה וייצוא בלבד; אין אפשרות למחיקה או עריכה של רשומות.

ראו גם​

• יומן שינויים
• ניהול משתמשים
• הסרת מידע שיווקי (GDPR)
• הגדרות מערכת

יומן שינויים​

docs/system-settings/changes-log.md

יומן שינויים​

יומן השינויים מרכז תיעוד של כלל פעולות העריכה שבוצעו במערכת — מי שינה, מה שונה, מתי, ומה היה הערך לפני וההערך לאחר. הדף מיועד בעיקר לבקרה ולצרכי ביקורת (audit).

כניסה למסך​

בתפריט הראשי יש ללחוץ על הגדרות מערכת ← יומן שינויים.

מה נרשם ביומן​

כל שינוי על האובייקטים הבאים מתועד אוטומטית:

סינון ותצוגה​

מסננים​

• חיפוש טקסט חופשי — מחפש במשתמש, תיאור השינוי והרשומה המושפעת
• טווח תאריכים — בחירת תאריך התחלה, באמצעות לוח תאריכים (date picker)
• סוג האובייקט — רשימה נפתחת לסינון לפי קטגוריה (כמפורט לעיל)

עמודות היומן​

תצוגת לפני/אחרי​

השינויים המפורטים של כל רשומה מוצגים בשתי עמודות נפרדות:

• לפני השינוי — הערכים הקודמים, ברקע אדום
• אחרי השינוי — הערכים החדשים, ברקע ירוק

ברשומה חדשה תוצג בעמודת "לפני השינוי" הכיתוב "רשומה חדשה", וברשומה שנמחקה תוצג בעמודת "אחרי השינוי" הכיתוב "רשומה נמחקה".

במקרה של שדות ארוכים, התוכן מוצג בתוך מיכל הניתן לגלילה.

ייצוא​

ניתן לייצא את רשימת השינויים באמצעות כפתור הייצוא הסטנדרטי של הגריד — כולל אפשרות לייצא ל-Excel או לשלוח בדוא"ל למייל מוגדר.

השפעות על המערכת​

יומן השינויים מושפע כמעט מכל פעולת עריכה במערכת:

• מספרי מסקיו — שינוי בהגדרות DDI (שעות עבודה, יעד, תיאור, הקלטה) נרשם עם ערך ישן וחדש
• משתמשים והרשאות — יצירה / מחיקה / שינוי הרשאות / שיוך לטלפונים; לביקורת Compliance זה מקור האמת
• אוטומציה — הוספת/עריכת אירוע, שינוי בפעולות (actions), הפעלה/כיבוי של חוק נרשמים
• IVR — כל פרסום של גרסה חדשה של תרחיש נשמר עם המשתמש שביצע את הפעולה
• רשימה שחורה ותגיות — הוספה/הסרה של רשומות (גם ידנית וגם מאוטומציה)
• תוספים — עדכון הגדרות של Google Analyze, קמפיינים דינמיים ואחרים
• לוג עצמו — אינו ניתן לעריכה ידנית; רשומות נרשמות על ידי ה‑trigger במערכת ולא נמחקות אלא על ידי כלי ה‑GDPR

ראו גם​

• יומן כניסות למערכת
• הסרת מידע שיווקי (GDPR)
• ניהול משתמשים
• ניהול מספרי מסקיו
• ניהול תגיות

הסרת מידע שיווקי (GDPR)​

docs/system-settings/gdpr-client-marketing-data-cleaner.md

הסרת מידע שיווקי (GDPR)​

GDPR = General Data Protection Regulation

יישום עקרונות האיחוד האירופי בנושא פרטיות - GDPR: הרגולציה מתייחסת לאיסוף, שמירה והעברה של נתונים אישיים של אנשים פרטיים וקובעת כללים אחידים לשמירה על הפרטיות. הרגולציה נועדה בעיקר לאפשר לכל תושב באיחוד האירופי שליטה מרבית על הפרטים שנשמרו אודותיו בחברות פרטיות.

הסרת מספר טלפון​

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

שלבי ההסרה​

1. יש להזין מספר טלפון להסרה
2. ללחוץ על חיפוש
3. תוצאות החיפוש יציגו שלושה מונים של היכן קיים המספר במערכת: רשומות שיחות, רשומות מספרים ורשומות התראות. לצד מונה רשומות המספרים עשוי להופיע סימן אזהרה — כאשר המספר משמש כיעד שיחה, איפוסו ישפיע על ניתוב עתידי.
4. לחיצה על נקה רשומות תאפס את הנתונים המוצגים ותחליף את מספר הלקוח במספר חסוי. לפני הביצוע מוצגת בקשת אישור — תהליך הניקוי הוא חד-פעמי.

השפעות על המערכת​

פעולת ה‑GDPR מסירה את עקבות המתקשר ברוחב המערכת באמצעות איפוס הנתונים והחלפת המספר במספר חסוי, ויש לה השפעה מצטברת על כל המודולים:

• נתוני CDR — פרטי הזיהוי ברשומות השיחות של המספר מאופסים ומוחלפים במספר חסוי (ראו סימון "לאימות" לעיל בנוגע להיקף המדויק).
• התראות — יעדי התראות (SMS) התואמים למספר שהוסר מאופסים.
• רשומות מספרים — הגדרות שבהן המספר שימש כיעד שיחה או כיעד SMS מאופסות, דבר שעלול להשפיע על ניתוב עתידי.
• דוחות היסטוריים — לאחר הניקוי, המספר לא יופיע עוד בדוחות — גם היסטוריים; רשומות שאופסו יוצגו ללא פרטי הזיהוי.
• רשימה שחורה — אם המספר הופיע ברשימה השחורה, הוא יישאר שם אלא אם יוסר בנפרד.
• שמירת audit — יומן השינויים ויומן הכניסות אינם מושפעים; פעולות ניקוי GDPR עצמן נרשמות ביומן השינויים.
• אין שחזור — הפעולה בלתי הפיכה; אין גיבוי אוטומטי לנתונים שאופסו.

ראו גם​

• יומן שינויים
• יומן כניסות למערכת
• ניהול רשימה שחורה
• דוחות
• הגדרות מערכת

תוספים (Plugins)​

docs/plugins/index.mdx

תוספים (Plugins)​

הרחבות וחיבורים חיצוניים של מסקיו — שילוב עם Google Ads, קמפיינים דינמיים לפי מבקר, ואשף מעקב שיחות באתר.

• 🟢 תוסף Google Ads — סנכרון מידע מ-Google Ads למסקיו ודיווח המרות שיחות טלפון ל-Google Ads
  → ./google-ads/google-analyze-plugin
• 🎯 הגדרת המרה ב-Google Ads — מדידת המרות שיחה מקוד מסקיו בגוגל אדס
  → ./google-ads/setting_up_conversion_from_maskyoo_script_in_google_ads
• 🔄 קמפיינים דינמיים — החלפת מספרים באתר לפי גולש
  → ./dynamic-campaigns/
• 🧙 אשף מעקב שיחות באתר — החלפת מספרים לפי מקור הגעה לאתר
  → ./website-call-wizard/referring-web-plugin

השפעות על המערכת​

שלושת התוספים הזמינים כיום הם: כלי הניתוח של גוגל (Google Ads / Google Analytics), קמפיינים דינמיים, ואשף מעקב שיחות באתר (שאליו אוחד התוסף הישן "מדידת אתרים מפנים"). התוספים הם שכבת ההרחבה של מסקיו — הם מחברים בין שיחות טלפון לכלים חיצוניים ולצד‑לקוח של האתר:

• אוטומציה — חלק מהתוספים (בעיקר Google Analytics) מוסיפים סוגי‑פעולה חדשים לאירועי אוטומציה, למשל "שליחת Event ל‑GA" בסיום שיחה
• דוחות — הפעלת תוסף Google Ads חושפת קטגוריית דוחות מיוחדת (מילות מפתח, קמפיינים, פירוט שיחות מחיפושים) שאינם זמינים במערכת בסיסית
• קוד צד‑לקוח — קמפיינים דינמיים ואשף השיחות מטמיעים JavaScript בדף של הלקוח ומחליפים את מספר הטלפון המוצג בזמן גלישה
• חיוב — חלק מהתוספים (כגון מספרים דינמיים) כרוכים בחיוב חודשי נוסף לפי שימוש
• הרשאות והפעלה — לתוסף Google Ads ולקמפיינים דינמיים יש מתג הפעלה/כיבוי בדף התוסף; ביטול התוסף עוצר מיד את איסוף הנתונים אך לא מוחק נתונים קיימים. אשף מעקב השיחות באתר הוא כלי ליצירת קוד מעקב (ולא מתג הפעלה) — הוא אינו נדלק ונכבה כתוסף, אלא מפיק את קטע הקוד שמוטמע באתר

ראו גם​

• תוסף Google Ads
• הגדרת המרה ב‑Google Ads
• קמפיינים דינמיים
• אשף מעקב שיחות באתר
• ניהול אירועי אוטומציה
• דוחות

תוסף Google Ads​

docs/plugins/google-ads/google-analyze-plugin.md

תוסף Google Ads​

רקע כללי​

קישור לתוסף Google Ads הינו תוסף (פלאגין) במערכת מסקיו המאפשר לך לסנכרן מידע מ-Google Ads למערכת ולדווח על המרות שיחות טלפון ל-Google Ads, וזאת באמצעות ממשק ידידותי ונח.

צורות חיבור נתמכות​

ישנן שלוש צורות חיבור ל-Google Ads הנתמכות במערכת. ניתן לבחור בממשק בודד או בהתממשקות מלאה הכוללת את כל החיבורים שלהלן:

1. דיווח המרות שיחות ל-Google Ads עבור שיחות טלפון למספרי מסקיו.

2. ייבוא דו"ח מילות חיפוש מ-Google Ads למערכת מסקיו - קישור כל המידע אודות הקלקות אשר יצרו שיחות טלפון והצגתן במערכת הדוחות.

3. ייבוא שיחות טלפון ממספרים מקשרים של Google Ads למערכת מסקיו - קישור כל המידע אודות שיחות טלפון אשר בוצעו למספר המקשר של גוגל והצגתו במערכת הדוחות (אופציה זאת תגרור חיוב עבור השיחות הנ"ל כאילו בוצעו על מספרי מסקיו).

הנחיות לביצוע חיבור מלא​

שלב 1 - הטמעת קוד באתר האינטרנט לצורך שליחת נתונים לשרתי מסקיו​

1. את קוד המעקב להטמעה באתר מפיקים באמצעות אשף מעקב שיחות באתר (תוספים ← אשף מעקב שיחות באתר), המייצר קוד מעקב מותאם עם אפשרות החלפת מספרים לפי מקור תנועה או דינמית לפי גולש, וחיבור GA4 דרך ממשק חזותי.

2. הגדרת האשף - באשף יש להגדיר את השדות הבאים:

   • מספר מסקיו ברירת מחדל - בחירת מספר המסקיו שישמש כברירת מחדל מתוך הרשימה הנפתחת
   • מזהי מדידה GA4 - הזנת מזהה/י המדידה של GA4 (בפורמט G-XXXXXXX) שאליהם יישלחו הנתונים. ניתן להזין מספר מזהים המופרדים בפסיקים
   הערה

   כדי שהנתונים יישלחו ל‑GA4, יש להזין את מזהה המדידה של GA4 (בפורמט G-XXXXXXX) בשדה מזהי מדידה GA4.

   

3. יש להעתיק את הקוד ולהטמיע אותו באתר (מומלץ להדביק אותו לפני תג הסגירה </head>)

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

5. יש לגשת לחשבון האנליטיקס הרלוונטי ← לזמן אמת ← אירועים. במידה והכל תקין, אמור להופיע אירוע שנקרא Phone call from MaskYoo

6. כעת ניתן לצפות בנתונים מאנליטיקס גם במערכת מסקיו. יש ללכת לדוחות ← דוח פירוט שיחות, ותחת עמודת מידע נוסף ללחוץ על +

שלב 2 - יצירת קוד והטמעתו ב-Google Ads לצורך משיכת נתונים למערכת מסקיו ושליחת המרות עבור שיחות​

1. כדי להפיק קוד לטובת הטמעה בגוגל אדס, יש לגשת לתוספים ← תוסף Google Ads

2. יש ללחוץ על

3. בשלב הראשון יש להזין את תיאור הקישור, למשל "חיבור לגוגל אדס"

4. בשלב השני יש לבחור את אופן ההתממשקות

5. בשלב השלישי יש לסנן לפי מספר מסקיו ספציפי או תגית מספרים. ניתן גם להוסיף סינון לפי סטטוס שיחה ו/או משך שיחה

6. בשלב הרביעי יש לבחור את שם ההמרה שתישלח לגוגל אדס. השם שייבחר חייב להיות זהה (Case Sensitive) לשם ההמרה שתגדירו בחשבון גוגל אדס.

   ניתן להזין גם כתובת WebHook לטובת קבלת נתוני הקמפיינים במערכת צד ג' שלכם.

   שימו לב

   ה-WebHook אינו נשלח מיד בסיום השיחה כמו באוטומציה, אלא רק כאשר מסקיו מקבלת את נתוני השיחות מגוגל אדס.

   לבסוף יש ללחוץ על שמור

7. במסך ניהול הקישורים יש ללחוץ על , להעתיק את הקוד שמופיע ולהטמיע אותו בחשבון גוגל אדס לפי המדריך הגדרת המרה מקוד מסקיו בגוגל אדס

השפעות על המערכת​

תוסף כלי הניתוח של גוגל משלב את מערכת מסקיו עם Google Analytics ו‑Google Ads ומשפיע על כמה רובדי המערכת:

• אירועי אוטומציה — מוסיף סוג פעולה "שליחת Event ל‑Google Analytics" שניתן לקשר לכל אירוע סיום שיחה; ללא האירוע הזה לא יישלחו נתונים ל‑GA
• דוחות ייחודיים של גוגל — הפעלת התוסף חושפת את קבוצת דוחות גוגל (פירוט שיחות מקמפיינים, מילות מפתח, קמפיינים אינטרנטיים, פירוט שיחות מחיפושים) שלא קיימים ללא החיבור
• דו״ח פירוט שיחות — בעמודת "מידע נוסף" מתווספים נתוני קמפיין, מילת מפתח ו‑GCLID עבור כל שיחה שמוצאה מחיפוש גוגל
• שיחות ממודעות חיוג — מעבר להמרות הרגילות, החיבור מושך גם שיחות שבוצעו ישירות ממודעות חיוג (הרחבת-שיחה / מודעת "התקשרות") ומשייך להן GCLID, כך שגם שיחות אלו מופיעות בדוחות גוגל
• קוד צד‑לקוח — יוצר קוד JavaScript להטמעה באתר (מומלץ לפני תג הסגירה </head>); ללא ההטמעה לא יתבצע סנכרון בין הדפדפן לשיחה
• סקריפט ב‑Google Ads — הסקריפט רץ מדי שעה ב‑Google Ads ושולח נתוני המרה והקלקה למסקיו; תזמון שגוי יוצר חוסר סנכרון בדוחות
• חיוב אופציונלי — צורת החיבור "שיחות שבוצעו למספר המקשר של גוגל" גוררת חיוב נפרד כאילו השיחות בוצעו על מספרי מסקיו

ראו גם​

• הגדרת המרה ב‑Google Ads
• ניהול אירועי אוטומציה
• דו״ח פירוט שיחות
• דו״ח פירוט שיחות מקמפיינים
• דו״ח מילות מפתח
• תוספים

הגדרת המרה מקוד מסקיו בגוגל אדס​

docs/plugins/google-ads/setting_up_conversion_from_maskyoo_script_in_google_ads.md

הגדרת המרה מקוד מסקיו בגוגל אדס​

כדי לשלוח המרה לגוגל אדס ישירות ממערכת מסקיו ללא גוגל אנליטיקס יש לבצע את הפעולות לפי המדריך הבא:

שלב ראשון - הטמעת סקריפט של מסקיו בגוגל אדס​

1. בחשבון Google Ads יש לגשת אל כלים ← פעולות בכמות גדולה / Bulk Actions ← סקריפטים (Scripts) ← יצירת סקריפט חדש

   

2. להדביק את הקוד שהועתק במקום על הדוגמה שמופיעה (הקוד מודבק על לוח ריק), לתת שם לסקריפט (לא חשוב איזה שם)

   

3. ללחוץ על הפעלה (Run) ואז 'בלי תצוגה מקדימה' בחלון שקופץ ← לאשר את הסקריפט (Authorize) ← ואז ללחוץ שוב על הפעלה

4. כאשר ההפעלה תצליח, נגיע למסך היסטוריית הסקריפטים ואז צריך ללחוץ על לשונית סקריפטים, ולתזמן את הסקריפט בעמודת תדירות (Frequency) שירוץ כל שעה (Hourly):

   

5. הטמעת הסקריפט הסתיימה וכעת ניתן לעבור לשלב השני שהוא הגדרת המרה המבוססת על הסקריפט

שלב שני - הגדרת המרה בגוגל אדס​

1. יש לעבור להמרות: יעדים (Goals) ← סיכום (Summary)

   

2. וליצור פעולת המרה חדשה על פי צילומי המסך הבאים:

   

3. בהגדרות ההמרה, ניתן להגדיר לפי רצונכם את כל ההגדרות, למעט שם ההמרה שצריך להיות זהה לשם שהוגדר בקישור במערכת. ברירת המחדל במידה ולא שונה השם היא: Phone call from MaskYoo

   

4. ללחוץ על סיום:

   

5. ללחוץ על שמירה והמשך:

   

6. ללחוץ על סיום:

   

7. לאחר מכן ההמרה הוגדרה ותופיע בסיכום ההמרות, אמנם היא עדיין לא פעילה. צריך להמתין לריצת הסקריפט ולנתוני אמת כדי שהיא תופעל. אין צורך לבצע כל פעולה נוספת, אלא רק לעקוב ולוודא שהמרות מתחילות להיספר בימים הקרובים.

   

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

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

השפעות על המערכת​

הגדרת המרה מקוד מסקיו בגוגל אדס היא תצורה משולבת בין שתי מערכות והמימוש משפיע מיידית על שני הצדדים:

• Google Ads — נוצרת פעולת המרה חדשה בחשבון גוגל אדס שנקראת "Phone call from MaskYoo" (או כפי ששונתה); שם ההמרה חייב להיות זהה לשם הקישור במסקיו אחרת אין התאמה
• סקריפט תדירות‑שעתית — הסקריפט שהותקן בגוגל אדס רץ מדי שעה ומושך נתוני המרות ממסקיו; ללא תזמון Hourly הנתונים לא יתעדכנו
• דוחות גוגל במסקיו — לאחר הסנכרון ההמרות יופיעו לצד כל שיחה בדוחות גוגל ובעמודת "מידע נוסף" של דו״ח פירוט השיחות
• סינון השיחות שייחשבו כהמרה — קביעת אילו שיחות יישלחו כהמרה נעשית בהגדרות הכלל של תוסף Google Ads עצמו (ולא במסך אירועי האוטומציה). ניתן לסנן לפי סטטוס השיחה, משך השיחה ותגיות, כך שרק שיחות שעונות על התנאים יועלו כהמרה בעת ריצת הסקריפט השעתי
• ללא תלות ב‑Google Analytics — המסלול הזה עוקף את GA ושולח המרות ישירות; שינוי בהגדרה לא משפיע על Event Tracking ב‑Analytics אם הוא מוגדר במקביל

ראו גם​

• תוסף Google Ads
• דו״ח פירוט שיחות
• דו״ח קמפיינים אינטרנטיים
• תוספים

קמפיינים דינאמיים​

docs/plugins/dynamic-campaigns/dynamic-campaigns.md

קמפיינים דינאמיים​

כיצד זה עובד?​

"מספרים דינאמיים" הינו תוסף (פלאגין) למערכת המסקיו שמאפשר לכם להציג מספר מסקיו שונה וייחודי באתרכם עבור כל גולש, על בסיס מספר פנוי.

אופציה זאת מאפשרת מדידה מדויקת וניתוח מלא אודות הגורמים שהשפיעו על הגולש לביצוע שיחת טלפון כגון מילות מפתח, זמן שהייה בדף, מקורות תנועה ועוד.

לשם כך יש להקצות כמות מספרי מסקיו אשר מתאימה לכמות הגולשים בו זמנית באתר בזמן שיא (את נתון זה ניתן להסיק באמצעות Google Analytics).

מוצר זה מצריך הטמעה חד-פעמית של קוד JavaScript באתר, שנוצר דרך אשף מעקב שיחות באתר (Pixel Generator). חיבור ל-Google Analytics מתבצע אף הוא דרך אותו אשף.

דוגמא​

• גולש א' אשר הגיע לאתרכם וירצה להתקשר אליכם יראה את המספר 077-6670000 באתר כמספר הטלפון שלכם
• לעומתו גולש ב' אשר הגיע לאתרכם באותו הזמן כמו גולש א' יראה את המספר 077-6670001 כמספר הטלפון שלכם, וכן הלאה לפי כמות מספרי המסקיו בקמפיין
• כאשר אחד מהגולשים יסיים את הגלישה באתר ישתחרר המספר באופן אוטומטי ויהפוך להיות זמין לגולש הבא

הגדרת קמפיין מספרים דינמיים​

ניהול הקמפיינים הדינמיים נעשה דרך התפריט תוספים ← קמפיינים דינמיים. במסך הראשי ניתן לצפות בכלל הקמפיינים, לערוך קיימים, או לחפש לפי שם/מספר. ליצירת קמפיין חדש יש ללחוץ על הוספת קמפיין חדש.

במסך רשימת הקמפיינים קיים מתג הפעלה/כיבוי כללי לתוסף, מדריך מובנה "כיצד זה עובד", וקישור לאשף מעקב שיחות באתר ליצירת קוד ההטמעה.

שדות הטופס​

1. תיאור קמפיין — שם רצוי לקמפיין (לשימוש פנימי)
2. סטטוס קמפיין — פעיל / לא פעיל
3. מספר סטטי (Static Phone) — בורר מספר מסקיו עם שדה "מספר לתצוגה"; זהו המספר שיוצג במידה וכל המספרים הדינמיים תפוסים (fallback)
4. רשימת מספרים — מאגר מספרי המסקיו הדינמיים שיופיעו לסירוגין לפי גולשים. ניתן להוסיף/להסיר מספרים בכל עת, באמצעות שתי לשוניות:
   • הוספת מספר — הוספת מספר בודד מתוך בורר מספרי המסקיו
   • הוספת מספרים — הדבקת רשימת מספרים מרובים בבת-אחת

הטמעת הקוד​

יצירת קוד ההטמעה רוכזה כעת באשף מעקב שיחות באתר (Pixel Generator). במסך עריכת הקמפיין מופיע כפתור "מעבר לאשף מעקב שיחות באתר" המעביר לאשף ליצירת הקוד, ובעמודת "קוד" שברשימת הקמפיינים מופיע קישור לאותו אשף.

לאחר קבלת הקוד יש להטמיע אותו באתר ולבצע בדיקות — לדמות כניסות מחלוניות דפדפן שונות (incognito windows) ולוודא שהמספר מתחלף בין חלונית לחלונית.

תמיכה נוספת​

ניתן לפנות לתמיכה הטכנית למספר 077-6670000 שלוחה 2 לעזרה בהגדרה ראשונית.

השפעות על המערכת​

תוסף מספרים דינמיים משפיע על הצגת מספרי הטלפון באתר הלקוח ועל הדיווח בדוחות:

• מאגר מספרים מוקצה — כל המספרים בקמפיין נסגרים לשימוש הקמפיין בזמן הגלישה; מספר שמוקצה כבר לקמפיין אחר או כמספר סטטי יגרור התנגשות שיוך
• החלפה בצד‑לקוח — קוד ה‑JavaScript מאתר את מספר הטלפון בדף ומחליף אותו דינמית; הקוד נוצר כעת דרך אשף מעקב שיחות באתר (Pixel Generator), שם מגדירים את שיטת האיתור ואת חיבור ה-GA4
• חיבור GA4 דרך האשף — חיבור הנתונים לאנליטיקס מתבצע במסגרת הקוד שנוצר באשף; הנתונים (מילות מפתח, זמן שהייה, מקור תנועה) משתלבים בנתוני השיחה
• דו״ח פירוט שיחות — שיחה שמגיעה ממספר דינמי תכלול בעמודת "מידע נוסף" את פרטי המקור של הגולש שראה את המספר
• חיוב חודשי — 15 ש״ח לחודש לכל מספר בקמפיין, בנוסף לחיוב הרגיל של המספרים
• Fallback סטטי — כשכל המספרים תפוסים מוצג המספר הסטטי של הקמפיין; שיחה למספר זה לא ניתנת לשיוך לביקור ספציפי (המספר משותף באותו רגע לכלל הגולשים), אך המספר ממשיך לשמש לאיסוף נתוני ביקור בסיסיים

נתוני המקור הנשמרים ב-CDR עבור שיחה למספר הסטטי הם אותם שדות כמו בפיקסל הרגיל, אך פחות מדויקים: מכיוון שהמספר הסטטי משותף לכלל הגולשים באותו רגע, אין ייחוס ודאי בין הביקור הספציפי לשיחה.

ראו גם​

• תוסף Google Ads
• אשף מעקב שיחות באתר
• הוספת מספר מסקיו חדש
• ניהול מספרי מסקיו
• דו״ח פירוט שיחות
• תוספים

אשף מעקב שיחות באתר​

docs/plugins/website-call-wizard/referring-web-plugin.md

אשף מעקב שיחות באתר​

אשף מעקב שיחות באתר (מחולל קוד מעקב שיחות / Pixel Generator) הוא תוסף המייצר עבורכם קוד JavaScript חכם להטמעה באתר. הקוד מאפשר למדוד שיחות לפי מקור הגעה, להחליף את מספר הטלפון המוצג בדף לפי כללים שתגדירו, ולחבר את הנתונים ל-Google Analytics 4 — הכול דרך ממשק חזותי בלי צורך בקוד מותאם של צוות התמיכה.

האשף פועל לצד תוסף Google Ads (המוכר גם בשמו הוותיק "תוסף מדידת אתרים מפנים") ומשלים אותו — הוא אינו מחליף את התוסף. האשף מרכז במקום אחד את החלפת המספרים לפי מקור ההגעה, את המספרים הדינמיים ואת חיבור המדידה לאנליטיקס, בקוד משולב אחד.

הגדרות בסיס​

בראש האשף מגדירים את הפרמטרים הכלליים של הקוד:

• מזהה חשבון לקוח — מולא אוטומטית עבור החשבון שלכם
• מספר מסקיו ברירת מחדל — המספר שיוצג כברירת מחדל באתר כל עוד לא חל עליו כלל החלפה
• כללי החלפת טלפון — מתג ראשי. כשהוא דולק ניתן להוסיף כללים להחלפת המספר; כשהוא כבוי הקוד מבצע מעקב בלבד ללא החלפת מספרים

תחת הגדרות מתקדמות (מקופלות) ניתן להזין:

• מזהי מדידה GA4 — מזהה מהצורה G-XXXX (ניתן להזין כמה מזהים מופרדים בפסיק)
• מצב ניפוי שגיאות, התעלמות מ-cookies, השהיית טעינה ועוד אפשרויות מתקדמות

הגדרות מספר דינמי​

בתחתית ההגדרות המתקדמות מופיע מקטע "הגדרות מספר דינמי" — הגדרות כלליות לקוד המיוצר:

• מספר סטטי — מספר טלפון קבוע שישמש כגיבוי
• מרווח (מילישניות) — מרווח הסקירה לבדיקת המספר הדינמי
• זמן קצוב (מילישניות) — הזמן הקצוב לבקשת מספר דינמי

כללים​

כאשר מתג "כללי החלפת טלפון" דולק ניתן להוסיף כללים. לכל כלל בוחרים את סוג הכלל:

לכל כלל בוחרים גם מה להחליף:

• טקסט וקישור חיוג (tel://) — מחליף גם את הטקסט המוצג וגם את קישור החיוג
• טקסט בלבד — מחליף את הטקסט המוצג בלבד
• קישור חיוג (tel://) בלבד — מחליף רק את יעד קישור החיוג מאחורי הקלעים

בנאי תנאים​

לכל כלל ניתן להגדיר תנאי הפעלה לפי מקור (כתובת עמוד, מקור הפניה, אחסון סשן או סוג מכשיר), עם אופרטור וערך, וחיבור בין מספר תנאים ב-AND או OR. כלל ללא תנאים פעיל תמיד.

יצירת הקוד והטמעתו​

1. לאחר הגדרת הבסיס והכללים, יש ללחוץ על צור קוד
2. ניתן להעתיק את הקוד ללוח או להוריד אותו כקובץ
3. יש להדביק את הקוד באתר לפני תג הסגירה </body>
4. האשף תומך גם בייבוא קוד קיים (כפתור ייבוא) — כך ניתן לטעון קוד שנוצר בעבר חזרה לאשף ולערוך אותו

ביצוע בדיקות​

לאחר ההטמעה יש לדמות כניסה מהמקורות והמכשירים שהוגדרו בתנאים ולוודא שהמספר מתחלף בהתאם, ושאירועי השיחה מגיעים ל-Google Analytics.

השפעות על המערכת​

האשף מייצר קוד צד‑לקוח שמשפיע על הצגת מספרי הטלפון באתר ועל הדיווח:

• החלפה בצד‑לקוח — הקוד מאתר את מספר הטלפון בדף לפי טקסט או CSS Selector ומחליף אותו לפי הכלל; שינויי עיצוב באתר שמשנים את הסלקטורים עלולים לשבור את ההחלפה
• בורר "מה להחליף" — מאפשר להחליף את הטקסט המוצג, את קישור החיוג (tel://), או את שניהם — כך שניתן לבצע גם החלפה ויזואלית וגם החלפה מאחורי הקלעים בלבד
• חיבור ל-GA4 — כאשר מוזנים מזהי מדידה GA4, הקוד שולח את אירועי השיחה ישירות ל-Google Analytics 4
• חיפוש לפי טקסט — סוגי הכללים מבוססי "חיפוש והחלפה" דורשים משאבים גבוהים יותר מדפדפן הגולש; מומלץ להעדיף החלפה לפי CSS Selector כשהדבר אפשרי
• תלות במספרי מסקיו קיימים — כל מספר שנבחר ככלל חייב להיות מספר מסקיו פעיל בחשבון

ראו גם​

• מחולל קוד מעקב שיחות
• תוסף Google Ads
• קמפיינים דינמיים
• ניהול מספרי מסקיו
• דו״ח פירוט שיחות
• תוספים

למפתחים​

docs/developers/index.mdx

למפתחים​

מקטע זה מרכז את כל המשאבים הטכניים של מסקיו עבור מפתחים ואנשי אינטגרציה: REST API, SMS Gateway API, SDK ל-JavaScript, והוראות תמיכה מרחוק.

• 🔑 הוספת טוקן API — יצירה וניהול של טוקני גישה ל-API
  → ./api/api-token
• 🌐 REST API — ניהול מסקיו, משתמשים, תגיות, שאילתות, רשימה שחורה
  → ./api/rest-api/
• 💬 SMS Gateway API — שליחה, קבלה, bulk, אנשי קשר, שדרים, קרדיט
  → ./api/sms-api/
• 📦 MSQ Pixel SDK — הטמעת תג מעקב בצד הלקוח, החלפת מספרי טלפון דינמית, פיקסלים
  → ./sdk/

השפעות על המערכת​

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

• REST API — קריאה וכתיבה של מספרי מסקיו, משתמשים, תגיות, רשימה שחורה, הקלטות ו‑CDR; כל שינוי נראה מיידית גם בממשק הגרפי
• SMS Gateway — שליחה/קבלת SMS עם חיוב קרדיט, ניהול sender IDs ואנשי קשר; פעיל כ‑gateway עצמאי או כחלק מאוטומציה
• SDK / Pixel — ספריית JS שמוחדרת לאתר הלקוח, מחליפה מספרי טלפון בזמן אמת ומשייכת שיחות לקמפיינים דינמיים
• טוקן גישה — כל הקריאות ל‑API דורשות Bearer Token אישי ו‑IP whitelist; הטוקן נכנס לתוקף לאחר שמירת טופס ההגדרות. שמרו על הטוקן בסודיות; להחלפת טוקן פנו לתמיכת מסקיו במידת הצורך
• אבטחה — העברת נתונים מעל HTTPS בלבד; חריגות נרשמות ביומן גישה למשתמש

ראו גם​

• הוספת טוקן API
• REST API
• SMS Gateway API
• MSQ Pixel SDK
• יומן כניסות למערכת

Adding a Maskyoo API access token​

docs/developers/api/api-token.md

Adding a Maskyoo API access token​

As part of raising the information security level of the Maskyoo systems, API access includes an additional security measure in the form of an API TOKEN.

In addition to adding the allowed IP addresses for API access, the token that is defined in advance in the Maskyoo system is required as well.

Where to find the API TOKEN​

The API TOKEN is available in the interface under:

System Settings (הגדרות מערכת) ← Settings (הגדרות) ← the API Settings tab (הגדרות API) ← API access code (קוד גישה לממשקי API)

You may use the token that is displayed, or generate a new one by clicking Renew access code (חידוש קוד גישה).

System impact​

The API token is the main access key for all integrations:

• REST API — when a token is defined for the account, every call to an endpoint requires it in the Authorization: Bearer header; without it (or when it is invalid / expired) 401 Unauthorized is returned. When no token is defined for the account, access is controlled by the allowed IP address list alone
• SMS Gateway — sending and receiving SMS requires the same token as well (in the header or as a query parameter)
• SDK / Pixel — the client-side library identifies the account through setting_api_key, which is based on the same token
• IP whitelist — the token works only from IP addresses that were defined in advance under System Settings → API Settings
• Generating a new token — clicking Renew access code only fills the field; the token becomes effective only after the settings form is saved. Keep the token confidential; to replace a token contact Maskyoo support if needed

See also​

• REST API overview
• SMS Gateway overview
• MSQ Pixel SDK settings
• System settings

SMS Gateway API​

docs/developers/api/sms-api/index.md

Maskyoo SMS Gateway API​

Maskyoo SMS gateway provides several APIs to allow developers to integrate functionality of send and receive SMS messages into their systems.

Overview​

The SMS Gateway supports multiple integration methods:

Prerequisites​

Before using the API, ensure the following requirements are met:

Authentication​

Using Bearer Token​

Add the token to the Authorization header:

Authorization: Bearer YOUR_TOKEN_HERE

Using Query Parameter​

Alternatively, pass the token as a query parameter:

?token=YOUR_TOKEN_HERE

For information on obtaining your API token, see API Token Guide.

השפעות על המערכת​

ה‑SMS Gateway מקשר בין שליחה חיצונית לבין התשתיות הפנימיות של מסקיו:

• קרדיט — כל הודעה שנשלחת מורידה נקודה מחשבון ה‑SMS; חשבון ללא קרדיט לא ישלח הודעות
• דו״ח התראות — כל הודעה נשלחת נרשמת ב‑_notifications ונראית בדוח ההתראות, כולל ב‑widget של הלוח בקרה
• sender IDs — שליחה חייבת להשתמש בשם שולח מאושר (מתבצע ב‑/senders); שימוש בשם לא מאושר יידחה
• שיטות אינטגרציה — REST (ערוץ ראשי), SOAP (legacy), Bulk, Mail‑to‑SMS, Webhooks לקבלת הודעות
• אוטומציה — הודעה נכנסת יכולה להפעיל אירוע sms_receive ולהעביר את הנתונים לרולאוטומציה

ראו גם​

• שליחת SMS
• יתרת קרדיט
• ניהול שולחים
• REST API ראשי
• אירוע אוטומציה SMS

Send SMS - REST API​

docs/developers/api/sms-api/send-sms.md

REST API - Send SMS​

Send a single SMS message to one or multiple recipients.

Endpoint​

GET https://sms.deals/api/ws.php

Parameters​