הפוסטים הטובים ביותר שנוצרו על ידי פלמנמוני

קודם כל אסביר את הבעיה ואח"כ אציג את הפתרון.
כידוע, ניתן להשתמש עם 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

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

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

@חכמון כתב באבטחה - באימות דו שלבי / דעתכם... 🪪:

ואחרי שהכנסתי את הערך - הסקריפט ממשיך לרוץ,
אז זה נשמר בדרייב שלי?

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

@שמואל כתב באבטחה - באימות דו שלבי / דעתכם... 🪪:

יהיה אפשרות ליצור API_KEY קבוע

Spoiler

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

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

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

@זרח
כאן יצרתי משהו לזה

@טנטפון כתב ברעיון למודול API חדש:

שלום רציתי לישאול את מישתמשי הפורום אולי יש אזה מודול שדרוש פיתוח קשה לימצו רעיונות למודולים חדשים

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

https://call2all.co.il/ym/api/UploadTextFile?token=---&what=ivr2:1/${ras1}/000.tts&contents=00011&ras1=01

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

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

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

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

הנה

@עידו כתב בבאגים, הערות ובקשות למודל עדכון אוטומטי מקובץ ymgr לגוגל שיטס:

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

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

@הלי שתיהן ניסיתי ולא עבד,
ובכל אופן הצלחתי להסתדר באופן שונה

@בעלזא
לכאו' אין דרך כזו, אבל תוכל ליצור רצף קישורים שיופעלו ידנית או בגוגל סקריפט

Spoiler

https://call2all.co.il/ym/api/UploadPhoneList?templateId=[כאן לכתוב את מזהה הרשימה]&data=[כאן לכתוב את המספרים להוספה מופרדים בפסיקים]&token=[כאן לכתוב את מספר המערכת]:[כאן לכתוב את סיסמת המערכת

https://call2all.co.il/ym/api/UploadPhoneList?templateId=-----&data=05--------,05--------,05--------&token=079-------:-----

https://call2all.co.il/ym/api/RunCampaign?token=079-------:-----

https://call2all.co.il/ym/api/ClearTemplateEntries?templateId=-----&token=079-------:-----

לדעתי יותר טוב (אם אתה עושה קישורים) להגדיר רק הוספה לקמפיין 3, וצינתוק למספרים ללא הוספה לקמפיין 4, קישורים לזה בספויילר

Spoiler

https://call2all.co.il/ym/api/UploadPhoneList?templateId=-----&data=05--------,05--------,05--------&token=079-------:-----

https://call2all.co.il/ym/api/RunTzintuk?phones=05--------:05--------:05--------&token=079-------:-----

@זרח כתב בבאגים, הערות ובקשות למודל עדכון אוטומטי מקובץ ymgr לגוגל שיטס:

אפשר לפרסם את הרעיון של הקוד,

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

@הלי תודה רבה!
עובד

@זרח כתב בנתיב משתנה לפי פרמטר אחר:

א. איך הוא יודע להתגבר על הבעיה של שרתי גוגל?

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

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

@TARR כתב ביש אפשרות להגביל את כמות המספרים ברשימה לבנה?:

@יהודה-צ-כ קראת את כל השרשור?
אתה בטוח שהבנת את השאלה?
בכל אופן - את זה

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

לא נראה לי שראית...

כוונתו שתגדיר שאחרי המחיקה תועבר אוטומטית לשלוחה 500 בתפריט הראשי (לדוגמא),

remove_id_from_list_end_goto=/500

ובשלוחה ההיא תגדיר:

type=add_id_to_list
add_id_to_list_location_list=/נתיב שלוחת הרישום/ext
add_id_to_list_key=booking_max
add_id_to_list_value_change=yes
add_id_to_list_value_plus=yes

@מתחילל

הגליון הזה יעזור לך מאוד

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