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

היכרות​

docs/getting-started/introduction.md

היכרות​

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

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

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

כיצד זה עובד​

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

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

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

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

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

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

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

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

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

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

מספר מסקיו​

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

תיאור מסקיו​

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

מספר היעד​

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

מספר המתקשר​

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

משתמש מסקיו​

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

עסק / לקוח​

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

לקוח קצה​

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

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

שיחות שנענו​

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

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

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

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

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

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

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

שיחות אבודות​

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

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

מושגי זמן​

משך שיחה​

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

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

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

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

docs/getting-started/getting-started.md

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

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

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

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

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

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

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

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

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

אוטומציה​

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

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

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

דוחות​

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

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

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

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

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

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

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

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

1. מידע אישי​

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

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

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

3. שנה סיסמה​

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

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

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

לוח בקרה​

docs/dashboard/index.md

לוח בקרה​

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

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

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

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

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

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

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

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

איפוס פריסה​

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

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

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

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

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

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

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

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

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

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

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

יישום זה מציג את כמות השיחות שבוצעה ב-5 הדקות האחרונות, בשעה האחרונה, וב-24 השעות האחרונות.

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

הצגה של אחוזי השיחות בחלוקה לסטטוס המענה לשיחה:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

docs/dashboard/monitoring-calls.md

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

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

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

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

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

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

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

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

ראו גם​

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

דו"חות​

docs/reports/index.mdx

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

דו"חות זמן​

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

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

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

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

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

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

• 🏷️ דו"ח לפי תגיות — סיכום השיחות לפי תגיות שהוגדרו
  → ./tags-report
• ⭐ דו"ח דירוגי שיחות — דירוגים שנתנו המשתמשים לשיחות
  → ./call-ratings-report
• ❌ דו"ח שיחות ננטשות — שיחות שהמחייג ניתק לפני מענה
  → ./lost-calls-report
• 🚨 דו"ח לפי התראות — סיכום ההתראות שנשלחו בעקבות שיחות
  → ./notifications-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 — פירוט רחב של שיחות מקמפיינים וחיפושים
  → ./google/search-call-detail-report

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

docs/reports/overview-report.md

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

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

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

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

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

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

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

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

docs/reports/call-detail-report.md

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

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

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

עמודת הערות​

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

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

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

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

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

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

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

דירוג 0-9​

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

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

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

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

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

C = שיחת click to call​

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

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

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

עמודת הקלטה​

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

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

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

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

docs/reports/lost-calls-report.md

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

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

דו"ח התראות​

docs/reports/notifications-report.md

דו"ח התראות​

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

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

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

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

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

docs/reports/call-ratings-report.md

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

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

דו"ח שעתי​

docs/reports/hourly-report.md

דו"ח שעתי​

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

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

דו"ח יומי​

docs/reports/daily-report.md

דו"ח יומי​

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

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

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

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

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

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

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

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

דו"ח חודשי​

docs/reports/monthly-report.md

דו"ח חודשי​

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

גרף עמודות​

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

פירוט הדו"ח​

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

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

docs/reports/maskyoo-report.md

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

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

גרפים​

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

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

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

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

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

docs/reports/maskyoo-activity-report.md

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

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

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

ניתן לראות בפירוט הדו"ח את:

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

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

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

דו"ח עסקים Unique​

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

דו"ח עסקים Unique​

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

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

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

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

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

דו"ח שיחות Unique​

docs/reports/unique-calls-report.md

דו"ח שיחות Unique​

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

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

docs/reports/caller-report.md

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

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

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

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

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

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

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

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

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

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

גרף עוגה​

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

פירוט הדו"ח​

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

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

docs/reports/tags-report.md

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

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

גרף עמודות​

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

גרף עוגה​

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

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

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

דו"ח SWOT​

docs/reports/swot-report.md

דו"ח SWOT​

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

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

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

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

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

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

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

יתרונות (Strengths)​

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

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

חסרונות (Weaknesses)​

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

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

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

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

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

איומים (Threats)​

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

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

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

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

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

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

מטרת הדו"ח​

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

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

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

שימוש בדו"ח​

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

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

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

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

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

מטרת הדו"ח​

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

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

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

שימוש בדו"ח​

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

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

docs/reports/user-trends-report.md

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

docs/numbers/index.mdx

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

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

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

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

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

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

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

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

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

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

מספרים בצינון (תיבה אדומה)​

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

מספרים פנויים (תיבה כחולה)​

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

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

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

במידה ויהיו תוצאות מתאימות, הן יופיעו.

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

3. לאחר בחירת מספר רצוי ולחיצה על תופיע החלונית הבאה:

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

יש ללחוץ על המשך.

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

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

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

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

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

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

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

docs/numbers/manage/manage-maskyoo.md

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

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

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

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

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

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

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

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

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

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

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

ייצוא​

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

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

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

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

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

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

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

עריכה מרובה​

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

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

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

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

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

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

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

1. טלפון​

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

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

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

מספר מסקיו​

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

2. יעדי שיחה​

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Maskyoo פעיל​

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

חשיפת מספר​

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

טלפון SMS​

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

כתובת URL לפתיחה​

כאן ניתן להזין URL אליו יישלחו נתוני השיחות עבור מסקיו זה.

תזמון פתיחת URL​

מתי לשלוח את נתוני השיחה במידה והוזנה כתובת URL לפתיחה:

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

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

כדי ששיחות למספר המסקיו יוקלטו ויהיה ניתן לשמוע את ההקלטה דרך הדוחות במערכת, יש לבחור ב-100% הקלטת שיחות.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שמירה​

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

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

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

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

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

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

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

3. לאחר לחיצה על שחרור המספר, תופיע הודעת אזהרה שהשחרור לא ניתן לביטול. יש לסמן ב-V את השדה הרלוונטי וללחוץ על שחרר

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

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

אוטומציה​

docs/automation/index.mdx

אוטומציה​

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

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

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

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

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

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

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

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

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

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

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

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

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

שלב 2 - הגדרת שם האירוע​

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

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

שלב 3 - בחירת סוג האירוע​

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

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

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

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

שלב 4 - הגדרת מסננים​

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

הגדרת הגבלות ריצה​

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

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

הגדרת סינונים​

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

שלב 5 - הוספת פעולות להרצה​

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

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

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

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

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

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 - מספר המסקיו יופיע כשולח.
• טלפון המתקשר - מספר המתקשר יופיע כשולח.
• מספר טלפון ברירת המחדל של המערכת - המספר שהוגדר בהגדרות הראשיות של המערכת.
• אחר - ניתן להזין מספר / טקסט באנגלית (אותיות מחוברות) והם יופיעו כשולחי ההודעה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הגדרות הודעת דוא"ל​

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

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

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

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

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

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

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

אוטומציה - פתיחת קישור​

docs/automation/events/url-callback.md

אוטומציה - פתיחת קישור​

פעולת פתיחת קישור (URL Callback) מאפשרת שליחת נתוני השיחה בזמן אמת לכתובת חיצונית (למשל מערכת CRM, אפליקציה פנים-ארגונית וכו').

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

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

להלן הפרטים הספציפיים לפעולת פתיחת קישור (שלב 5):

שלב 5 - הגדרת פעולת פתיחת קישור​

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

פעולת פתיחת קישור מאפשרת שליחת נתוני השיחה לכתובת חיצונית כלשהי (כמו מערכת CRM וכדומה).

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

הגדרות פתיחת קישור​

הגדרת פרמטרים​

ניתן להוסיף פרמטרים ללא הגבלה:

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

בדיקת קישור​

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

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

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

אוטומציה - אירוע 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​

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

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

אוטומציה - שליחת נתונים ל-Zapier​

docs/automation/events/send-info-to-zapier.md

אוטומציה - שליחת נתונים ל-Zapier​

פעולת שליחת נתונים ל-Zapier מאפשרת להזרים את פרטי השיחה ל-Zapier ולחבר אותם ליותר מ-1,000 אפליקציות (Google Sheets, Salesforce, Slack, HubSpot ועוד).

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

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

להלן הפרטים הספציפיים לפעולת שליחת נתונים ל-Zapier (שלב 5):

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

בלשונית "פעולות להרצה", יש ללחוץ על ולבחור בשליחת פרטים ל-Zapier.

יצירת ZAP מסקיו וחיבורו למערכת​

חיבור הפעולה ל-ZAP דורש ידע מקדים על פעולה ושיטת העבודה ב-Zapier. קיימים מדריכים רבים וטיפים מעולים לביצוע אינטגרציות מול Zapier באתר המערכת שלהם - zapier.com.

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

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

• שם הפעולה - יש לתת שם שמתאר את הפעולה. לדוגמה: "שליחת פרטים ל-Zapier".
• יצירת ZAP מסקיו - יש ללחוץ על

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

1. יפתח המסך הבא בזאפייר, שם יש לאשר את הזאפ של מסקיו:

   

2. יש ליצור זאפ חדש ובטריגר לחפש Maskyoo:

   

3. לאחר מכן יש לבחור את הפעולה: Call Event

   

4. כעת תוצג על המסך כתובת לשימוש המשתמש. יש להעתיק אותה, לחזור למערכת מסקיו ולהדביק אותה בשדה "כתובת טריגר (WebHook)" וללחוץ על

   

5. לחזור למערכת זאפייר וללחוץ על CONTINUE

6. כעת יופיע החלון הבא, בו יש ללחוץ על Test trigger:

   

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

   

8. ללחוץ על CONTINUE. לאחר מכן ללחוץ על Done Editing

   

9. יש לחזור כעת למערכת מסקיו למסך האוטומציה ולשמור את האירוע.

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

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

המשך העבודה עם Zapier​

כעת ניתן להוסיף פעולה (Action) ליותר מ-1,000 אפליקציות ולהשתמש במידע שהתקבל באירועי השיחה.

להסבר על שליחת נתונים ל-Google Sheets, ראו את המדריך המתאים.

אוטומציה - ניטרול מסקיו​

docs/automation/events/disable-maskyoo.md

אוטומציה - ניטרול מסקיו​

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

מתי להשתמש בפעולה זו​

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

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

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

להלן הפרטים הספציפיים לפעולת ניטרול מסקיו (שלב 5):

שלב 5 - הגדרת פעולת ניטרול​

בלשונית "פעולות להרצה", יש ללחוץ על ולבחור בניטרול מסקיו.

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

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

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

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

אוטומציה - הוספה לרשימה שחורה​

docs/automation/events/add-number-to-blacklist-automation.md

אוטומציה - הוספה לרשימה שחורה​

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

מתי להשתמש בפעולה זו​

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

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

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

להלן הפרטים הספציפיים לפעולת הוספה לרשימה שחורה (שלב 5):

שלב 5 - הגדרת פעולת חסימה​

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

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

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

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

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

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

docs/automation/scheduled-reports/create-timed-report.md

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

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

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

1. בתפריט הראשי יש לגשת לדוחות

2. יש לבחור את סוג הדוח הרצוי

   

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

4. תיפתח החלונית הבאה:

   

שדות הטופס​

שמירת הדו"ח המתוזמן​

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

ניהול דו"חות מתוזמנים​

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)​

docs/ivr/manage-ivrs.md

ניהול נתבי שיחות (IVR)​

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

כניסה למסך​

בתפריט הראשי יש ללחוץ על נתב שיחות (IVR) ← ניהול נתבי שיחות.

פעולות זמינות במסך​

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

שיוך IVR למספר מסקיו​

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

1. יש להיכנס לניהול מספרי מסקיו ולערוך את המספר הרצוי
2. באזור הגדרות טלפוניה מתקדמות יש לבחור אלגוריתם לחיוג ← AdvancedIVR
3. לבחור את ה-IVR הרצוי מתוך הרשימה
4. לשמור את השינויים

ראו גם​

• 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 (ניתן לעריכה)
  • כפתורי שמור כטיוטה ושמור ופרסם
  • כפתור הרץ דיבאג לסימולציית שיחה
  • בוחר גרסאות היסטוריה

הגדרות גלובליות (ברירת מחדל)​

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

• שפת ברירת מחדל — עברית / אנגלית / רוסית / ערבית
• קובץ השמעה על הקשה לא תקינה (invalid input)
• קובץ השמעה על חוסר תגובה (no response)
• קובץ השמעה לאחר מספר ניסיונות (too many attempts)
• מספר ניסיונות מקסימלי — 1 עד 10 (ברירת מחדל: 3)
• Caller ID לחיוג יוצא — המספר שיוצג למקבל השיחה

רכיבים זמינים בארגז הכלים​

הרכיבים מחולקים לקטגוריות נושאיות:

רכיבי השמעה ומידע​

רכיבי קלט מהמתקשר​

רכיבי ניתוב שיחה​

רכיבי לוגיקה ותנאים​

רכיבי משתנים ונתונים​

רכיבי אינטגרציה​

רכיבי רשימה שחורה​

משתני מערכת זמינים​

בכל רכיב שתומך בטקסט (כולל TTS, SMS, Email, Webhook) ניתן להשתמש במשתנים בסוגריים מסולסלים כפולים:

משתני המשתמש:

• {{Variable1}} – {{Variable10}} — 10 משתנים מותאמים אישית
• {{SystemRec1}} – {{SystemRec10}} — 10 הקלטות מערכת

משתני מערכת:

• {{CALLERID}} — מספר המחייג
• {{MASKYOO}} — מספר המסקיו
• {{UNIQUEID}} — מזהה ייחודי של השיחה
• {{DATE}}, {{TIME}}, {{TIMESTAMP}} — תאריך, שעה, וחותמת זמן
• {{HOUR}}, {{MINUTE}}, {{WEEKDAY}} — רכיבי זמן נפרדים

מצב דיבאג (סימולציית שיחה)​

כדי לבדוק תרחיש לפני פרסום:

1. יש ללחוץ על הרץ דיבאג בסרגל הכלים העליון
2. ייפתח דיאלר וירטואלי לסימולציית לחיצות DTMF
3. ה-Studio יציג בזמן אמת:
   • הרכיב הפעיל כעת (מודגש בקנבס)
   • ערכי המשתנים בכל רגע
   • קבצי השמע המושמעים (סימולטיבי — ללא השמעה בפועל)
   • תצוגת console של הודעות דיבאג
4. ניתן להגדיר עצירה בנקודות Alert כדי להקפיא את ההרצה בנקודות מסוימות

שמירה ופרסום​

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

היסטוריית גרסאות​

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

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

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

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

1. לערוך את מספר המסקיו בניהול מספרים
2. בהגדרות טלפוניה מתקדמות לבחור אלגוריתם חיוג AdvancedIVR
3. לבחור את ה-IVR שנבנה מהרשימה
4. לשמור את השינויים

ראו גם​

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

משתמשים​

docs/users/index.mdx

משתמשים​

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

• ➕ הוספת משתמש — יצירת חשבון משתמש חדש עם הרשאות, תגיות ומספרים
  → ./add/create-new-user
• 👥 ניהול משתמשים — חיפוש, עריכה וניטרול משתמשים קיימים
  → ./manage/manage-users

יצירת משתמש חדש​

docs/users/add/create-new-user.md

יצירת משתמש חדש​

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

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

חשבון​

לשונית זו מגדירה הגדרות בסיסיות של החשבון:

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

הרשאות​

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

הרשאות כלליות מובנות​

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

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

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

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

מספרי טלפון המוקצים למשתמש​

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

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

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

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

הגדרות אבטחה​

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

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

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

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

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

דוגמא מהדוח:

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

שליחת הדוחות לכתובת דוא"ל נוספות​

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

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

בדיקת תקינות​

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

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

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

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

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

docs/users/manage/manage-users.md

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

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

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

תכונות נוספות​

השתלט​

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

צפייה בדוחות אוטומטיים​

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

שליחה יזומה של דוחות​

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

הגדרות מערכת​

docs/system-settings/index.mdx

הגדרות מערכת​

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

• ⚙️ הגדרות — זהות הארגון, מיתוג, הגדרות כלליות
  → ./general
• 🏷️ ניהול תגיות — ארגון מספרים ומשתמשים לקבוצות לוגיות
  → ./manage-tags
• 🎵 ניהול קבצי קול — ספריית הברכות והודעות קוליות של הארגון
  → ./manage-sound-files
• 🚫 ניהול רשימה שחורה — חסימת מספרי מחייג ברמת הארגון
  → ./manage-blacklist
• 📜 יומן כניסות למערכת — מעקב אחר גישות משתמשים
  → ./access-log
• 🔐 הסרת מידע שיווקי (GDPR) — מחיקת נתוני מחייג לפי בקשה
  → ./gdpr-client-marketing-data-cleaner
• 📝 יומן שינויים — רישום כל הפעולות והשינויים במערכת
  → ./changes-log

הגדרות​

docs/system-settings/system-settings.md

הגדרות​

הגדרות כלליות​

זהות ארגונית​

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

פרטי הזדהות בתקשורת יוצאת​

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

הגדרות אבטחה​

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

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

הגדרות זמן ותאריך​

• אזור זמן - אזור זמן מוגדר על ישראל בברירת המחדל, ניתן לשנות זאת בשדה זה.
• פורמט תאריך - פורמט התאריך מוגדר על מבנה תאריך בפורמט ישראלי, ניתן לשנות זאת לפורמט תאריך אחר.
• יום תחילת שבוע - ניתן לבחור ביום שני כיום תחילת השבוע (רלוונטי למי שעובד משני עד שבת ויום המנוחה הוא ראשון)
• פורמט שעה - ניתן לבחור בין פורמט 24 שעות לבין 12 שעות (AM/PM)
• שפת מערכת - מוגדרת על עברית בברירת המחדל, אלא אם יוגדר אחרת.

הגדרות מחיקה אוטומטית​

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

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

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

הגדרות API​

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

על מנת לאפשר אופציות אלו, הינך נדרש/ת לבצע תהליך זיהוי כפול הכולל:

1. כתובות IP מורשות לגישה ל-API - פניות מכתובות IP המוגדרות מראש במערכת.
2. קוד גישה לממשקי API - הזדהות באמצעות טוקן המוגדר מראש במערכת.

תיעוד API מלא ניתן לעיונך בתיעוד API.

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

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

בהגדרות ברירת המחדל ניתן לקבוע:

ברירות מחדל להגדרות טלפוניה מתקדמות​

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

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

• פתיח קצר למחייג השיחה - בחירת הפתיח הקולי למחייג
• מנגינת צליל חיוג - צליל ההמתנה למענה
• פתיח קצר למקבל השיחה - בחירת קובץ השמעה למקבל השיחה

ברירות מחדל להקלטת שיחות​

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

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

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

לדוגמא - את שם שדה פרטי 1 נשנה ל-מספר לקוח, את שם שדה פרטי 2 נשנה ל-שם לקוח וכדומה.

ניהול תגיות​

docs/system-settings/manage-tags.md

ניהול תגיות​

בחלק זה ניתן ליצור ולנהל תגיות.

הוספת תגית​

כדי להוסיף תגית חדשה, יש ללחוץ על . כעת תיפתח תיבה בה ניתן להזין את שם התגית:

חיפוש תגית​

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

עריכת שם תגית​

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

ניהול תגית (ניהול מספרים המשויכים לתגית)​

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

ניהול קבצי קול​

docs/system-settings/manage-sound-files.md

ניהול קבצי קול​

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

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

רשימת קבצי קול​

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

אולפן הקלטות טלפוני​

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

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

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

אולפן הקלטות אינטרנטי​

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

העלאת קבצי קול​

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

שימו לב: שם הקובץ חייב להיות באנגלית.

אולפן קול ממוחשב (Text to Speech)​

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

תהליך היצירה ב-4 שלבים​

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

צירוף קובץ קול למספר מסקיו​

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

ניהול רשימה שחורה​

docs/system-settings/manage-blacklist.md

ניהול רשימה שחורה​

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

כניסה למסך​

בתפריט הראשי יש ללחוץ על הגדרות מערכת ← רשימה שחורה.

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

המסך מציג טבלה של כלל החסימות הקיימות, עם עמודות של:

חיפוש וסינון​

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

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

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

שדות הטופס​

עריכה / הסרה​

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

ראו גם​

• אירוע אוטומציה — הוספה לרשימה שחורה
• יומן שינויים — לעקוב אחר מי הוסיף/הסיר מספר מהרשימה השחורה

יומן כניסות למערכת​

docs/system-settings/access-log.md

יומן כניסות למערכת​

יומן כניסות למערכת מציג את הכניסות האחרונות למערכת.

נתונים המופיעים בפירוט הכניסות​

• כתובת הדוא"ל - שם המשתמש שנכנס למערכת
• תאריך ושעת כניסה
• סטטוס הכניסה
• כתובת ה-IP ממנה בוצעה הכניסה

סיכומים​

בנוסף, מוצגים סיכומים של כמות כניסות למערכת:

• בשנה האחרונה
• בחודש האחרון
• בשבוע האחרון

יומן שינויים​

docs/system-settings/changes-log.md

יומן שינויים​

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

כניסה למסך​

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

מה נרשם ביומן​

כל שינוי על האובייקטים הבאים מתועד אוטומטית:

סינון ותצוגה​

מסננים​

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

עמודות היומן​

תצוגת הפרשים (Diff)​

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

• ירוק — ערכים חדשים / שדות שנוספו
• אדום — ערכים ישנים / שדות שהוסרו

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

ייצוא​

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

ראו גם​

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

הסרת מידע שיווקי (GDPR)​

docs/system-settings/gdpr-client-marketing-data-cleaner.md

הסרת מידע שיווקי (GDPR)​

GDPR = General Data Protection Regulation

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

הסרת מספר טלפון​

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

שלבי ההסרה​

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

תוספים (Plugins)​

docs/plugins/index.mdx

תוספים (Plugins)​

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

• 🟢 תוסף Google Ads — חיבור לממשקי גוגל — Google Ads + Google Analytics
  → ./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​

docs/plugins/google-ads/google-analyze-plugin.md

תוסף Google Ads​

רקע כללי​

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

צורות חיבור נתמכות​

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

1. שליחת Event ל Google Analytics עבור שיחות טלפון למספרי מסקיו - צורת חיבור זו דורשת הטמעת קוד בדף האינטרנט בו מוצג מספר הטלפון.

2. שליחת קוד המרות ל Google AdWords עבור שיחות טלפון למספרי מסקיו - צורת חיבור זו דורשת הטמעת קוד בדף האינטרנט בו מוצג מספר הטלפון וקוד בחשבון Google AdWords.

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

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

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

שלב 1 - יצירת אירוע שליחת נתונים לGoogle Analytics בסיום שיחה​

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

1. יש לגשת לאוטומציה ← הוספת אירוע חדש

2. שם אירוע - יש לתת שם לכלל (לדוגמא: שליחת נתונים לאנליטיקס) וללחוץ על הבא

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

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

5. פעולות לריצה - יש ללחוץ על +הוספת פעולה חדשה ולבחור באירוע Google Analytics:

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

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

שלב 2 - הפעלה והגדרת החיבור לGoogle Analytics וGoogle Ads לצורך הטמעת קודים​

1. בתפריט הראשי יש להיכנס לתוספים ← כלי הניתוח של גוגל

2. יש להפעיל את התוסף על ידי לחיצה על המתג OFF שיהפך ל-

3. יש ללחוץ על הוספת קישור (צד שמאל למעלה)

4. בלשונית תיאור יש להזין שם קישור. ללחוץ על הבא

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

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

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

8. קוד להטמעה - ללחוץ על שמור (הסבר על חלק זה ייעשה בנפרד)

9. לאחר השמירה תופיע שורה של הקישור עם הפרטים שהוגדרו:

שלב 3 - הטמעת קוד באתר האינטרנט לצורך שליחת נתונים לGoogle Analytics​

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

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

   חשוב

   לא להזין חשבון Tracking כדי שהנתונים יישלחו גם לGA4 במידת הצורך.

   

3. יש להעתיק את הקוד ולהטמיע אותו באתר (מומלץ לשים אותו ב-HEAD)

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

5. יש לגשת לחשבון האנליטיקס הרלוונטי ← לזמן אמת ← אירועים. במידה והכל תקין, אמור להופיע אירוע שנקרא Phone call from MaskYoo

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

7. יצירת המרה בגוגל אנליטיקס (GA4):

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

8. Google Ads - במידת הצורך, ניתן לייבא את ההמרות בחשבון הגוגל אדס (כלים ← המרות ← המרה חדשה + ← ייבוא ← Google Analytics (GA4) ← לבחור את היעד הרלוונטי ולייבא)

שלב 4 - הטמעת קוד בGoogle Ads לצורך שליחת נתונים למערכת מסקיו​

1. בתוסף כלי הניתוח והפרסום של גוגל - יש ללחוץ על קוד Google Adwords

   

2. יש להעתיק את הקוד

3. לפתוח את החשבון הרלוונטי בגוגל אדס

4. ללחוץ על כלים ← סקריפטים ← יצירת סקריפט חדש +

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

6. לתת שם לסקריפט

7. לשמור, לאשר ולהפעיל את הסקריפט

8. בניהול הסקריפטים יש לשנות את תזמון הפעלת הסקריפט לפעם בשעה (Hourly)

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

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

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

הגדרת המרה מקוד מסקיו בגוגל אדס​

docs/plugins/google-ads/setting_up_conversion_from_maskyoo_script_in_google_ads.md

הגדרת המרה מקוד מסקיו בגוגל אדס​

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

שלב ראשון - הטמעת סקריפט של מסקיו בגוגל אדס​

1. יש להיכנס למערכת מסקיו ← תוספים ← פעולות בכמות גדולה (Bulk Actions) ← סקריפטים (Scripts) ← יצירת סקריפט חדש

   

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

   

3. ללחוץ על שמירה (Save) ← לאשר את הסקריפט (Authorize) ← ללחוץ על הפעלה (Run) בלי תצוגה מקדימה (יכול להיות שתקפוץ עוד שורה של Authorize, שוב יש לאשר את הסקריפט ואז ללחוץ שוב על הפעלה)

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

   

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

שלב שני - הגדרת המרה בגוגל אדס​

מראה ישן של גוגל אדס​

1. יש לעבור להמרות: יעדים (Goals) ← סיכום (Summary)

   

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

   

3. יש להגדיר את קטגורית ההמרה לפי הצורך וללחוץ על הוספה

   חשוב

   שם ההמרה צריך להיות זהה לשם שהוגדר בקישור במערכת. ברירת המחדל במידה ולא שונה השם היא: Phone call from MaskYoo

   

4. לאחר לחיצה על הוספה יש ללחוץ על שמירה והמשך:

   

5. במסך הבא ללחוץ על סיום:

   

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

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

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

מראה חדש של גוגל אדס​

1. יש לעבור להמרות: יעדים (Goals) ← סיכום (Summary)

   

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

   

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

   

4. ללחוץ על סיום:

   

5. ללחוץ על שמירה והמשך:

   

6. ללחוץ על סיום:

   

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

   

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

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

קמפיינים דינאמיים​

docs/plugins/dynamic-campaigns/dynamic-campaigns.md

קמפיינים דינאמיים​

כיצד זה עובד?​

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

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

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

מוצר זה מצריך חיבור Google Analytics והטמעה חד-פעמית של קוד JavaScript באתר.

דוגמא​

• גולש א' אשר הגיע לאתרכם וירצה להתקשר אליכם יראה את המספר 077-6670000 באתר כמספר הטלפון שלכם
• לעומתו גולש ב' אשר הגיע לאתרכם באותו הזמן כמו גולש א' יראה את המספר 077-6670001 כמספר הטלפון שלכם, וכן הלאה לפי כמות מספרי המסקיו בקמפיין
• כאשר אחד מהגולשים יסיים את הגלישה באתר ישתחרר המספר באופן אוטומטי ויהפוך להיות זמין לגולש הבא

הגדרת קמפיין מספרים דינמיים​

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

שדות הטופס​

1. תיאור קמפיין — שם רצוי לקמפיין (לשימוש פנימי)
2. שיטת החלפת המספר בדף — בחירה בין class / id / css selector, לפי מה המערכת תאתר את מספר הטלפון המקורי ב-HTML
3. ערך להחלפה בדף — הערך הספציפי של ה-class/id/selector שמכיל את מספר הטלפון
4. מזהה חשבון Google Analytics — אליו יישלחו הנתונים
5. מאגר מספרי המסקיו הדינמיים — המספרים שיופיעו לסירוגין לפי גולשים. ניתן להוסיף/להסיר מספרים בכל עת
6. מספר סטטי (fallback) — המספר שיוצג במידה וכל המספרים הדינמיים תפוסים

הטמעת הקוד​

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

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

תמיכה נוספת​

ניתן לפנות לתמיכה הטכנית למספר 077-6670000 שלוחה 2 לעזרה בהגדרה ראשונית.

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

docs/plugins/website-call-wizard/referring-web-plugin.md

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

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

הגדרת תוסף אתרים מפנים​

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

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

   

2. יש להפעיל את התוסף על ידי לחיצה על המתג OFF שיהפך ל-

   

3. יש ללחוץ על . ייפתח המסך הבא:

שלב 2 - הגדרת פרטי התוסף​

• תיאור - בתיאור יש לרשום את שם האתר בו רוצים להפעיל את התוסף

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

  אופציה	תיאור
  החלפה על ידי טקסט נבחר מאתר האינטרנט	אופציה שאינה מומלצת לשימוש במידה ויש ברירה אחרת. במידה ונבחר חיפוש לפי טקסט, יש לרשום בשדה הבא את המספר/מספרים שברצוננו לחפש. יש לבצע בדיקות מקיפות לאחר הטמעת הקוד באתר! מכיוון שדרך חיפוש זו לוקחת משאבים רבים מהאתר
  החלפה על ידי CSS Selectors	במידה ובחרנו באופציה זו, יש להזין בשדה הבא את הסלקטור לפיו נחפש את המספר (class/id...) - בחירה בהחלפה לפי אופציה זו תחליף את המספר ויזואלית ומאחורי הקלעים במידה וקיים לינק
  החלפה על ידי CSS Selectors (Click-2-Call)	במידה ובחרנו באופציה זו, יש להזין בשדה הבא את הסלקטור לפיו נחפש את המספר (class/id...) - בחירה בהחלפה לפי אופציה זו תחליף את המספר רק מאחורי הקלעים במידה וקיים לינק

• CSS Selector - יש לרשום בשדה זה את הסלקטור/ים המתאים/ים

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

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

• לשמירת השינויים יש ללחוץ על הוספה

שלב 3 - צפייה בתוסף​

כעת יופיע התוסף בניהול התוספים:

שלב 4 - הטמעת הקוד באתר​

בכדי שהתוסף יפעל באתר, יש להטמיע קוד. יש ללחוץ על קוד הטמעה בשורת התוסף, להעתיק אותו ולהטמיע אותו באתר (רצוי ב-HEAD).

שלב 5 - ביצוע בדיקות​

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

למפתחים​

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/

הוספת טוקן לגישת API של מסקיו​

docs/developers/api/api-token.md

הוספת טוקן לגישת API של מסקיו​

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

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

מיקום ה-API TOKEN​

את ה-API TOKEN ניתן למצוא בממשק ב:

הגדרות מערכת ← הגדרות ← לשונית הגדרות API ← קוד גישה לממשקי API

ניתן להשתמש ב-TOKEN שמופיע או ליצור אחד חדש.

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.

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​

Example Request​

https://sms.deals/api/ws.php?service=send_sms&message=Hello%20World&dest=0501234567&sender=0501234567&token=YOUR_TOKEN

Code Examples​

PHP​

<?php
$msg = urlencode("Hello world sms");
$destination = "0521234567,0537654321"; // One or Multiple comma separated
$sender = "0531234567";
$token = "xxxxx...";

$url = "https://sms.deals/api/ws.php?service=send_sms";
$url .= "&message=".$msg."&dest=".$destination."&sender=".$sender;
$url .= "&token=".$token;

$options = array('http' => array(
    'method' => 'GET',
    'header' => 'Authorization: Bearer '.$token
));
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>

C# (.NET)​

using System;
using System.IO;
using System.Net;
using System.Text;

namespace Examples.System.Net {
    public class WebRequestGetExample {
        public static void Main() {
            string url_query_string = "https://sms.deals/api/ws.php?" +
                "service=send_sms&" +
                "message=Hello world sms&" +
                "dest=0521234567,0537654321&" +
                "sender=0531234567";

            WebRequest request = WebRequest.Create(url_query_string);
            string bearerToken = "xxxxxx...";
            request.Headers["Authorization"] = "Bearer " + bearerToken;

            WebResponse response = request.GetResponse();
            Console.WriteLine(((HttpWebResponse)response).StatusDescription);

            Stream dataStream = response.GetResponseStream();
            StreamReader reader = new StreamReader(dataStream);
            string responseFromServer = reader.ReadToEnd();
            Console.WriteLine(responseFromServer);

            reader.Close();
            response.Close();
        }
    }
}

Response​

<?xml version="1.0" encoding="UTF-8"?>
<SMS_Service>
    <service>send_sms</service>
    <sms_recipients>
        <sms_0>
            <Message_id>183804870</Message_id>
            <Send_time>2014-05-24 15:10:38</Send_time>
        </sms_0>
        <sms_1>
            <Message_id>183804880</Message_id>
            <Send_time>2014-05-24 15:10:38</Send_time>
        </sms_1>
    </sms_recipients>
    <Total_sms>2</Total_sms>
    <Total_Charge>2</Total_Charge>
</SMS_Service>

Response Variables​

Callback Parameters​

When using callback_url, you'll receive the following parameters:

Delivery Status Codes​

Bulk SMS - REST API​

docs/developers/api/sms-api/bulk-sms.md

REST API - Send Bulk SMS​

Send multiple SMS messages in one batch request.

Endpoint​

POST https://sms.deals/api/ws_json_bulk.php

Request Format​

Send a JSON array of SMS objects:

[
    {
        "service": "send_sms",
        "dest": "0501234567",
        "sender": "0541231231",
        "sendtime": "01/01/2020 12:00",
        "callback_url": "http://yoursite.com/page.php",
        "message": "Hello world User example 1"
    },
    {
        "service": "send_sms",
        "dest": "0521231232",
        "sender": "0541231232",
        "message": "Hello world User example 2"
    }
]

Code Examples​

cURL​

curl --location --request POST "https://sms.deals/api/ws_json_bulk.php" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer xxxxxx..." \
  --data '[
    {
        "service": "send_sms",
        "dest": "0521231231",
        "sender": "0521231221",
        "message": "Hello world User example 1"
    },
    {
        "service": "send_sms",
        "dest": "0541231221",
        "sender": "0541231231",
        "message": "Hello world User example 2"
    }
]'

PHP​

<?php
$curl = curl_init();
$token = "xxxxxx...";

$json = array(
    array(
        'service' => 'send_sms',
        'dest' => '0521231231',
        'sender' => '0541231231',
        'message' => 'Hello world User example 1'
    ),
    array(
        'service' => 'send_sms',
        'dest' => '0521231232',
        'sender' => '0541231232',
        'message' => 'Hello world User example 2'
    )
);

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://sms.deals/api/ws_json_bulk.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode($json),
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer " . $token,
        "Content-Type: application/json"
    ),
));

$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}
?>

Response​

[
    {
        "service": "send_sms",
        "status": "Message in Action",
        "message_id": 212131221,
        "message": "test",
        "sender": "0521231231",
        "dest": "0521231232",
        "sendtime": "2022-09-05 18:48:37",
        "total_charge": 1
    },
    {
        "service": "send_sms",
        "status": "Error - 403 Forbidden",
        "description": "Mandatory fields missing: token",
        "message": "test",
        "dest": "0531231231",
        "sender": "0531231241"
    }
]

Response Fields​

SOAP Web Service API​

docs/developers/api/sms-api/soap-api.md

SOAP Web Service API​

SOAP-API allows you to integrate your application to the Maskyoo SMS gateway using the SOAP protocol.

WSDL​

Code Examples​

PHP (NuSOAP)​

<?php
// Nusoap library 'nusoap.php' should be available
require_once('nusoap.php');

$wsdl = "https://www.sms.deals/api/ws_soap.php?WSDL";
$soap = new soapclient($wsdl, "wsdl");
$proxy = $soap->getProxy();

$message = "msg";
$dest = "0501234567";
$sender = "0501987654";
$sendtime = "";
$user = "[email protected]";
$pass = "password";
$callback_url = "";

$result = $proxy->send_sms($message, $dest, $sender, $sendtime, $user, $pass, $callback_url);
echo($result);
?>

C# (.NET)​

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using WindowsFormsApplication1.sms_deals;

namespace WindowsFormsApplication1
{
    public partial class Form1 : Form
    {
        private void button1_Click(object sender, EventArgs e)
        {
            var sms = new sms_deals.SoapSRV();
            string message = sms.send_sms("msg", "0501234567", "0501987654", "",
                "[email protected]", "password", "", "", "");
            MessageBox.Show(message);
        }
    }
}

Function Parameters​

The send_sms function accepts the following parameters:

Mail to SMS​

docs/developers/api/sms-api/mail-to-sms.md

Mail to SMS​

Send SMS by simply sending an email.

Configuration​

To enable Mail to SMS, support will need the following information:

• The domain name of the mail sender (From)
• The email address of the sender (From)

Email Format​

Multiple Recipients​

For multiple recipients, separate email addresses with semicolons:

[email protected];[email protected]

Example​

To send "Hello World" to phone number 0587654321:

Receive SMS API​

docs/developers/api/sms-api/receive-sms.md

Receive SMS API​

Receive inbound SMS messages on Maskyoo SMS phone numbers.

Overview​

When you purchase an SMS-enabled phone number, you can associate it with a URL. When someone sends a text message to that number, Maskyoo makes an HTTP request to your URL.

Webhook Format​

http://www.yoursite.com/yourpage.php?from=XXXXXXX&to=XXXXXXX&msg=XXXXXXXXXXXXXXXXXXX&time=2016-04-25%2010:00:00

Webhook Parameters​

Example Webhook Handler (PHP)​

<?php
// Receive incoming SMS webhook
$from = $_GET['from'] ?? '';
$to = $_GET['to'] ?? '';
$message = $_GET['msg'] ?? '';
$time = $_GET['time'] ?? '';

// Log the incoming message
$log = date('Y-m-d H:i:s') . " - From: $from, To: $to, Message: $message\n";
file_put_contents('sms_log.txt', $log, FILE_APPEND);

// Respond with 200 OK
http_response_code(200);
echo "OK";
?>

Setup​

To configure your webhook URL:

1. Log in to your Maskyoo account
2. Navigate to your SMS phone number settings
3. Enter your webhook URL in the designated field
4. Save the settings

Contacts API​

docs/developers/api/sms-api/contacts.md

REST API - Add Contact​

Add or update contacts in your account.

Endpoint​

GET https://sms.deals/api/ws.php?service=add_contact

Parameters​

Example Request​

https://sms.deals/api/ws.php?service=add_contact&sms_phone=0521234567&[email protected]&company=My%20Company&token=YOUR_TOKEN

PHP Example​

<?php
$company = urlencode("name of company");
$sms_phone = "0521234567";
$email = "[email protected]";
$token = "xxxxxx...";

$url = "https://sms.deals/api/ws.php?";
$url .= "service=add_contact";
$url .= "&sms_phone=".$sms_phone;
$url .= "&company=".$company;
$url .= "&email=".$email;

$options = array(
    'http' => array(
        'method' => 'GET',
        'header' => 'Authorization: Bearer '.$token
    )
);
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo($result);
?>

Updating Contacts​

To update an existing contact, use the same endpoint with the contact's phone number and include the new values. Use new_mobile_number to change the primary phone number.

Senders Management API​

docs/developers/api/sms-api/senders.md

Senders Management API​

Manage sender IDs for your SMS messages.

Add Sender Text​

Add a text sender ID to your account.

Endpoint​

GET https://www.sms.deals/api/ws.php?service=add_sender_text

Parameters​

PHP Example​

<?php
$token = "xxxxxx...";
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://sms.deals/api/ws.php?service=add_sender_text&sender=test",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "utf-8",
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer " . $token
    )
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Add Sender Phone​

Add a phone number as a sender ID (two-step verification process).

Step 1: Request Verification Code​

POST https://www.sms.deals/api/ws.php?service=add_sender_phone_step1

Step 2: Verify Code​

POST https://www.sms.deals/api/ws.php?service=add_sender_phone_step2

Get Sender List​

Retrieve list of approved senders.

Endpoint​

GET https://www.sms.deals/api/ws.php?service=get_sender_list

Parameters​

Response Example​

{
    "status": "success",
    "senders": [
        {
            "sender": "0541234567",
            "type": "phone",
            "description": "Main office",
            "verified": true
        },
        {
            "sender": "MyCompany",
            "type": "text",
            "description": "",
            "verified": true
        }
    ]
}

Credit API​

docs/developers/api/sms-api/credit.md

REST API - Get Credit​

Check your account SMS credit balance.

Endpoint​

GET https://sms.deals/api/ws.php?service=get_credit

Parameters​

Response​

<?xml version="1.0" encoding="UTF-8"?>
<SMS_Service>
    <service>get_credit</service>
    <username>[email protected]</username>
    <status>Success</status>
    <account_credit>-1</account_credit>
</SMS_Service>

Response Variables​

PHP Example​

<?php
$token = "xxxxxx...";
$params = array("service" => "get_credit");
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://www.sms.deals/api/ws.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "UTF-8",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode($params),
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer " . $token
    )
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

JSON Response​

Request with format=json:

{
    "service": "get_credit",
    "username": "[email protected]",
    "status": "Success",
    "account_credit": -1
}

REST API​

docs/developers/api/rest-api/index.md

Maskyoo REST API​

ה-REST API של מסקיו מאפשר גישה פרוגרמטית לניהול מספרי מסקיו, משתמשים, תגיות, רשימה שחורה, הקלטות, הודעות קוליות, שאילתות CDR והמרות Google Ads.

נקודות קצה​

נקודת הקצה הראשית:

https://[MASKYOO_URL]/api/

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

כל פונקציה נקראת על ידי העברת שם ה-service ב-query string או בגוף ה-POST (לדוגמה service=get_maskyoo). הפרמטרים יכולים להישלח ב-GET או POST; עבור העלאות קבצים יש להשתמש ב-multipart/form-data.

אימות (Authentication)​

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

1. הגבלת כתובות IP​

כתובת ה-IP של הלקוח חייבת להופיע ברשימת ה-IP המאושרות של החשבון (מוגדרת בממשק בהגדרות מערכת → הגדרות → לשונית הגדרות API). קריאה מ-IP לא מאושר מחזירה HTTP 401 Unauthorized - IP Address:'…' is not allowed.

2. Bearer Token​

אם מוגדר בחשבון ערך של קוד גישה ל-API, יש לצרף אותו בכותרת Authorization:

Authorization: Bearer YOUR_TOKEN_HERE

אם הטוקן חסר מוחזרת שגיאה 401 Unauthorized - Token Required; אם הוא פג תוקף – 401 Unauthorized - Token Expired; אם הוא לא שייך למערכת – 401 Unauthorized - Invalid Token.

לפרטים על יצירת טוקן ראו הוספת טוקן לגישת API.

דוגמה עם cURL​

curl -H "Authorization: Bearer YOUR_TOKEN_HERE" \
     -X GET "https://[MASKYOO_URL]/api/?service=get_maskyoo&maskyoo=0776670000&format=json"

פורמט בקשות​

כל ה-services תומכים גם ב-GET וגם ב-POST עם אותם פרמטרים. העלאות (upload_prompt) דורשות multipart/form-data.

בקשת GET​

https://[MASKYOO_URL]/api/?service=SERVICE_NAME&param1=value1&param2=value2

בקשת POST​

curl -H "Authorization: Bearer YOUR_TOKEN_HERE" \
     -X POST "https://[MASKYOO_URL]/api/" \
     -d "service=SERVICE_NAME" \
     -d "param1=value1"

פורמט תגובה​

פרמטר format קובע את פורמט הפלט:

המבנה הכללי של התגובה:

{
  "service": "get_maskyoo",
  "status": { "code": 200, "description": "ok" },
  "result": [ ... ]
}

• service – שם ה-service שנקרא.
• status.code – 200 בהצלחה, אחרת קוד שגיאה ייעודי ל-service (ראו בתיעוד של כל פונקציה).
• status.description – הסבר טקסטואלי.
• result – תלוי ב-service: אובייקט, מערך אובייקטים, או מחרוזת חופשית.

קטגוריות API​

דוגמאות בשפות תכנות​

PHP​

<?php
$base_url = "https://[MASKYOO_URL]/api/";
$token    = "YOUR_TOKEN_HERE";

$data = array(
    "service" => "get_maskyoo",
    "maskyoo" => "0776670000",
    "format"  => "json",
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $base_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Authorization: Bearer " . $token,
));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

C#​

using System.Net;
using System.Collections.Specialized;
using System.Text;

string url   = "https://[MASKYOO_URL]/api/";
string token = "YOUR_TOKEN_HERE";

using (var client = new WebClient())
{
    var values = new NameValueCollection();
    values["service"] = "get_maskyoo";
    values["maskyoo"] = "0776670000";
    values["format"]  = "json";

    client.Headers.Add("Authorization", "Bearer " + token);
    var response       = client.UploadValues(url, values);
    var responseString = Encoding.UTF8.GetString(response);

    Console.WriteLine(responseString);
}

קודי שגיאה כלליים​

כל service מחזיר קודי שגיאה נוספים ייעודיים לו (למשל 1xxx ל-CDR, 2xxx לרשימה שחורה, 3xxx לשיחות, 4xxx למסקיו, 5xxx לתגיות, 6xxx ליומן גישה, 7xxx-8xxx למשתמשים, 9xxx להודעות קוליות). פירוט מופיע בתיעוד של כל service.

מגבלות וזמני ריצה​

• בקשה יחידה יכולה לרוץ עד 10 דקות (רלוונטי בעיקר לשאילתות cdr_query כבדות ולהורדת הקלטות מהארכיון).
• upload_prompt: עד 50 MB לקובץ.
• חשבון מושעה לא רשאי להשתמש ב-API (יוחזר 401 Unauthorized - Account Suspended).

תמיכה​

לשאלות ותקלות פנו לתמיכת מסקיו.

ניהול מסקיו​

docs/developers/api/rest-api/maskyoo.md

ניהול מסקיו​

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

get_maskyoo​

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

Endpoint: /api/?service=get_maskyoo

פרמטרים​

שדות בתגובה​

description, maskyoo, maskyoo_old (רק אם תכונת שני המספרים מופעלת לחשבון), active_status, create_time, email, private_field1..10, sms_destination_phone, working_hours, out_of_time_destination_phone, callback_url, callback_url_option, greeting_in, ringback_tone, greeting_out, call_destination_phone, dial_option, dial_timeout_in_sec, record_percentage, record_option, extenstion, expose, disallow_callback, default_dest.

קודי שגיאה​

דוגמה​

curl -H "Authorization: Bearer TOKEN" \
     "https://[MASKYOO_URL]/api/?service=get_maskyoo&maskyoo=0776670000&format=json"

get_available_maskyoo​

החזרת רשימת מספרים פנויים להקצאה (לא מקצה – רק מחזיר).

Endpoint: /api/?service=get_available_maskyoo

פרמטרים​

קודי שגיאה​

create_maskyoo​

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

Endpoint: /api/?service=create_maskyoo

פרמטרים​

קודי שגיאה עיקריים​

דוגמה​

curl -H "Authorization: Bearer TOKEN" \
     -X POST "https://[MASKYOO_URL]/api/?service=create_maskyoo" \
     -d "description=Main office" \
     -d "call_destination_phone=972544224422,972544224423" \
     -d "dial_option=1" \
     -d "record_percentage=100" \
     -d "record_option=2" \
     -d "format=json"

update_maskyoo​

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

Endpoint: /api/?service=update_maskyoo

פרמטרים​

זהים ל-create_maskyoo, כאשר:

• חובה: maskyoo, description.
• כל שאר הפרמטרים אופציונליים; רק ערכים שנשלחים יתעדכנו.

קודי שגיאה עיקריים​

דוגמה​

curl -H "Authorization: Bearer TOKEN" \
     -X POST "https://[MASKYOO_URL]/api/?service=update_maskyoo" \
     -d "maskyoo=972776670000" \
     -d "description=Updated" \
     -d "call_destination_phone=972544224422" \
     -d "record_percentage=50" \
     -d "format=json"

release_maskyoo​

שחרור מספר מסקיו מהחשבון. המספר חוזר למאגר המספרים הזמינים.

Endpoint: /api/?service=release_maskyoo

פרמטרים​

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

קודי שגיאה​

restore_maskyoo​

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

Endpoint: /api/?service=restore_maskyoo

פרמטרים​