קבלת הסמסים שהתקבלו למערכת

הפקודה היא - GetIncomingSms

בכל פניה יש לצרף:

פרמטר תיאור הערות token טוקן limit הגבלת תוצאות ברירת מחדל 100 תוצאות. מקסימום 3000. startDate מתאריך למשל: 2025-06-01 19:48:01 endDate עד תאריך למשל: 2025-06-03 00:00:00

מענה בעת הצלחה

מאפיין סוג תיאור דוגמה responseStatus string סטטוס הפעולה OK rows array מערך סמסים שהתקבלו יבואר מטה

מבנה סמס במערך rows

מאפיין סוג תיאור דוגמה source string מקור 972773137770 destination string יעד 972773137770 message string תוכן ההודעה הודעת בדיקה receive_date string תאריך קבלת ההודעה 2025-06-03 19:58:03

קופונים 🎁 הנחת קופונים בסליקת אשראי ℹ️ הסבר

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

✨ הפעלת אפשרות קופונים

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

credit_card_discount_coupons=yes 📄 הוספת קופונים

יש להכניס את הקופונים לקובץ:

CouponDiscount.ini

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

🧮 סוגי הנחות

ניתן להגדיר שני סוגי קופונים:

הנחה באחוזים – למשל:

1234=25%

קופון מספר 1234 מקנה 25% הנחה.

הנחה בסכום קבוע (ש"ח) – למשל:

4567=30

קופון מספר 4567 מקנה 30 ש"ח הנחה.

🔢 הגבלת מימושים 1. הגבלה גלובלית לכל הקופונים: discount_coupons_quantity_limit=10

בדוגמה, כל קופון ניתן למימוש עד 10 פעמים.

2. הגבלה ספציפית לכל קופון

ההגדרה מתבצעת באותו קובץ שבו מגדירים את הקופונים (CouponDiscount.ini) – פשוט מוסיפים פסיק וכמות מקסימלית.

דוגמה:

1234=25%,5 4567=30,4

בפירוט:

1234 – 25% הנחה, עד 5 מימושים. 4567 – 30 ש"ח הנחה, עד 4 מימושים.

כמות המימושים נשמרת אוטומטית בקובץ: CouponDiscountAmoun.ini

📊 נתונים בדוחות הסליקה

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

initialAmount=סכום לפני ההנחה CouponCode=קוד הקופון שהוזן DiscountAmount=סכום ההנחה בפועל

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

שלוחה לניהול הטריוויה = הקלטת השאלות

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

מלבד הגדרת סוג השלוחה שיש להגדיר כמו בשלוחת הטריוויה עצמה

type=trivia_questions

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

trivia_type=admin

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

trivia_questions_val=2

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

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

record_trivia_american=yes

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

record_trivia_yes_no=yes

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

trivia_questions_location=always

על סוגי החלפת השאלות (יומי/שבועי/קבוע) - ראו בהמשך.

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

במהלך שיחה פעילה של נציג עם לקוח, הנציג יכול לבצע פעולות שישפיעו על השיחה של הלקוח
הפעולות הניתנות לביצוע

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

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

הסבר על צורת ההגדרות

שימו לב! כל ההגדרות הן בקובץ הגדרות שלוחה ext.ini

ראשית יש להגדיר את המקש הרצוי
ההגדרה היא

dial_key_0=פעולה למקש 0 dial_key_1=פעולה למקש 1 dial_key_2=פעולה למקש 2 dial_key_3=פעולה למקש 3 dial_key_4=פעולה למקש 4 dial_key_5=פעולה למקש 5 dial_key_6=פעולה למקש 6 dial_key_7=פעולה למקש 7 dial_key_8=פעולה למקש 8 dial_key_9=פעולה למקש 9

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

החזקת שיחה

יש להגדיר

dial_key_X=hold כמובן שבמקום X יש לרשום את המקש הרצוי

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

המנגינה שמושמעת

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

dial_key_music_on_hold=שם המוזיקה שלכם

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

העברת הלקוח לשלוחה במערכת

בפעולה זו, יש 3 הגדרות אפשריות

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

יש להגדיר (דוגמה)

dial_key_X=move_client_to_folder-4/2

בדוגמה, בהקשה על המקש שהוגדר המאזין יועבר לשלוחה 4/2 (כמובן שניתן להגדיר כל שלוחה אחרת).

תפריט בחירת שלוחה והעברה לשלוחה שנבחרה

יש להגדיר

dial_key_X=menu_move_client

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

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

הגדרה זו הינה הגדרת המשך להגדרה הקודמת.

dial_key_menu_move_client_folder_first=/1

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

ניתוב הלקוח למספר טלפון אחר

גם כאן, בדומה לפעולה הקודמת, יש 2 הגדרות אפשריות:

ניתוב ישיר למספר מסוים תפריט הקשת מספר וניתוב למספר שהוקש ניתוב ישיר למספר מסוים

יש להגדיר

dial_key_X=routing_client_to_number-0501234567

כמובן שבמקום 0501234567 יש לרשום את המספר הרצוי לניתוב

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

יש להגדיר

dial_key_X=menu_routing_client

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

הגדרת מספר חיוג מקוצר

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

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

סדר הכתיבה בקובץ DialKeyAbbreviatedDialing.ini:

מפתח: חיוג מקוצר
ערך: מספר להפניית השיחה

1=0773137770 770=0772222770 1234=0773137777

בדוגמה הנ"ל:
שורה 1: הקשה על ניתוב השיחה למספר 1 תנתב את השיחה למספר 0773137770
שורה 2: הקשה על ניתוב השיחה למספר 770, תנתב את השיחה למספר 0772222770
שורה 3: הקשה על ניתוב השיחה למספר 1234, תנתב את השיחה למספר 0773137777

הודעות מערכת:
M3983 המספר שהוקש הוא
M3984 לאישור הקישו 1 - לשינוי הקישו 2

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

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

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

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

הודעות מערכת

M3337 "להפעלת צינתוק הקישו 1 למחיקת מספר מרשימת הצינתוקים הקישו 2 לאיפוס כל רשימת הצינתוקים הקישו 3 לשמיעת כמות הנרשמים הקישו 4 ליציאה הקישו כוכבית וסולמית"
M3338 "הצינתוק הופעל בהצלחה"
M3339 "נא הקישו את המספר למחיקה ובסיום הקישו סולמית"
M3340 "המספר נמחק בהצלחה מרשימת הצינתוקים"
M3341 "המספר שהקשתם לא מופיע ברשימת הצינתוקים"
M3342 "שימו לב לאחר האיפוס לא ניתן יהיה לשחזר את המספרים האם הינכם בטוחים? לאישור האיפוס הקישו 1 לביטול ויציאה הקישו 2"
M3343 "איפוס רשימת הצינתוקים הסתיים בהצלחה"
M4101 סך כלל הנרשמים לרשימה זו
M4102 רשימת הצינתוקים ריקה
M4108 מתוכם, כמות המספרים הפעילים היא
M4109 וכמות המספרים המושתקים היא
M4837 אנא הקישו את המספר לחסימה, ובסיום הקישו סולמית
M4838 המספר שהקשתם הוגדר כחסום

M4839 הקליטו את שם המערכת אותו ברצונכם להשמיע למזמין ובסיום הקישו סולמית
M4351 אנא הקישו את מספר הטלפון איליו תרצו לשלוח את ההזמנה. בסיום הקישו סולמית. לחזרה הקישו כוכבית וסולמית
M4352 שיחת ההזמנה נשלחה בהצלחה
M4353 שלוחה זו לא הגודרה בצורה תקינה.
M4354 מספר הטלפון שלכם לא מזוהה או לא תקין
M4355 קובץ ההזמה ארוך מ6 שניות. יש לפנות למנהל המערכת
M4356 מספר הטלפון שהוקש אינו תקין
M4357 לא ניתן להזמין את מספר הטלפון הזה, יתכן שהוא קיים ברשימה

הגדרות גלובליות שמירת נקודת עצירה

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

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

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

last_play_from=id

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

סינון תוצאות

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

סוג עצירה (פרמטר סינון)

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

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

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

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

last_play_stop_type=hangup last_play_stop_type=exit

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

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

last_play_from_folders=כאן יש לרשום את השלוחות מתחילת המערכת ולהפריד בין שלוחה לשלוחה עם פסיק

לדוגמה

last_play_from_folders=1/2,2/2

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

last_play_from_folders=/1* last_play_from_folders=/1*,/2,/30*

במקרה כזה, המערכת תחפש את כל ההאזנות בשלוחה 1 ובכל השלוחות שמתחת לשלוחה 1

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

last_play_from_folders=tfr

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

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

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

last_play_from_incoming_did=yes

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

last_play_from_incoming_did=0772222770,0773137770

בדוגמה, המערכת תשמיע רק האזנות שהיו בחיוג למספרים 0772222770 או 0773137770

השמעת המיקום

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

say_last_play_location=yes

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

הודעות מערכת

M1018 אין נתונים על השמעה אחרונה
M1473 ההשמעה אותה שמעת לאחרונה, בתיקייה
M1474 האזנה מספר
M1475 עצרת בדקה
M1476 אורך ההשמעה
M1477 דקות
M4377 הקובץ אליו האזנתם לאחרונה נמחק
M4378 השלוחה אליה האזנתם לאחרונה נמחקה