תגובות | מודל הגדרת שלוחות דרך הטלפון !!!

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

הדיבל המעופף

@פיתה

הסבר AI

שלוחת API להגדרת שלוחות בקו אחר – ישירות מהטלפון

מה זה?

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

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

איך זה עובד

המאזין מקיש מספר קו וסיסמת ניהול. הוורקר מרכיב מהם טוקן במבנה 077222770:123456 ובודק אותו מול ימות.
המאזין מקיש מספר שלוחה. כוכבית מומרת לסלש, כי אין סלש בטלפון: 1*2 הופך ל-1/2.
הוורקר קורא את Settings.ini משלוחת ה-API שלו, ומחיל קודם את הגדרות הבסיס.
אחר כך הוא שואל את המאזין את השאלות, וכל תשובה מוסיפה הגדרות.
בסוף יש אישור וכתיבה ל-ext.ini של השלוחה שהוקשה.
כל הקשה מוקראת על ידי ימות עצמה (סוג Digits) ואחריה נשאלים "לאישור הקישו 1, להקשה מחדש הקישו 2". זו ברירת המחדל של ימות, והוורקר לא משמיע את ההקשות בעצמו.

התקנה

שלב 1: יוצרים שלוחת API בקו שלך

ב-ext.ini של השלוחה:

type=api
api_link=https://<השם-שלך>.workers.dev
api_add_0=token=<קו-שלך>:<סיסמת-ניהול-שלך>
api_add_1=key=<אותו-ערך-כמו-ACCESS_KEY>
api_log=no
api_hangup_send=no

api_log=no חשוב. בלעדיו הסיסמאות שמוקשות נשמרות בלוג של ימות.

שלב 2: מעלים Settings.ini לאותה שלוחה

אפשר להעלות ידנית, או לערוך בעורך החזותי שמצורף (פירוט בהמשך).

מבנה `Settings.ini`

הגדרות בסיס

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

בסיס_0= type=api
בסיס_1= api_link=https://listener-management.a775529301.workers.dev
בסיס_2= api_add_X=token=[טוקן]

שאלות ותשובות

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

שאלה_1=לשליחה בשיטת פוסט הקישו 1, לגט הקישו 2, להשארת ברירת המחדל הקישו 3
שאלה_1_1= api_url_post=yes
שאלה_1_2= api_url_post=no
שאלה_1_3= כלום

כלום אומר שלא מוסיפים שום הגדרה.
אפשר לכתוב כמה שורות באותו מפתח, ואז כל התשובה מוסיפה כמה הגדרות.

תתי-שאלות

תת-שאלה נשאלת רק אם נבחרה תשובה מסוימת:

תת_1_1_שאלה_1=להוספת מזהה המתקשר הקישו 1, לא להוסיף הקישו 2
תת_1_1_שאלה_1_1= api_add_X=phone=yes
תת_1_1_שאלה_1_2= כלום

תת_1_1_ אומר: ענו 1 על שאלה 1. ואפשר להמשיך לרמה נוספת, למשל תת_1_1_1_שאלה_1.

תגיות בתוך ההגדרות

תגית	מה היא עושה
`[טוקן]`	מוצבת בה הטוקן שהוקש, למשל `077222770:123456`
`[הקשה=אנא הקישו את השלוחה]`	הוורקר מקריא את הטקסט, וההקשה נכנסת להגדרה. כוכבית הופכת לסלש
`[קו]`, `[סיסמה]`, `[שלוחה]`	הקו, הסיסמה והשלוחה שהוקשו

התגיות עובדות גם בהגדרות בסיס וגם בתוך תשובות.

מספור סדרתי

מודול ה-API דורש הגדרות סדרתיות (api_add_0, api_add_1…), וכשיש שאלות לא ידוע מראש כמה הגדרות ייכתבו. לכן כותבים api_add_X, והוורקר ממספר אותן לפי הסדר שבו הן נכנסו בפועל. גם api_add_0 עם מספר קבוע ימוספר מחדש. אותו דבר חל על api_X, שמקבל מספר בן שלוש ספרות.

הגדרות כלליות (רשות)

כללי_אישור=לא            # בלי אישור סופי לפני השמירה
כללי_אישור_הקשות=לא      # בלי בקשת אישור על כל הקשה בשאלות ובערכי [הקשה=...]
כללי_דריסה=לא | כן | שאלה

מיזוג או דריסה

כשהשלוחה כבר קיימת יש שתי אפשרויות:

מיזוג (ברירת מחדל): מעדכנים רק את ההגדרות החדשות ושומרים את השאר. ה-api_add הישנים נמחקים כדי שלא יישארו "זנבות" שמפרים את הרצף.
דריסה: כל ה-ext.ini נמחק ונכתב מחדש עם ההגדרות החדשות בלבד. קבצים אחרים בשלוחה לא נפגעים.
עם כללי_דריסה=שאלה, המאזין בוחר בעצמו בטלפון. במצב דריסה האישור הסופי מזהיר אותו שכל ההגדרות הקיימות יימחקו.

עורך חזותי ל-`Settings.ini`

קיים גם דף HTML שמתחבר ישירות לימות וקורא ושומר את Settings.ini:

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

אבטחה

הוורקר מקבל טוקן של קו אחר, ולכן כדאי להגדיר ACCESS_KEY כדי שרק השלוחה שלך תוכל לקרוא לו.
אחרי 3 ניסיונות כושלים השיחה מתנתקת.
הסיסמה לא נשמרת בשום מקום בוורקר. api_log=no מונע שמירה שלה בלוג של ימות.
הסיסמה מוקראת בקול כמו שאר ההקשות. להשתקה: api_add_X=pass_readback=no.

מגבלות

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

אמר

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

הדיבל המעופף

@אמר
יש את הטוקן שמגדירים הגדרות השלוחה - שזה הטוקן של הקו בו מגדירים - בטוקן זה השלוחה משתמשת אך ורק לשליפת הגדרות המודל.
הטוקן שעל ידו השלוחה מעדכנת את הגדרות השלוחה - מיד בכניסה לשלוחה המאזין מקיש מספר מערכת וסיסמא - מה שמומר אוטומטית לטוקן - את הטוקן הזה אפשר להכניס לכל מקום בקובץ ההגדרות ע"י כתיבת "[טוקן]"
מובן? אם לא תגיד מה לא מובן ואשתדל להשיב

אמר

@הדיבל-המעופף
מקוה שהבנתי
זה מה שהגדרתי (צילום מהאתר המוצלח של פתרון AI)

אמור לעבוד?

הדיבל המעופף

@אמר
שמת טוקן אמיתי בשלוחה?

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

הדיבל-המעופף כתב במודל הגדרת שלוחות דרך הטלפון !!! כולל שאלות תתי שאלות ועוד !!!!:

‏‏ממשק ההגדרות בשלוחה למחוק "מיותר"

הדיבל המעופף

@אמר
עובד?