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

[הדיבל המעופף]

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

type=api
api_link=https://configuring-extensions.a775529301.workers.dev/
api_add_0=token=טוקן
api_hangup_send=no

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

תגובות פה

ועוד משהו שנראה לי לא כתוב בממשק
במקרה שכותבים עם X

api_add_X=token=[טוקן]

המודל ממיר את" X" אוטומטית למספר סידורי (מה שנחוץ במיוחד לתתי שאלות)

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

קרדיט ל @אריה-ai על היוזמה !!!

הסבר AI על המודל

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

מה זה?

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

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

איך זה עובד

1. המאזין מקיש מספר קו וסיסמת ניהול. הוורקר מרכיב מהם טוקן במבנה 077222770:123456 ובודק אותו מול ימות.
2. המאזין מקיש מספר שלוחה. כוכבית מומרת לסלש, כי אין סלש בטלפון: 1*2 הופך ל-1/2.
3. הוורקר קורא את Settings.ini משלוחת ה-API שלו, ומחיל קודם את הגדרות הבסיס.
4. אחר כך הוא שואל את המאזין את השאלות, וכל תשובה מוסיפה הגדרות.
5. בסוף יש אישור וכתיבה ל-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.

מגבלות

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