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

הבעיה היא שכרגע המצב שאין אפשרות שפרמטר שנשלח יהיה חלקו קבוע וחלקו יוקלד ע"י המשתמש, כגון אם יש לי נתיב כזה ivr2:7/6/98/45/8 שבתוכו יש שתי קבצים 000.tts ו-001.tts ואני רוצה שהמשתמש יבחר איזה קובץ לערוך אין אפשרות שהוא יקיש רק 000 או 001, אלא צריך להגדיר פרמטר זה כמוקלד ע"י המשתמש והוא יצטרך כל פעם להקליד את כל הנתיב כולל הסיומת באנגלית.

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

הפתרון

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

https://script.google.com/macros/s/AKfycbz9Ft1E-zdy0pykE2yWHmyCrpmzDGtMR06-dI_UO2x1AItuYP8e2AMP4qr7Hq_Q9oKFwQ/exec

(וכן, הוא גם 'יודע' להתגבר על הבעיה של פניות משרתי גוגל).

הוראות הפעלה

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

• הכתובת תהיה הכתובת הנ"ל ולא הכתובת של ימות המשיח או כתובת אחרת.

• הכתובת הרצויה לשליחת הבקשה תופיע בפרמטר url, באם לא יהיה כזה פרמטר כתובת ברירת המחדל היא של ימות המשיח (https://call2all.co.il/ym/api/). בשליחה לימות המשיח אין צורך לכתוב את הפרמטר.

• הפקודה הרצויה (כגון getQueues ,CreateTemplate וכדומה) תופיע בפרמטר command.

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

what=ivr2:7/6/98/45/8/{path1}.tts

ואז להגדיר פרמטר שהמשתמש מזין בשם הנ"ל, כגון path1, ובו הוא יזין 001 או 002 וכדומה.

דוגמאות:

type=api
api_link=https://script.google.com/macros/s/AKfycbz9Ft1E-zdy0pykE2yWHmyCrpmzDGtMR06-dI_UO2x1AItuYP8e2AMP4qr7Hq_Q9oKFwQ/exec
api_add_0=command=UploadTextFile
api_add_1=token=079-------:------
api_add_2=what=ivr2:7/6/98/45/8/{path1}.tts
api_000=path1,,,,,Digits
api_001=contents,,,,,HebrewKeyboard

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

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

api_add_3=contents=עד כה עודכנו {number1} הזמנות
api_001=number1,,,,,Digits

וכן הלאה על זה הדרך.

בהצלחה!

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

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

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

=HYPERLINK("https://call2all.co.il/ym/api/UpdateExtension?token=07********:*****&path=ivr2:" & $A2 & "/" & B$1 & "&type=menu", "עדכן נתונים")

הסבר: יש פה קישור רגיל לעדכון שלוחה פלונית לסוג שלוחה 'תפריט', אבל הנתיב של השלוחה אינו קבוע אלא חלקו הראשון נלקח מתא A2 וחלקו השני מ-B1. הוספתי סימני $ לקיבוע - כלומר שכאשר אעתיק את הקישור לתאים נוספים לא ישתנה מה שמקובע, בדוגמא הנ"ל: בחלק הראשון של הנתיב לא תשתנה העמודה ובחלק השני לא תשתנה השורה.
כמו כן הוספתי בהתחלה HYPERLINK שזה הנוסחה ובסוף "עדכן נתונים"בשביל שזה מה שיופיע בתא.

כעת מופיע לנו ככה:

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

והופ!:

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

כעת נפתח אותם במרוכז: נבחר כמות תאים, אפשר עד 50 בפעם, נלחץ לחיצה ימנית (או בקיצור Alt+Enter):

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

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

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

הכנת המודל

כנסו לכאן וצרו עותק מהמסמך.

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

גשו ל'תוספים' (בסרגל העליון) >> Apps Script, תיפתח לכם כרטיסייה חדשה.

בכרטיסייה החדשה לחצו על 'לפריסה' (בצד שמאל למעלה) >> פריסה חדשה.

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

אשרו הרשאות ככל שמתבקש.

העתיקו את הכתובת שהתקבלה ושמרו אותה.

הכנת המערכת

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

recording_and_entering_data_end_goto=/1000

למודל סקר, לדוגמא:

seker_end_goto=/1000

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

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

type=api
api_link=
api_hangup_send=no

והכניסו את הכתובת שהתקבלה בסוף השלב הראשון אחרי ה-= בשורה השנייה.

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

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

שימו לב, כי בברירת המחדל המערכת תשמיע אחר השליחה לAPI 'אין מענה משרת הAPI', וזה לא מראה על שום תקלה, מומלץ להשבית את ההודעה ע"י העלאת קובץ שקט בשם M1607 לשלוחה 1000 החדשה או לתקייה Messages בתפריט הראשי, ניתן ג"כ להעלות הודעה על הצלחת הפעולה כמו 'נרשמתם בהצלחה' וכדומה.

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

api_end_goto=1

ואז ליצור בתוך שלוחה 1000 שלוחה נוספת בשם 1 ולהכניס בה כך:

type=api
api_link=https://www.call2all.co.il/ym/api/FileAction?token=(מס' מערכת):(סיסמא)&what=ivr(נתיב כולל שם קובץ וסיומת)&action=delete 
api_hangup_send=no

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

אפשרות זו לא כ"כ מומלצת כיון שייתכנו אובדן נתונים.

בהצלחה רבה!

לבאגים, הערות ובקשות

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

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

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

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

הפרטים שעליכם להוסיף בהגדרות של השלוחות:
token - מס' מערכת וסיסמא, לדוגמא: 0772222770:1234
id - ה-id של גליון השיטס שלכם, כלומר החלק שבין https://docs.google.com/spreadsheets/d ל- edit בכתובת של הגליון, לדוגמא: 1AiKGh9Fof6Aew6ehALVrI_hlU75FgO3-cBvK3H24jE4
column - העמודה של הרשימה שלכם, לדוגמא: A.

ההגדרות של השלוחות

שלוחת הפעלת צינתוק:

type=api
api_link=https://script.google.com/macros/s/AKfycbxZGUYUvM1UxEsGbsKGeHZgNFm9Nx1i9llrfA2pjxtNOlGi04-BK0YPt4dgzTZOtPEd/exec
api_hangup_send=no
api_add_0=action=RunTzintuk
api_add_1=token=הכניסו כאן את הטוקן, לפי ההוראות שלמעלה
api_add_2=id=הכניסו כאן את ה-ID לפי ההוראות שלמעלה
api_add_3=column=הכניסו כאן את העמודה הרצויה

ניתן ג"כ להוסיף פרמטר callerId להגדרת זיהוי יוצא לצינתוק, במידה ויש הרשאה למספר נוסף, לדוגמא:

api_add_4=callerId=0772222770

וכן פרמטר TzintukTimeOut להגדרת זמן צינתוק.

שלוחת הרשמה לצינתוקים:

type=api
api_link=https://script.google.com/macros/s/AKfycbxZGUYUvM1UxEsGbsKGeHZgNFm9Nx1i9llrfA2pjxtNOlGi04-BK0YPt4dgzTZOtPEd/exec
api_hangup_send=no
api_add_0=action=Addtolist
api_add_1=id=הכניסו כאן את ה-ID לפי ההוראות שלמעלה
api_add_2=column=הכניסו כאן את העמודה הרצויה

הסרה מצינתוקים:

type=api
api_link=https://script.google.com/macros/s/AKfycbxZGUYUvM1UxEsGbsKGeHZgNFm9Nx1i9llrfA2pjxtNOlGi04-BK0YPt4dgzTZOtPEd/exec
api_hangup_send=no
api_add_0=action=Removefromlist
api_add_1=id=הכניסו כאן את ה-ID לפי ההוראות שלמעלה
api_add_2=column=הכניסו כאן את העמודה הרצויה

חסימת המספר מהרשימה:

type=api
api_link=https://script.google.com/macros/s/AKfycbxZGUYUvM1UxEsGbsKGeHZgNFm9Nx1i9llrfA2pjxtNOlGi04-BK0YPt4dgzTZOtPEd/exec
api_hangup_send=no
api_add_0=action=block
api_add_1=id=הכניסו כאן את ה-ID לפי ההוראות שלמעלה
api_add_2=column=הכניסו כאן את העמודה הרצויה

שחרור החסימה:

type=api
api_link=https://script.google.com/macros/s/AKfycbxZGUYUvM1UxEsGbsKGeHZgNFm9Nx1i9llrfA2pjxtNOlGi04-BK0YPt4dgzTZOtPEd/exec
api_hangup_send=no
api_add_0=action=Unblock
api_add_1=id=הכניסו כאן את ה-ID לפי ההוראות שלמעלה
api_add_2=column=הכניסו כאן את העמודה הרצויה

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

api_000=Phone1,,,,,Digits

ולהוסיף לשלוחה קובץ בשם 000.tts עם התוכן 'נא הקש את המספר ובסיום הקש סולמית'.

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

בהצלחה!

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

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

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

@מערכת-המשפחה בקו ב' תגדיר כהעברה לקו א':

type=routing_yemot
routing_yemot_number=033060606

בתפריט הראשי בקו א' תגדיר הפניה לפי מספר הטלפון המפנה:

check_did_and_go_to_folder=yes
did_directed_check=yes

ובשלוחה הראשית בקובץ Did_Go_To.ini תגדיר (בתוך הקובץ):

033060606-Directed-0773307733=/6

אני מקווה שהוא יזהה את הקו כמספר המפנה.

לי זה לא עובד, כמו שכבר כתבתי למעלה

@חכמון כתב באיך חסר מספרים לחיוג?:

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

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

דרך נוספת ופשוטה יש כאן
https://f2.freeivr.co.il/post/156903

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

@חכמון ייש"כ רב!
אנסה את זה

עריכה: עובד! ייש"כ

@צבי-ד-צ כתב ברשימת צינתוקים עם שליטה מלאה!:

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

???

כתבתי:

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

@צבי-ד-צ כתב ברשימת צינתוקים עם שליטה מלאה!:

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

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

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

@זרח כתב בשלוחה של 2 ספרות:

2 שניות זה נשמע סביר.

קצת מידי הרבה לאנשים רגילים,
אני מגדיר 1.5 כשזה תפריט של 2 ספרות, ו- 2 כשזה תפריט של 3 ספרות

@שוקולית כתב בשלוחה של 2 ספרות:

בהגדרות מתקדמות של השלוחה הראשית?

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

timeout=2

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

@הרב-שליט-א-0 יכול להיות שגם אם תוסיף את זה ותשאיר את הקישור הרגיל זה יעבוד:

api_call_id_send=no
api_phone_send=no
api_did_send=no
api_extension_send=no
api_enter_id_send=no
api_enter_id_name_send=no
api_time_send=no

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

@רבקה-מרודי אין אפשרות
ניתן לפנות להנהלה, אולי אולי יסכימו...

@חכמון כתב באיך חסר מספרים לחיוג?:

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

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

@יעקב-1 אפשר ליצור סקריפט שיעדכן כל שבוע את הזמנים הרצויים

@אביי-ורבא כתב בהשלמת כתיבת ההגדרות באתר (כמו בכל עורך קוד):

שלי אין זמן ללקט מהפורום..

אז אולי כדאי באמת לקדם את הרעיון של הגליון הזה
https://docs.google.com/spreadsheets/d/1n8ftWXKhwcxujtM_bkZTIRGS7IaQ-HAzPXU7eQVBb8Q/edit?gid=0#gid=0

@isi או לשלם על הסרת פרסומות, או שהמתקשר ימתין עד גמר הפרסומת...