פיתוח פרטי | 📋📲 מודול ניהול רשימת צינתוקים מתקדם

CUBASE

שלום לכולם!

דגש חשוב כבר בהתחלה: המודול מוגדר כברירת מחדל לעבוד עם קבצי שמע מוקלטים תחת תקיית ההודעות של סמארטל. אם לא העליתם את קבצי השמע של המודול, חובה להוסיף ב-ext.ini את ההגדרה api_add_X=use_tts=yes כדי שהמערכת תתבסס על הקראה קולית (TTS)!

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

היתרונות המרכזיים על פני המודול המובנה:

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

️ שלב 1: הגדרות חובה ב-ext.ini

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

type=api
api_link=https://moduls.smartel.workers.dev/tzintukManagment.php
api_add_0=token=YOUR_API_TOKEN

(יש להחליף את YOUR_API_TOKEN בטוקן הגישה של המערכת.)

️ שלב 2: הגדרות רשות ושדרוגים (אופציונלי)

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

1. הפעלת הקראה קולית (TTS) למערכות ללא קבצי שמע

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

api_add_1=use_tts=yes

2. הגדרת רשימת צינתוקים קבועה מראש

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

api_add_2=list_tzintuk=123

3. הגדרת מצב השמעה ישיר (ללא תפריט ראשי)

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

האזנה ישירה למספרי הרשומים בלבד:

api_add_3=display_mode=numbers_only

האזנה ישירה ללוג הפעולות בלבד:

api_add_3=display_mode=log_only

4. דילוג על השמעת הנתונים הסטטיסטיים

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

api_add_4=say_summary=no

5. שיבוץ והתאמת מקשי התפריט הראשי

ניתן לקבוע אילו אופציות יושמעו במקשים 1, 2 ו-3 בתפריט הראשי, או לבטל מקש מסוים על ידי הגדרת noop.
מקשי ברירת המחדל:

1 = האזנה למספרי הרשומים
2 = האזנה ללוג הפעולות
3 = מעבר למודול ניהול הרשימה

דוגמה לשינוי המקשים (למשל: מקש 1 לניהול, מקש 2 למספרים, וביטול מקש הלוג):

api_add_5=menu_option_1=3
api_add_6=menu_option_2=1
api_add_7=menu_option_3=noop

אופן הניווט וההאזנה בשלוחה

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

️ קבצי שמע והודעות מערכת

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

הודעות מערכת מובנות בשימוש:

M1224 - בחירה לא חוקית
M4161 - הקישו
M4353 - השלוחה לא הוגדרה בצורה תקינה
M1080 - שגיאה
M4108 - מתוכם, כמות המספרים הפעילים היא
M4109 - וכמות המספרים המושתקים היא
M1347 - אין נתונים להשמעה
M1483 - בתאריך
M1485 - בשעה

קבצי שמע מותאמים אישית:

אם אינכם משתמשים ב-use_tts=yes, יש להעלות את קבצי השמע המוקלטים שלכם לנתיב /Smartel/Messages/ במערכת (מספר הקובץ עם קידומת S, למשל S1050.wav) :

S1050 - בחרו רשימת צינתוקים
S1051 - סך הכל
S1052 - רשומים ברשימה
S1053 - וכמות המספרים המוזמנים שטרם אישרו את ההזמנה היא
S1054 - במצב פעיל
S1055 - במצב חסום
S1056 - הוזמן לרשימה
S1057 - להשמעת מספרי הרשומים
S1058 - להשמעת לוג הפעולות על הרשימה
S1059 - למעבר למודול ניהול הרשימה
S1060 - להשמעת עשרת המספרים הקודמים הקישו אפס
S1061 - אין מספרים נוספים להשמעה
S1062 - להשמעת עשר הפעולות הקודמות הקישו אפס
S1063 - אין פעולות נוספות להשמעה
S1064 - אין אפשרויות זמינות כרגע
S1065 - הוספה לרשימה
S1066 - הפעלת צינתוק
S1067 - הסרה מהרשימה
S1068 - מנהל הסיר מהרשימה
S1069 - מנהל חסם מהרשימה
S1070 - מנהל הזמין לרשימה
S1071 - דחיית הזמנה לרשימה
S1072 - אישור הזמנה והוספה לרשימה
S1073 - איפוס הרשימה
S1074 - על ידי מספר טלפון
S1075 - הפעולה בוצעה בשלוחה
S1076 - על מספר טלפון

ניתן להוריד את כל הודעות המערכת בקבצים מוכנים (להוסיף p לסיומת הקובץ)

תרגישו חופשי לשאול שאלות, להעלות רעיונות ולשתף איך המודול עובד אצלכם במערכת בשרשור התגובות
האזנה נעימה!