פיתוח פרטי | 🚀 מודול הקלטה וניתוב חכם Pro – הגרסה המשודרגת!

CUBASE

מודול "הקלטה וניתוב חכם Pro" – המדריך המלא והמשודרג!

שלום חברים!

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

איך המודול עובד בפועל? תהליך פשוט ב-2 שלבים:

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

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

בואו נגדיר את זה יחד, צעד אחר צעד:

🧠 שלב 1: שלוחת הניהול (המוח של המודול)

בחרו שלוחה במערכת (לדוגמה שלוחה 1).
העתיקו אליה תחילה את הגדרות החובה הבאות:

type=api
api_link=https://record-routing.onrender.com/recordRoutingPro.php

; חובה להחליף בטוקן של המערכת שלכם
api_add_0=token=טוקן_ההתחברות_שלכם

; לאיזו שלוחה יעברו ההקלטות כדי שאנשים ישמעו אותן? (לדוגמה: שלוחה 2)
api_add_1=path=/2

️ הגדרות רשות (שדרוגים לשלוחה זו):
רוצים להוסיף יכולות מתקדמות? הוסיפו את ההגדרות הבאות בהתאם לצורך שלכם (שימו לב למספר את ה-api_add לפי הסדר: 2, 3, 4 וכו').

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

api_add_X=say_tts=yes

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

api_add_X=ext_ini=queue_end_goto=/%0Aqueue_record_send_mail=yes

הזרקת הגדרות לקובץ queue.ini של שלוחת הניתוב: למשל, קביעת זמן המתנה לשיחה וכמות ניסיונות.

api_add_X=queue_ini=timeout=20%0Aretry=5

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

api_add_X=route_expire=24h

טבלת אפשרויות להגדרת זמני תפוגה (route_expire) :

פורמט הגדרה	הסבר	דוגמה לשימוש	משמעות הדוגמה
ספרות בלבד	מחושב כשניות	`3600`	הניתוב יפוג בעוד שעה
שעות ודקות (`HH:MM` או `HH:MM:SS`)	מחושב במדויק	`01:30`	שעה וחצי
אותיות קיצור אנגלית	`s`=שניות, `m`=דקות, `h`=שעות, `d`=ימים, `w`=שבועות	`2d 12h`	יומיים ו-12 שעות

️ שלב 2: שלוחת ההקלטה (`record`)

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

הכניסו לשלוחת ה-record את ההגדרות הבאות:

; ביטול הקראת מספר ההקלטה ותפריט האישור (כדי לזרז למקליט את התהליך)
say_record_number=no
say_record_menu=no

; חובה! ההגדרה שמעבירה את המקליט להמשך התהליך במודול
record_end_goto=After

פעולת חובה בשלוחה זו - השתקת קובץ M1452:
קובץ ההודעה M1452 אומר "ההודעה הוקלטה בהצלחה". חובה עליכם להשתיק אותו (על ידי העלאת קובץ שקט בשם M1452.wav לתוך השלוחה).
למה? ברגע שההקלטה מסתיימת, המודול מעביר את המשתמש אוטומטית לשלוחה וירטואלית שמשמיעה לו בעצמה שההקלטה עברה בהצלחה. אם לא תשתיקו את הקובץ כאן, המקליט ישמע את האישור פעמיים ברצף.

שלב 3: שלוחת ההשמעה למאזינים

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

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

אפשרות 1 - מקש ישיר תוך כדי השמעה (לדוגמה מקש 9):

control_play9=send_api
api_link=https://record-routing.onrender.com/recordRoutingPro.php
api_add_0=token=טוקן_ההתחברות_שלכם

*אפשרות 2 - דרך תפריט "אפשרויות נוספות" (לדוגמה הקשת 8):

control_play_moreA8=send_api
api_link=https://record-routing.onrender.com/recordRoutingPro.php
api_add_0=token=טוקן_ההתחברות_שלכם

אפשרות 3 - מעבר אוטומטי מיד לאחר סיום שמיעת ההקלטה:

after_play=send_to_api
api_link=https://record-routing.onrender.com/recordRoutingPro.php
api_add_0=token=טוקן_ההתחברות_שלכם

️ הגדרות רשות (שדרוגים לשלוחת ההשמעה):
(שימו לב למספר את ה-api_add בהתאם).

הקראה רובוטית להוראות:

api_add_X=say_tts=yes

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

api_add_X=allowed_manage_route=0531111111,0542222222

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

api_add_X=fallback_to_recorder=yes

שלב 4: הודעות מערכת

אם לא בחרתם להשתמש בהגדרת ההקראה הרובוטית (say_tts=yes), עליכם להקליט את ההודעות הבאות בקולכם ולהעלות לתיקייה Smartel/Messages/ בתוך המערכת.

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

S1010 - "אנא הקישו את מספר הטלפון אליו תרצו לנתב את השיחה, ובסיום הקישו סולמית."
S1011 - "למעבר למספר הטלפון השמור במערכת הקישו 1, לחזרה הקישו 2."
S1012 - "תוקף הניתוב לקובץ זה פג, או שלא הוגדר יעד לניתוב."
S1013 - "לביטול הניתוב הקיים הקישו 1, לעדכון מספר חדש לניתוב הקישו 2, למעבר לניתוב הנוכחי הקישו 3."
S1014 - "אנא הקישו את מספר הטלפון החדש לניתוב, ובסיום הקישו סולמית."
S1015 - "לא הוגדר מספר טלפון לניתוב עבור קובץ זה."
S1016 - "הניתוב בוטל בהצלחה."
S1017 - "מספר הטלפון לניתוב עודכן בהצלחה."

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

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