קבלת הקלטות ונתונים (למייל)

[אאד]

הסבר על המודול:
ראשית נפשט את המילים "הקלטות" ו"נתונים"
וכן מי מקבל אותם? איך? מתי? ולמה?
וכו'

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

יש את האפשרות הפרימיטיבית - להושיב כמה מזכירות ו...

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

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

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


יופי, אז עשינו סדר בעניינים, מה עכשיו?
עכשיו אנחנו מקליטים שלושה "שאלות"
1 - "אנא הקליטו את שמכם ושם משפחתכם, ולסיום הקישו סולמית"
2 - "אנא הקליטו את עיר המגורים שלכם, ולסיום הקישו סולמית"
3 - "אנא הקישו את גילכם, (בשתי ספרות)"

יצא ברור? ברוך השם!

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

איך נגדיר את זה?
אז ככה:
שם ההקלטה שהקלטנו הוא זה שיגדיר למערכת אם הנרשם הולך להקליט או להקיש

לא הבנתם, נכון?
לא נורא, אני יסביר:
כשאנחנו 'מעלים' את ההקלטה שהקלטנו "אנא הקליטו..." (מס' 1)
שאז הנרשם צריך להקליט
שם ההקלטה יהיה "000"
ואחריו נעלה עוד הקלטה (מס' 2)
והשם שלו יהיה "001"

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


החילוק בין שניהם זה החילוק בין "הקלטות" ל"נתונים"
כל פעם שאנחנו רוצים שהנרשם יקליט - זה נקרא "קבלת הקלטות"
וכל פעם שאנחנו רוצים שהנרשם יקיש - זה נקרא "קבלת נתונים"

יופי - סוף סוף הבנו מה זה "מודול קבלת הקלטות ונתונים"
עכשיו למעשה...
בהצלחה

----------------

[אאד]

ההגדרה של המודול:

קוד: בחירת הכל

type=recording_and_entering_data

מיקום ההקלטות:
שימו לב! הכוונה להקלטות 1-2-3 שבדוגמה, (ולא הקלטות שמאזינים מקליטים)

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

קוד: בחירת הכל

recording_and_entering_data_folder_to_play=/8

בדוגמה מוגדר שהמערכת תיקח את ההקלטות משלוחה 8 (שתחת תיקיה ראשית)
---

שמות הקלטות:
שמות הקלטות של "קבלת הקלטות"
(1ו2 בהקדמה), יהיה בין 000-049
הקובץ הראשון חייב להיות בשם 000 וכל השאר עוקבים אחריו

שמות הקלטות של "קבלת נתונים"
(3 בהקדמה), יהיה בין 050-099
הקובץ הראשון חייב להיות בשם 050 וכל השאר עוקבים אחריו

סדר ההקלטות:
ברירת מחדל הוא שקודם מקבל הקלטות ואח"כ מקבל נתונים,
כלומר מתחיל בקבצים 000-049 ולאחר מכן עובר ל 050-099

באם רוצים שיתחיל מקובץ 050 ומעלה,
ורק אח"כ מקובץ 000
כלומר קודם נתונים ואח"כ הקלטות
יש להגדיר:

קוד: בחירת הכל

start_first=data

(ברירת מחדל כאלו מוגדר start_first=recording )

------

[אאד]

מה מגדירים:

הסבר על ההגדרות של מאפייני הקובץ

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

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

אבל זה יעזור רק אם הוא (המקליט-הזקן) נמצא במקום שקט
אך במצב שיש מסביבו רעש או שהוא נושם בקול אז זה לא יעזור - כי אין שניות של שקט

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

---

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

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

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

קוד: בחירת הכל

XXX-option=

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

---

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

קוד: בחירת הכל

000-option=2

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

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


הגדרה שניה:
מקסימום אורך הקלטה
כפי שהסברתי לעיל - אם אנחנו רוצים להגביל את אורך ההקלטה לכמות שניות מסויימת
נוסיף למה שכבר כתבנו (000-option=2) מקף 6
ככה:

קוד: בחירת הכל

000-option=2-6

בדוגמה מופיע מקסימום 6 שניות

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


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

קוד: בחירת הכל

000-option=2-6-STT

(שזה ראשי תיבות של Speech to text כלומר דיבור לטקסט)


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

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


הגדרה רביעית
האם להמיר את הטקסט בחזרה לקול של המערכת ולהשמיע ללקוח, ברירת מחדל המערכת רק ממירה ושמה בקובץ אבל לא משמיע ללקוח,
בשביל שישמיע ללקוח את ההמרה של כל הדיבור יש להגדיר TTS ראשי תיבות של
text to Speech כלומר טקסט לדיבור
במקרה שבו הטקסט שיתקבל חזרה אמור להיות מספרים או אותיות באנגלית ניתן להגדיר גם את האפשרויות הבאות:
Number להשמעה בצורת מספר
Digits להשמעה בצורת ספרות
Alpha להשמעת האותיות באנגלית


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

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

קוד: בחירת הכל

000-option=6-40

או

קוד: בחירת הכל

001-option=6-40-STT-TTS-ask

או

קוד: בחירת הכל

002-option=--STT

כפי שרואים בדוגמאות לא חייב לשים את כל הערכים,
ניתן לדלג על ערכים 1 ו2 (שאר כברירת מחדל) ולהפעיל רק את אפשרות 3 , או 3 ו4 , או 3 ו 4 ו 5

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

קוד: בחירת הכל

record_ok=#

[אאד]

הגדרות ברירת מחדל
1) מספר ספרות מקסימלי - ללא הגבלה,
2) מספר ספרות מינימלי -לפחות סיפרה אחת,
3) זמן (בשניות) להמתנה עד להודעה "לא הוקשה בחירה - 10 שניות
4) משמיע את המספר שהקישו בצורת מספר (Number) כלומר 22 יהיה "עשרים ושתים"
ניתן לשנות את ההגדרה להשמעה בצורת ספרות (Digits) כלומר 22 המערכת תשמיע "שתים שתים"
ניתן גם להגדיר SayFile. פירוט בהמשך.
כמו כן ניתן להגדיר No ואז הלקוח לא ישמע את הספרות בכלל אלא יתקדם לתפריט האישור.
5) ברירת מחדל לאחר שהלקוח מקיש את הספרות, הוא משמיע את הספרות ללקוח ומבקש אישור, אם רוצים שלא יבקש אישור אלא מיד ידלג כאלו הלקוח אישר, יש להכניס בערך החמישי AskNo

אם רוצים לשנות הגדרות ברירת מחדל יש להכניס בקובץ
XXX-option=
כאשר XXX = מספר הקובץ של ההשמעה, לדוגמא 050 או 051 וכו'
דוגמא לעריכת קובץ 052
למה שבתוך קובץ

קוד: בחירת הכל

052-option=9-3-7-Digits-AskNo

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


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

כך שאם רוצים למשל בקובץ 053 לדוגמא במידה והלקוח הקיש 1 להשמיע
"מלפפונים" ובמקש 2 "עבניות"

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

[אאד]

ניתן להכניס קובץ שיושמע בהתחלה
M0000.wav

וכן קובץ שיושמע לאחר קבלת האישור נתונים
M0099.wav
או במקום הודעה M0099 את קובץ M1447 - נרשמת בהצלחה


הקבצים השייכים

M1001 המקש שֶהוֹקַש שגוי
M1002 לא הוקשה בחירה
M1034 לאישור הקישו 1, להקשה מחודשת 2.
M1035 לא הקּשתּם את מינימום הספרות הנדרשות
M1056 להלן הפרטים שנקלטו
M1057 לאישור הקישו 1 לשמיעה חוזרת 2 להקלטה מחדש הקישו 3
M1340 נרשמת בהצלחה, אישור מספר
M1341 "לסיום הקישו 1.
לשמיעת מספר האישור פעם נוספת הקישו 2."
M1347 אין נתונים להשמעה
M1348 הרשמה זו התמלאה והסתיימה. שלום ותודה.

[אאד]

ההקלטות נשמרות בתוך תיקית Record שבתוך התיקיה, בשם הקובץ נמצאים כל הפרטים שהוקשו. ובתוך הקובץ עצמו כל הפרטים שהוקלטו.
בנוסף יש בתוך התיקיה קובץ בשם LogRecordingAndEnteringData.html
ובו כל הפעולות שהלקוח ביצע והכניס - שלב אחר שלב.

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


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

קוד: בחירת הכל

recording_and_entering_data_copy_to_folder=8/6

בדוגמא כאן רואים שהקובץ ישוכפל גם לתיקיה 8/6 שתחת התיקיה הראשית של הלקוח

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

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

קוד: בחירת הכל

recording_and_entering_data_copy_to_folder_type=next_file_number

[אאד]

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

קוד: בחירת הכל

skip_key=0
save_and_exit=0

בדוגמה רואים שע"י מקש 0 יוכל לסיים את הרישום

שימו לב! יש לציין בהקלטת השאלה - שאם רוצים לסיים את הרישום או שהשאלה הבאה לא רלוונטית לנשאל - יש להקיש .. וסולמית.
ואז הנרשם יועבר לשמיעת הודעת הסיום של הרישום

[אאד]

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

קוד: בחירת הכל

set_ok_send_mail=yes

במייל יגיע ההקלטה שהנרשם הקליט + קובץ ApprovalAll.html

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

קוד: בחירת הכל

set_ok_send_mail_special=yes

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

קוד: בחירת הכל

set_temp_send_mail=yes

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

קוד: בחירת הכל

recording_and_entering_data_email_address=AAA@gmail.com

כאשר במקום AAA@gmail.com
אתם רושמים את הכתובת שאליו ישלח המייל

[קימבוניישן]

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

[אאד]

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

קוד: בחירת הכל

recording_and_entering_data_end_goto=/8

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

קוד: בחירת הכל

recording_and_entering_data_end_goto=hangup

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

קוד: בחירת הכל

recording_and_entering_data_error_goto=/8

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

קוד: בחירת הכל

recording_and_entering_data_error_goto=hangup