צ׳אטבוט AI ל-Telegram: בנייה לקבוצות ולשיחות פרטיות ללא קוד

צ׳אטבוט AI ל-Telegram יכול לענות על שאלות מתוך הידע העסקי שלכם, בקבוצה או בשיחה פרטית. Quickchat AI מחבר AI Agent ל-Telegram באמצעות בוט משותף: מוסיפים אותו לקבוצה, מאשרים את החיבור בלוח הבקרה, והחברים יכולים להזכיר את הבוט כדי לשאול. במסלול הזה אין צורך בקוד או בטוקן של BotFather.

במדריך נבנה את Saltmarsh Sailing School, בית ספר בדיוני עם קבוצת חברים ופניות פרטיות. שני Agents חולקים את אותו מידע: Saltmarsh Group עונה על שאלות ציבוריות, ו-Saltmarsh Sailing School מטפל בבקשות פרטיות לשיעורי ניסיון ומערב נציג בהחזרים. בקשה היא פנייה למשרד, לא הזמנה מאושרת.

שני Agents מפרידים את האחריות. ל-Agent של הקבוצה אין Action להעברה או לקליטת בקשות; ה-Agent הפרטי מטפל בפניות ובתשובות הצוות.

פעלו לפי המסלול הבא. ההרחבה ל-Google Sheets היא רשות; אפשר להשלים תחילה את המענה וההעברה לנציג.

הורידו את ערכת Saltmarsh ל-Telegram לקבלת הידע, Main Prompt, מתכון ה-Action, קריטריוני ההערכה והודעות הבדיקה המדויקים. אלה קבצים לעריכה בשלבים הבאים, לא ייבוא Agent בלחיצה אחת. חומרי ההדגמה להעתקה וצילומי המסך נשארים באנגלית.

מה צריך כדי ליצור צ׳אטבוט ב-Telegram?

צריך חשבון Quickchat AI, שני Agents וחשבון Telegram עם הרשאה להוסיף בוט לקבוצת בדיקה. שלב תיעוד הבקשות האופציונלי דורש גם חשבון Google שיכול לאשר גישה ל-Google Sheets.

1. צרו חשבון Quickchat AI ואמתו את הדוא״ל אם תתבקשו. Free מיועדת ללמידה אישית ולא מסחרית. המסלולים חלים לכל Agent, ולכן עסק המשתמש בשניהם צריך כיסוי מסחרי מתאים לשניהם. Preview ו-Simulation צורכים קרדיטי AI. ראו את המסלולים הנוכחיים.
2. צרו קבוצת Telegram בשם Saltmarsh Members. השתמשו בקבוצת בדיקה כדי לבדוק אזכורים, שתיקה והודעות המשך לפני הזמנת לקוחות.
3. השתמשו בחשבון Telegram שלכם לביצוע המדריך, כולל הודעות המבקר. תוכלו גם להפעיל את Inbox של Quickchat AI. לפני הזמנת לקוחות, בקשו מעמית לבדוק את החוויה מחשבון אחר.
4. חלצו את הערכה. שמרו יחד את עובדות הדוגמה של בית הספר; החליפו אותן במדיניות בדוקה משלכם לפני ההשקה.

צילומי המסך של Quickchat App מציגים אפליקציה שפועלת מקומית עם תצורת Saltmarsh הבדיונית; נתוני בדיקה של חיבורים מסומנים בכיתובים. צילומי Telegram ו-Google Sheets מציגים את התשובות האמיתיות של ההדגמה המחוברת ואת הפנייה שנשמרה. פרטי חשבון אישיים נחתכו או הוסתרו במפורש. השתמשו ברשימת הבדיקה הסופית כדי לחזור על הבדיקות עם הידע והחשבונות המחוברים שלכם.

שלב 1: איך מלמדים את צ׳אטבוט Telegram על העסק?

הכניסו עובדות עסקיות ל-Knowledge Base והנחיות פעולה ל-Main Prompt. הפרדת התפקידים מקלה על תיקון תשובה בלי לשנות את התנהגות ה-Agent.

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

צרו את ה-Agent והוסיפו ידע

1. בחשבון חדש בחרו Set up manually. בחשבון קיים בחרו קודם Add new AI Agent, ואז את המסלול הידני.
2. ב-Identity, הזינו Saltmarsh Group בשדה Name your AI Agent. הדביקו את group-main-prompt.txt מהערכה ב-Describe what you want your agent to do.
3. המשיכו בהגדרה בלי לחבר עדיין אפליקציות חיצוניות. השלימו את שלב המסלול; השתמשו ב-Skip for now אם מתחילים בחשבון ללמידה.
4. פתחו Knowledge Base > Add Article. הזינו Courses and trial enquiries ב-Create custom article, בחרו Create article, הדביקו את saltmarsh-courses.txt ב-Content, ואז Save.
5. חזרו על הפעולה עם Weather, parking and personal enquiries, באמצעות saltmarsh-policies.txt. המתינו ששני המאמרים יציגו Ready.
6. פתחו Actions & MCPs ב-Saltmarsh Group. השאירו Human Handoff כבוי ואל תוסיפו את Action בקשת הניסיון.
7. בחרו Add new AI Agent והגדירו ידנית את Saltmarsh Sailing School באמצעות main-prompt.txt ואותם שני קובצי ידע. ה-Agent השני יטפל בשיחות פרטיות. בחרו אותו בבורר החשבון לפני שינוי הגדרותיו.

שני מקורות קצרים מבהירים אילו עובדות ה-Agent מכיר. Ready הוא תנאי הבדיקה לפני מבחן ידע.

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

הגדירו Main Prompt ובדקו תשובה

1. פתחו Identity > Main Prompt בכל Agent ובדקו את הנחיות Saltmarsh המתאימות. הנחיות הקבוצה עונות על שאלות כלליות ומפנות לקישור הפרטי הנעוץ; ההנחיות הפרטיות אוספות פניות ומשתמשות ב-Human Handoff.
2. פתחו AI Preview ושאלו How much is Start Sailing?. בדקו שמופיעים יומיים ו-EUR 240.
3. שאלו Do you rent wetsuits?. בדקו שהתשובה מודה שחסר מידע.

הנחיות ה-Agent הפרטי מגדירות קליטה והעברה. ה-Agent הקבוצתי משתמש בהנחיות נפרדות ושני ה-Actions כבויים.

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

שני Agents מבהירים את הניתוב. ל-Agent הקבוצה אין יכולת העברה שעלולה לפעול בטעות; ה-Agent הפרטי יכול להעביר בקשת החזר בלי להשהות את הקבוצה. Preview בודק את עובדות בית הספר, והשלבים הבאים מאמתים כל חיבור Telegram.

שלב 2: איך מוסיפים את צ׳אטבוט ה-AI לקבוצת Telegram?

פתחו External Apps > Telegram, הוסיפו את הבוט המשותף לקבוצה, ואז חזרו ל-Quickchat AI ובחרו Confirm. ה-Agent נשאר שקט בקבוצה עד לאישור.

הצטרפות ל-Telegram ואישור ב-Quickchat AI הם שלבים נפרדים.

1. בחרו Saltmarsh Group בבורר ה-Agents. פתחו External Apps, בחרו Telegram ומצאו Quickchat AI bot.
2. בחרו Add to a Telegram group. ב-Telegram בחרו Saltmarsh Members ואשרו הוספת הבוט.
3. חזרו ל-Quickchat AI. תחת Waiting for your confirmation, בדקו את שם הקבוצה ואת פרטי Added by.
4. בחרו Confirm עבור הקבוצה הצפויה. היא אמורה לעבור ל-Connected chats כשהמתג פועל.
5. ב-Telegram הקלידו @ ובחרו את הבוט מרשימת האזכורים. שאלו How much is Start Sailing?. שם המשתמש של הבוט המשותף הוא בדרך כלל @QuickchatAI_bot; השתמשו בשם שמופיע בפועל בקבוצה.
6. הגיבו ישירות לתשובה עם What should I bring?. אחר כך שלחו בנפרד ללא אזכור: Does anyone know the gate code?. הבוט אמור לענות לתגובה ולהישאר שקט בהודעה הרגילה.

בחרו Saltmarsh Members ב-Telegram, ואז חזרו ל-Quickchat AI כדי לאשר את החיבור.

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

הקבוצה שאושרה קיבלה את התשובה הצפויה על הקורס. אזכרו את הבוט באמצעות שם המשתמש האמיתי שלו.

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

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

השלימו את האישור לפני שתעזבו את ההגדרה. אם הבוט עזב קבוצה שלא אושרה, צרו קישור Add to a Telegram group חדש, הוסיפו אותו שוב ואשרו מיד את הקבוצה הממתינה ב-Quickchat AI. הוספת הבוט דרך חיפוש חברים ב-Telegram אינה מחליפה את תהליך החיבור הזה.

תג Admin מציין את מעמד הבוט ב-Telegram. הוא אינו נדרש לתשובות רגילות של הבוט המשותף. גם הפיכת הבוט למנהל אינה משנה את כלל האזכור או התגובה הישירה.

שלב 3: איך מפעילים שיחות Telegram פרטיות?

הפעילו Direct message link ושתפו את כתובת ה-URL המלאה שנוצרה. הקישור בוחר את ה-Agent שלכם בתוך הבוט המשותף, כך שלקוחות יכולים לשאול בפרטי בלי להוסיף אותו לקבוצה.

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

1. בחרו את ה-Agent הפרטי Saltmarsh Sailing School. פתחו External Apps > Telegram והפעילו Direct message link. השאירו את חיבורי הקבוצות שלו ריקים.
2. העתיקו את הקישור שנוצר. שמרו על הפרמטר start=; קישור בסיסי לבוט המשותף אינו מזהה את ה-Agent.
3. פתחו אותו ב-Telegram ולחצו Start אם תתבקשו.
4. שאלו How much is Start Sailing? ללא אזכור. בדקו את תשובת בית הספר ומצאו את השיחה ב-Inbox.
5. נעצו את הקישור בהודעת הפתיחה של הקבוצה כדי שיימצא לפני שיתוף מידע אישי.

השתמשו בקישור שנוצר ל-Agent שלכם. ההגדרה המקומית אינה אישור מסירה אמיתי ב-Telegram.

Telegram מסר את הודעת הפתיחה של Saltmarsh אחרי Start. בדקו כעת תשובה מתוך הידע; ברכה בלבד אינה בודקת אחזור מידע.

שני חיתוכים מאותו מסך Telegram מציגים את ההזמנה הנעוצה. ערך start של קישור ההדגמה הושמט; נעצו את הקישור המלא שנוצר עבורכם.

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

כיבוי Direct message link מונע חיבורים חדשים דרכו. לעצירת שיחה שכבר מחוברת, השתמשו במתג שלה או ב-Disconnect. ראו בקישור כניסה ציבורית, לא מגבלת גישה לידע חסוי.

שלב 4: איך שומרים בקשת ניסיון ב-Google Sheets?

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

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

חברו את Sheets והגדירו Action אחד

1. ב-Saltmarsh Sailing School, פתחו Actions & MCPs > Add Action > Google Sheets ובחרו Connect Google Sheets. היכנסו לחשבון Google הרצוי ואשרו את הגישה המבוקשת.
2. פתחו את גיליון Quickchat Leads שנוצר. שמרו את שם הלשונית Leads, כי כתובת ה-Action פונה אליה.
3. החליפו את שורת הכותרות לפי הסדר ב-Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. פתחו Actions & MCPs וערכו את log_lead_to_google_sheet שנוצר. השתמשו במתכון הבא. שנו יחד את הפרמטרים, גוף הבקשה וכותרות הגיליון כדי שהמיקומים יתאימו.

API Action Name

Record trial-lesson request

What to ask the user first

הגדירו את שלושתם כ-No default והסירו את פרמטרי הדוא״ל והפנייה המוגדרים מראש. שלושת השדות הם השאלות היחידות במתכון. שם משתמש ב-Telegram הוא אופציונלי ואינו שדה קשר חובה אמין; קישור השיחה שנרשם מחזיר את הצוות לפנייה.

שיטה וכתובת: שמרו את כתובת POST שנוצרה. היא כבר כוללת מזהה גיליון, לשונית Leads ו-valueInputOption=RAW. אין מזהה זמני שצריך למלא.

כותרות בקשה: שמרו את הגדרות האינטגרציה.

בלשונית Body של API Endpoint, השתמשו ב:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

השתמשו ב-Add AI Data להוספת תגי הפרמטרים ומשתני השיחה לפי הצורך. שלושת הערכים הראשונים מגיעים מהשיחה; השניים האחרונים מסופקים בידי Quickchat AI.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

פתחו Advanced settings > Run only when והוסיפו telegram_chat_type equals private. השתמשו במפתח המטא-נתונים לבדו, בלי metadata_ או סוגריים מסולסלים. כך לא תישלח בקשת HTTP להודעת קבוצה גם אם המודל ינסה. מדריך תנאי ההפעלה מסביר את הבדיקה.

הגדירו Response filter כ-$.updates.updatedRows כדי שה-Action יחזיר מספר שורות במקום תשובת ספק מיותרת. השאירו אותו פעיל.

המפתח הוא telegram_chat_type. התנאי נבדק לפני שליחת הבקשה.

הגדרה מקומית של מתכון הבקשה. כתובת Sheets והרשאת OAuth צריכות להגיע מחיבור Google שלכם.

בדקו את השורה, ואז בקשה חלקית

שלחו את ההודעה הבאה דרך קישור ה-Telegram הפרטי של ה-Agent:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

בדקו שלושה מקומות: התשובה מתארת בקשה, כרטיס ה-Action ב-Inbox מציג את הערכים שנמסרו, ובלשונית Leads האמיתית קיימת שורה תואמת. תשובה מרגיעה או ציון Simulation גבוה אינם מוכיחים כתיבה ל-Google Sheets.

ה-Agent שמר את השם שסופק, את ההעדפה ליום שלישי ואת רמת המתחילים. הזמינות והמחיר המדויק עדיין דורשים אישור מהמשרד.

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

פתחו בדיקה נפרדת עם I would like a trial lesson. ה-Agent אמור לבקש שדות חסרים, שאלה אחת בכל פעם, לפני הפעלת Action. נסו גם How much is Start Sailing?; שאלה רגילה אינה אמורה ליצור שורה. ההנחיה מבקשת כתיבה אחת לבקשה, אך מתכון ההוספה אינו מערכת הזמנות אידמפוטנטית. בדקו כפילויות לפני שימוש תפעולי.

שלב 5: איך מעבירים שיחת Telegram לנציג?

הגדירו Human Handoff, ואז בדקו את שיוך השיחה ב-Inbox. הנחיה האומרת שהמשרד ישיב אינה מעבירה בעלות או משהה AI בעצמה.

שינוי השיוך הוא נקודת הבדיקה. נציג מסיים את המקרה; חזרה ל-AI נבדקת בנפרד.

1. בחרו Saltmarsh Sailing School, פתחו Actions & MCPs > Human Handoff והפעילו. השאירו Action זה כבוי ב-Saltmarsh Group.
2. תחת Handoff Rules, בחרו +. הזינו Private enquiries ב-Rule Name, הדביקו handoff-rule.txt ב-Description והפעילו State. שורות חדשות מתחילות לא פעילות. הכלל כולל החזרים, תלונות, בקשת נציג והסכמה לעזרה אנושית ב-Agent הפרטי.
3. נקו Keywords, כבו את הכללים המובנים בדוגמה והשאירו רק את הכלל המותאם פעיל, ואז שמרו. בידוד הקבוצה נובע מכיבוי Human Handoff ב-Agent הקבוצתי הנפרד; הכלל המותאם מתאר מתי הפרטי צריך להעביר.
4. הגדירו Confirmation כ-I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. הגדירו Human Agents’ availability לפי שעות הכיסוי בפועל, וכתבו הודעה אמינה מחוץ לשעות הפעילות.
5. בשיחה הפרטית שלחו I want a refund for last week. Can I speak to a person?.
6. ב-Inbox, מצאו את השיחה, בדקו את השיוך, בחרו Assign to me ושלחו Hi, I’m Alex from the office. I’ll review your request. ודאו שהיא מגיעה ל-Telegram.
7. שלחו הודעת לקוח נוספת כשהנציג אחראי לשיחה. ה-AI אמור לשתוק. תנו לנציג לסיים ולפתור את המקרה ב-Inbox. התייחסו לחזרה ל-AI כבדיקה נפרדת.

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

הבקשה האמיתית ב-Telegram הפעילה Handoff. השיוך ב-Inbox ותשובת המפעיל היוצאת אומתו בנפרד.

בבדיקה בפועל, השיחה עברה ל-Unassigned, מוכנה לטיפול של אדם. המפעיל בחר Assign to me, שלח את תשובת המשרד, ו-Telegram קיבל אותה. צילום המסך למעלה מציג את תשובת ההעברה; הוא אינו מציג את הודעת המפעיל המאוחרת יותר. בדקו גם שיוך וגם שליחה כשתחזרו על הבדיקה.

השאירו את המקרה אצל המפעיל עד לפתרונו. בבדיקת ההחזר המקומית, החזרה ל-AI Agent אפשרה תשובה אחת לפני ש-Handoff הופעל שוב. חזרה ל-AI דורשת בדיקת המשך מוצלחת ונפרדת; היא אינה חלק מתנאי השלמת התהליך הזה. מדריך ההעברה לאדם מפרט על איוש ועל אחריות לטיפול.

שלב 6: איך בודקים את צ׳אטבוט Telegram המלא?

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

בדקו את המערכת שאחראית לתוצאה: ידע לעובדות, יומני Action לבקשות, Sheets לשורות ו-Telegram למסירה.

הריצו מערך בדיקות תשובה שניתן לחזור עליו

1. פתחו Testing, צרו מערך בשם Saltmarsh: knowledge checks ובחרו Paste messages.
2. הדביקו simulation-messages.txt. שמרו על מפרידי --- בשורות נפרדות בין המקרים.
3. פתחו Evaluation criteria, הדביקו את evaluation-criteria.txt מהערכה ושמרו.
4. בחרו Run > Start Run ובחנו את התשובות הבודדות לצד הציונים.

כשמשנים הנחיה אחת, שומרים את אותן שאלות כדי שההשוואה תישאר שימושית.

קראו תשובות וגם ציונים. אלה בדיקות ידע מקומיות, לא בדיקות מסירה ב-Telegram.

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

מה שינו הבדיקות המקומיות?

התכנון הראשוני השתמש ב-Agent אחד לשתי הכניסות. בדיקה מקומית הראתה שבקשת החזר בקבוצה מעבירה את השיחה המשותפת ל-Human Handoff. הפרדנו בין ה-Agents והשבתנו גם Handoff וגם Actions לקליטת בקשות ב-Agent הקבוצתי. בדיקות חוזרות של בקשות החזר וניסיון בקבוצה הפנו לקישור הפרטי הנעוץ, תוך שמירת האחריות אצל ה-AI. לכן שלב 1 משתמש בתצורה לצד הנחיות כדי להפריד בין שתי השיחות.

כל אחת מעשר בדיקות הידע המקומיות הסופיות קיבלה 5/5, ושני ה-Agents המתארחים עברו את אותם עשרה מקרים. הרצות קטנות אלה אינן אומדן דיוק בייצור. גם הקבוצה האמיתית ענתה על שאלות מחיר הקורס והציוד, ולאחר מכן לא אישרה השכרת חליפות גלישה. שמרו על מקרי מידע חסר בהתאמת הערכה; תשובות מחיר נכונות לבדן אינן בודקות את האיפוק של ה-Agent.

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

בקשת הניסיון הפרטית בפועל יצרה קריאת Sheets Action מוצלחת אחת עם Alex Morgan, Tuesday ו-beginner. Google החזיר HTTP 200 ושורה מעודכנת אחת; השורה שנשמרה כללה גם את קישור השיחה ואת הערוץ telegram. בדיקת Action נפרדת עם מטא-נתונים של קבוצה לא שלחה בקשת HTTP. בדקו גם את הבקשה הפרטית שהתקבלה וגם את הקשר הקבוצה שנדחה בעת התאמת תנאי ההפעלה.

בדקו את הערוץ ואת ההשפעות שלו

השתמשו ב-test-matrix.csv הריק שבערכה לתיעוד התצפיות שלכם. צילומי המסך למעלה מציגים את התוצאות שהודגמו; הטבלה כוללת גם בדיקות לביצוע בתצורה שלכם. תעדו את הזמן שחלף בבדיקת שתיקה, והפרידו בין השתלטות אדם לבין כל חזרה מאוחרת ל-AI.

כשבדיקה נכשלת, שנו הגדרה רלוונטית אחת והריצו שוב אותה הודעה. תקנו עובדה חסרה ב-Knowledge Base, קריאה מוקדמת ל-Action בתיאור או בפרמטרי החובה, וקבוצה שקטה באמצעות בדיקת האישור ואופן הפנייה תחילה. שמרו את הכישלון כדי לראות את השיפור.

מתי כדאי ליצור בוט משלכם עם BotFather?

צרו בוט עצמאי כשצריך שם ותמונה משלכם, Telegram Bot API Actions או קבוצה שמקבלת הודעות רגילות. הבוט המשותף מספיק למסלולי המענה הקבוצתי והפרטי שתוארו.

בחרו זהות והתנהגות הודעות לפני הוספת בוט שני.

1. פתחו את חשבון BotFather המאומת ב-Telegram ושלחו /newbot.
2. בחרו שם תצוגה ואז שם משתמש זמין המסתיים ב-bot. BotFather מחזיר טוקן. שמרו אותו בסוד.
3. בחרו ב־Saltmarsh Group אם הבוט הזה יצורף לקבוצה. השתמשו ב־Saltmarsh Sailing School רק לשיחות פרטיות. ב-External Apps > Telegram, פתחו Your own bot ובחרו Connect to Telegram.
4. הדביקו את הטוקן ב-Bot Token והשלימו את החיבור. ודאו ש-Enable your own bot פעיל.
5. פתחו את קישור הבוט, שלחו /start ואז את אותה שאלת מחיר.
6. לקבלת הודעות רגילות, השתמשו ב-/setprivacy ב-BotFather, בחרו את הבוט ואת Disable, ואז הסירו והוסיפו אותו מחדש לקבוצת הבדיקה. גם בוט מנהל מקבל הודעות רגילות. תיעוד מצב הפרטיות מסביר את כללי המסירה.

הדביקו טוקן רק ב-Bot Token. מוצג שדה ריק כדי לא לפרסם פרטי גישה.

שמרו את הבוט המשותף ואת העצמאי בקבוצות נפרדות. שניהם באותה קבוצה עלולים ליצור תשובות כפולות. לנעיצת הודעות או ניהול חברים, פעלו לפי מדריך ניהול קבוצות Telegram, כולל תנאי Actions למנהלים בלבד.

האם ChatGPT או Claude יכולים לעזור בהגדרת הבוט?

אפליקציה מחוברת לניהול חשבון Quickchat AI יכולה לעזור ליצור Agent, להוסיף ידע, להגדיר אפשרויות נתמכות ולהריץ בדיקות. כאשר הלקוח מציע הגדרת Telegram, היא יכולה להפעיל קישור לשיחה פרטית של הבוט המשותף. בחירת הקבוצה ואישורה בלוח הבקרה נשארים בידי הבעלים. לקוחות מסוימים דורשים לוח בקרה גם להפעלת הקישור הפרטי ולהגדרות Human Handoff, לכן בקשו מהעוזר לבדוק קודם את הכלים הזמינים לו.

חברו את תוסף Quickchat AI ל-ChatGPT או את מחבר Claude, וספקו את קובצי הערכה עם ההנחיה הבאה:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

זמינות הכלים משתנה לפי הלקוח והרשאות החשבון. להתחברות, פעלו לפי מדריך הגדרת ניהול החשבון. כך מחברים עוזר לחשבון Quickchat AI; לא הופכים שיחת ChatGPT או Claude אישית למערכת השרת המארחת את בוט Telegram.

למה צ׳אטבוט Telegram לא עונה?

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

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

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

הגדרת Saltmarsh להעתקה

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

Agent הקבוצה: Main Prompt

הדביקו ב-Identity > Main Prompt של Saltmarsh Group. השאירו Human Handoff ו-Actions מותאמים כבויים ב-Agent זה.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

Agent הפרטי: Main Prompt

הדביקו ב-Identity > Main Prompt של Saltmarsh Sailing School. ודאו ששם ה-Action תואם למתכון.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

ידע: קורסים ובקשות ניסיון

הדביקו בשדה Content של מאמר הידע הראשון.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

ידע: מדיניות ומידע לחברים

הדביקו בשדה Content של המאמר השני.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

כלל Human Handoff

הדביקו תחת Human Handoff > Handoff Rules והגדירו את הזמינות בפועל.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

שאלות נפוצות

איך מוסיפים צ׳אטבוט AI לקבוצת Telegram?

ב-Quickchat AI פתחו External Apps, בחרו Telegram ואז Add to a Telegram group. בחרו קבוצה ב-Telegram, חזרו ל-Quickchat AI ובצעו Confirm. חברים יכולים לשאול באמצעות אזכור הבוט המשותף או תגובה לאחת מהודעותיו.

האם צ׳אטבוט AI ב-Telegram עונה לכל הודעה?

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

האם צריך BotFather או טוקן בוט Telegram?

לא צריך BotFather או טוקן לבוט המשותף ולקישור הפרטי שלו. צרו בוט ב-BotFather כשצריך שם ותמונה מותאמים או Actions הקוראים ל-Telegram Bot API. Actions רגילים של Google Sheets עובדים עם הבוט המשותף.

האם לקוחות יכולים לשלוח הודעות פרטיות לצ׳אטבוט?

כן. הפעילו Direct message link ב-Quickchat AI ושתפו את הקישור המלא שנוצר. הלקוח פותח ולוחץ Start אם מתבקש. הקישור בוחר את ה-Agent שלכם בתוך הבוט המשותף. כיבויו מונע חיבורים חדשים; לשיחות פרטיות קיימות יש בקרי הפעלה וניתוק נפרדים.

האם צ׳אטבוט AI ב-Telegram חינמי?

יצירת בוט ב-BotFather אינה מוסיפה שירות AI בפני עצמה. Quickchat AI מציע Free ללמידה אישית ולא מסחרית עם מכסת קרדיטי AI מוגבלת. פריסה מסחרית דורשת מסלול בתשלום. תשובות, Preview ו-Simulation משתמשים בקרדיטים, ושירותים חיצוניים עשויים לגבות בנפרד.

האם Telegram תומך בצ׳אטבוטים של AI?

Telegram תומך בבוטי AI של צד שלישי ובאינטגרציות AI. המדריך מחבר Agent של Quickchat AI העונה מהידע העסקי שלכם. BotFather יוצר את זהות הבוט; הוא אינו מספק ידע או מגדיר את תהליך תמיכת הלקוחות.

האם הצ׳אטבוט מבין תמונות וקבצים?

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

האם אפשר ליצור בוט דמות או משחקי תפקידים ב-Telegram?

כן. אותו חיבור Telegram יכול לשרת Agent עם זהות דמות והנחיות מתאימות. המדריך משתמש בדוגמת תמיכה עסקית; Agent למשחקי תפקידים דורש פרומפט ובדיקות משלו.