Πώς να δημιουργήσετε bot στο Telegram με το BotFather και να προσθέσετε AI

Για να δημιουργήσετε bot στο Telegram, ανοίξτε το BotFather, στείλτε /newbot, επιλέξτε όνομα και όνομα χρήστη και αντιγράψτε το token του bot στην υπηρεσία που θα το λειτουργεί. Σε αυτόν τον οδηγό, η υπηρεσία είναι το Quickchat AI: δίνει στο bot έναν AI Agent που απαντά από τη δική σας γνώση, χωρίς να γράψετε κώδικα ή να διαχειρίζεστε διακομιστή.

Θα δημιουργήσετε το Fernway Languages, μια φανταστική διαδικτυακή σχολή αγγλικών. Ο μαθητής μπορεί να ανοίξει το bot της στο Telegram, να ελέγξει τις τιμές των μαθημάτων, να πατήσει /schedule, να ζητήσει έναν οδηγό μαθημάτων σε PDF και να ζητήσει να μιλήσει με άνθρωπο. Η ολοκληρωμένη εμπειρία παραμένει στη συνομιλία Telegram του μαθητή· η ομάδα σας διαχειρίζεται τη γνώση, τα Actions και τις συνομιλίες στο Quickchat AI.

Η βασική ρύθμιση ξεκινά από τη δημιουργία του bot και φτάνει στη δοκιμή των απαντήσεών του. Έπειτα προσθέστε αποστολή PDF και μεταβίβαση σε άνθρωπο. Η ενότητα για τις ομαδικές συνομιλίες εξηγεί πώς να κρατήσετε προβλέψιμες τις απαντήσεις σε μια κοινή συνομιλία.

Κατεβάστε το πακέτο ρύθμισης Fernway με τη γνώση, το Main Prompt, τη λίστα εντολών, το φύλλο δοκιμών, την εικόνα προφίλ και το δείγμα PDF. Τα αρχεία είναι επεξεργάσιμα παραδείγματα για επικόλληση στον πίνακα ελέγχου, όχι αυτόματη εισαγωγή Agent.

Τα στιγμιότυπα οθόνης, οι ονομασίες στη διεπαφή και το υλικό επίδειξης που μπορείτε να αντιγράψετε παραμένουν στα αγγλικά, ώστε να αναπαράγετε το παράδειγμα όπως ακριβώς εμφανίζεται.

Τι χρειάζεστε για να δημιουργήσετε bot στο Telegram χωρίς προγραμματισμό;

Χρειάζεστε λογαριασμό Telegram, λογαριασμό Quickchat AI και ένα νέο bot για την άσκηση. Το BotFather δημιουργεί την ταυτότητα στο Telegram· το Quickchat AI λειτουργεί τον Agent που βρίσκεται πίσω της.

1. Συνδεθείτε στο Telegram από κινητό ή υπολογιστή. Χρησιμοποιήστε το επίσημο BotFather από τον σύνδεσμο στο Βήμα 1, όχι λογαριασμό με παρόμοιο όνομα.
2. Δημιουργήστε λογαριασμό Quickchat AI και ολοκληρώστε την επαλήθευση email αν ζητηθεί. Το πρόγραμμα Free υποστηρίζει προσωπική, μη εμπορική μάθηση με τις μονάδες που περιλαμβάνει. Για πραγματική επαγγελματική χρήση, επιλέξτε εμπορικό πρόγραμμα. Οι απαντήσεις AI και το Simulation Testing καταναλώνουν μονάδες· δείτε τα τρέχοντα προγράμματα και όρια.
3. Κρατήστε ανοιχτές και τις δύο εφαρμογές. Χρησιμοποιήστε νέο δοκιμαστικό bot, ώστε η άσκηση να μην αλλάξει υπάρχον κανάλι υποστήριξης. Ένας δεύτερος λογαριασμός Telegram είναι χρήσιμος για τον έλεγχο της εμπειρίας νέου επισκέπτη.

Το Telegram δεν χρεώνει την καταχώριση bot. Η υπηρεσία που δημιουργεί τις απαντήσεις AI έχει δικά της όρια χρήσης. Δεν χρειάζεστε ξεχωριστό κλειδί API μοντέλου για αυτήν τη ρύθμιση.

Τι κάνει το BotFather και τι κάνει το AI;

Το BotFather διαχειρίζεται την ταυτότητα και τις ρυθμίσεις του bot. Ο συνδεδεμένος Agent αποφασίζει πώς θα απαντήσει, χρησιμοποιώντας τη γνώση και τις οδηγίες του. Η δημιουργία του bot από μόνη της δεν του παρέχει πληροφορίες για μαθήματα ή πρόγραμμα που απαντά σε μηνύματα.

Το Telegram παραδίδει το μήνυμα του μαθητή στη συνδεδεμένη υπηρεσία. Η απάντηση του Agent επιστρέφει στην ίδια συνομιλία.

Βήμα 1: Πώς δημιουργείτε bot στο Telegram με το BotFather;

Στείλτε /newbot στο επίσημο BotFather και δώστε όνομα εμφάνισης και μοναδικό όνομα χρήστη.

1. Ανοίξτε το @BotFather στο Telegram και επιλέξτε Start.
2. Στείλτε /newbot.
3. Όταν σας ζητηθεί όνομα, στείλτε Fernway Languages. Αυτό είναι το όνομα εμφάνισης που βλέπουν οι μαθητές.
4. Όταν σας ζητηθεί όνομα χρήστη, επιλέξτε κάτι όπως fernway_lessons_yourname_bot. Αντικαταστήστε το yourname με μοναδική κατάληξη. Χρησιμοποιήστε 5 έως 32 λατινικά γράμματα, ψηφία ή κάτω παύλες· τα ονόματα χρήστη δεν κάνουν διάκριση πεζών και κεφαλαίων. Για αυτήν τη συνηθισμένη δωρεάν ρύθμιση, χρησιμοποιήστε όνομα που τελειώνει σε bot. Αν το όνομα χρησιμοποιείται ήδη, δοκιμάστε άλλη κατάληξη. Το BotFather προσφέρει επίσης άλλες καταλήξεις σε λογαριασμούς Premium που πληρούν τις προϋποθέσεις.
5. Το BotFather επιστρέφει τον σύνδεσμο του bot και το token ελέγχου ταυτότητάς του. Αποθηκεύστε τον σύνδεσμο· θα τον χρησιμοποιήσετε για να ανοίξετε τη συνομιλία που βλέπει ο μαθητής. Κρατήστε το token ιδιωτικό για το Βήμα 4.

Η διεπαφή εντολών επαρκεί για αυτόν τον οδηγό. Το BotFather μπορεί επίσης να προσφέρει Mini App για διαχείριση bots· χρησιμοποιήστε τις παρακάτω εντολές αν η οθόνη σας διαφέρει.

Πού βρίσκετε το token του bot σας στο Telegram;

Στείλτε /mybots στο BotFather, επιλέξτε το bot σας και ανοίξτε το API Token. Το token επαληθεύει τα αιτήματα που γίνονται εκ μέρους του bot. Επικολλήστε το μόνο στο ειδικό πεδίο διαπιστευτηρίων της υπηρεσίας, όχι στο prompt ή στη γνώση του Agent, σε συνομιλία υποστήριξης ή σε στιγμιότυπο οθόνης.

Αν εκτεθεί ένα token, στείλτε /revoke στο BotFather, επιλέξτε το bot και αποκτήστε νέο. Ενημερώστε τη συνδεδεμένη υπηρεσία με το νέο token και δοκιμάστε μια απάντηση. Το παλιό διαπιστευτήριο παύει να λειτουργεί· η αλλαγή ονόματος του bot ή η διαγραφή ενός στιγμιότυπου οθόνης δεν το ακυρώνει.

Ένα webhook έχει έναν προορισμό. Η σύνδεση του ίδιου bot με άλλη υπηρεσία μπορεί να αντικαταστήσει το webhook που παραδίδει εισερχόμενα μηνύματα στο Quickchat AI. Ξεχωριστές υπηρεσίες μπορούν να κάνουν εξερχόμενες κλήσεις API με το ίδιο token, αλλά δεν λαμβάνουν αυτόματα η καθεμία αντίγραφο των εισερχόμενων ενημερώσεων. Το Telegram επίσης εμποδίζει το polling με getUpdates όσο υπάρχει εγκατεστημένο webhook. Χρησιμοποιήστε ξεχωριστό bot για ξεχωριστή ροή εισερχόμενων μηνυμάτων. Η τεκμηρίωση παράδοσης ενημερώσεων του Telegram εξηγεί τους δύο μηχανισμούς.

Βήμα 2: Πώς προσθέτετε εικόνα, περιγραφή και μενού εντολών;

Χρησιμοποιήστε τις εντολές προφίλ του BotFather, ώστε ο μαθητής να αναγνωρίζει το bot πριν στείλει το πρώτο μήνυμα. Μετά από κάθε εντολή, επιλέξτε το bot σας και υποβάλετε την παρακάτω τιμή.

Description (έως 512 χαρακτήρες):

Ask Fernway Languages about English courses, prices and weekly class times. Request the course guide or ask to speak to the team. This is a fictional school built for a tutorial.

About text (έως 120 χαρακτήρες):

English courses, prices and class times. A fictional school for a Quickchat AI tutorial.

Λίστα εντολών: επικολλήστε και τις τέσσερις γραμμές μαζί. Τα ονόματα των εντολών δεν έχουν αρχική κάθετο σε αυτήν τη λίστα του BotFather.

prices - Course prices
schedule - Weekly class times
trial - Request a free trial lesson
help - Talk to a person

Ανοίξτε το προφίλ του bot και ελέγξτε το όνομα, την εικόνα και το σύντομο κείμενό του. Ανοίξτε τη συνομιλία του πριν επιλέξετε Start, για να ελέγξετε την εισαγωγή. Το Telegram περιγράφει τις επιμέρους ρυθμίσεις στον οδηγό του BotFather.

Αφού συνδέσετε το bot στο Βήμα 4 και επιλέξετε Start, ανοίξτε το μενού εντολών και ελέγξτε και τις τέσσερις καταχωρίσεις. Διατηρήστε τις αλλαγές γραμμής όταν επικολλάτε τη λίστα στο BotFather· διαφορετικά, πολλές καταχωρίσεις μπορεί να γίνουν μία μεγάλη περιγραφή εντολής.

Η προσθήκη του /schedule στο μενού δεν υλοποιεί αναζήτηση προγράμματος μαθημάτων. Στο επόμενο βήμα εξηγείτε στον Agent τι σημαίνει αυτό το μήνυμα.

Βήμα 3: Πώς κάνετε το bot Telegram να απαντά από τη δική σας γνώση;

Δημιουργήστε έναν Agent, προσθέστε τα στοιχεία της σχολής στο Knowledge Base και βάλτε τους κανόνες απάντησης στο Main Prompt. Ο διαχωρισμός των στοιχείων από τις οδηγίες διευκολύνει την αλλαγή μιας τιμής χωρίς να αλλάζει η συμπεριφορά του bot.

Τα στιγμιότυπα οθόνης ανοίγουν σε πλήρες μέγεθος όταν τα επιλέγετε. Χρησιμοποιήστε τα πλαίσια για αντιγραφή του ακριβούς κειμένου και των τιμών των αιτημάτων.

Προσθέστε τις πληροφορίες των μαθημάτων

1. Στο Quickchat AI, δημιουργήστε νέο Agent και ονομάστε τον Fernway Languages. Στο Identity, ορίστε το ίδιο όνομα.
2. Ανοίξτε το Knowledge Base, επιλέξτε Add Article και χρησιμοποιήστε το Fernway Languages course guide ως Title.
3. Επικολλήστε το παρακάτω στο Content και πατήστε Save. Περιμένετε να ολοκληρωθεί η επεξεργασία και να εμφανιστεί η κατάσταση Ready στο άρθρο. Ολοκληρώστε τυχόν βήμα δημοσίευσης ή εφαρμογής που εμφανίζεται πριν δοκιμάσετε το πραγματικό κανάλι.

Fernway Languages is a fictional online English school used for this tutorial.

Courses
B1 English: EUR120 total for a four-week course. Classes are on Tuesdays and Thursdays, 18:00 to 19:00 UTC.
A2 English: EUR90 total for a four-week course. Classes are on Mondays and Wednesdays, 18:00 to 19:00 UTC.
Both courses meet online. Prices are for the complete four-week course, not per lesson.

Trial lessons
A free trial lesson lasts 20 minutes. Ask the student which course interests them and which day and time they prefer, including their time zone. A member of the Fernway team must confirm availability. The bot cannot book or confirm a trial lesson.

Refunds
Students can receive a full refund if they cancel at least 48 hours before their first class. The team reviews requests made later; no refund is promised for those requests.

Course brochure
The course guide contains the same course prices, weekly schedule, trial policy and refund policy. Send it only when the student asks for the brochure or course guide.

Placement
The team handles level placement. This knowledge base does not contain a placement-test score cutoff or rules that convert a test score into a course level. Do not invent a cutoff or interpret a student's score.

Η απουσία ορίου βαθμολογίας για την κατάταξη προσφέρει μια ουσιαστική δοκιμή. Ο Agent μπορεί να απαντήσει για την τιμή του B1 από μια πηγή, αλλά δεν πρέπει να επινοεί τη βαθμολογία που χρειάζεται ένας μαθητής για να συμμετάσχει.

Δώστε στις εντολές τη σημασία τους

Ανοίξτε το Identity, επιλέξτε την κάρτα Main Prompt με την ένδειξη Edit και επικολλήστε ολόκληρο το παρακάτω prompt. Αφήστε το να αποθηκευτεί αυτόματα και ανοίξτε το ξανά για να ελέγξετε το αποθηκευμένο κείμενο.

You are the Fernway Languages assistant. Help prospective students understand the English courses using the Knowledge Base.

Answer the student's question directly. Use plain text, short paragraphs and no Markdown tables. Keep routine answers under 100 words. State prices in EUR and class times in UTC unless the student explicitly asks for a conversion.

Treat /prices as a request for the course prices. Treat /schedule as a request for the weekly class times. Treat /trial as a request for a free trial lesson: explain that it lasts 20 minutes, ask for the preferred course, day, time and time zone, and make clear that the team must confirm availability. Treat /help as a request to speak to a person. These commands may include a bot username after an @ sign; apply the same rule to /prices@username, /schedule@username, /trial@username and /help@username.

Call send_course_brochure only when the student explicitly asks to receive the brochure or course guide. Do not call it for a price or schedule question alone. Do not ask for a chat ID, token or email address to send it. Say that the brochure was sent only after the action succeeds. If it fails, say that the file could not be sent and offer to explain the courses in the chat.

Use only the Knowledge Base for course facts and policies. If a requested fact is missing, say that the team will need to confirm it. Never invent placement-test cutoffs, available trial slots, bookings, refunds or course discounts.

If the student asks for a person, use Human Handoff. Do not promise an immediate response or pretend a staff member has already replied.

Αυτό το prompt περιλαμβάνει τα προαιρετικά βήματα για το ενημερωτικό φυλλάδιο και τη μεταβίβαση που θα ρυθμίσετε αργότερα. Ολοκληρώστε τα πριν μοιραστείτε το bot ως πλήρη υπηρεσία υποστήριξης μαθητών. Ένα prompt μπορεί να ζητήσει ένα Action· δεν δημιουργεί αυτό το Action ούτε συνδέει το Telegram.

Οι μορφές με συγκεκριμένο παραλήπτη, όπως /schedule@your_bot, έχουν σημασία όταν το bot συμμετέχει σε ομάδα. Η οδηγία για απλό κείμενο έχει επίσης σημασία: οι συνηθισμένες απαντήσεις αυτής της ενσωμάτωσης αποστέλλονται χωρίς μορφοποίηση Markdown του Telegram.

Ορίστε το μήνυμα καλωσορίσματος

Ανοίξτε το Your Website, επιλέξτε την καρτέλα Text Content και επεξεργαστείτε το Welcome message. Αυτός ο κοινός χαιρετισμός χρησιμοποιείται και από τη σύνδεση του δικού σας bot Telegram:

Welcome to Fernway Languages. I can help with our English courses, prices and class times. Try /prices, /schedule or /trial, or ask a question. Use /help to ask for a person.

Η ενσωμάτωση του δικού σας bot στέλνει αυτόν τον ρυθμισμένο χαιρετισμό όταν ένας επισκέπτης στείλει /start. Είναι διαφορετικός από την περιγραφή του BotFather πριν από τη συνομιλία και από μια απάντηση AI σε ερώτηση για τα μαθήματα.

Βήμα 4: Πώς συνδέετε το token με το Quickchat AI;

Συνδεθείτε μέσω του Your own bot για να χρησιμοποιήσετε την ταυτότητα Telegram που μόλις δημιουργήσατε.

1. Ανοίξτε το External Apps, επιλέξτε Telegram και έπειτα Your own bot.
2. Επιλέξτε Connect to Telegram, επικολλήστε το token του BotFather στο Bot Token και πατήστε Connect to Telegram μέσα στο παράθυρο διαλόγου για υποβολή.
3. Ενεργοποιήστε το Enable your own bot και έπειτα επιλέξτε Save.
4. Ανοίξτε τον σύνδεσμο t.me του bot στο Telegram. Επιλέξτε Start ή στείλτε /start για να ελέγξετε τον χαιρετισμό.

Η επιλογή κοινόχρηστου Quickchat AI bot στον πίνακα ελέγχου είναι διαφορετική ρύθμιση. Παρέχει σύνδεσμο συνομιλίας για συγκεκριμένο Agent χωρίς να δημιουργήσετε δικό σας bot· ο βασικός οδηγός χρησιμοποιεί δική σας ταυτότητα και διαπιστευτήριο. Ο οδηγός AI chatbot στο Telegram καλύπτει την κοινόχρηστη διαδρομή.

Αν το παράθυρο σύνδεσης περιγράφει την απενεργοποίηση της λειτουργίας ιδιωτικότητας για ομάδες, αφήστε την ενεργή για τη ροή εντολών με συγκεκριμένο παραλήπτη αυτού του οδηγού. Οι ιδιωτικές συνομιλίες λειτουργούν ανεξάρτητα από τη ρύθμιση ιδιωτικότητας ομάδων. Η ενότητα για τις ομάδες εξηγεί τις συνέπειες της επιλογής.

Βήμα 5: Πώς δοκιμάζετε το bot σας στο Telegram;

Ελέγξτε τόσο την απάντηση του Agent όσο και το μήνυμα που παραδίδεται στο Telegram. Μια δοκιμή στον πίνακα ελέγχου επαληθεύει τη λογική απάντησης· μόνο μια συνομιλία Telegram επαληθεύει ολόκληρο το κανάλι.

Δοκιμάστε τις απαντήσεις στο Quickchat AI

Ανοίξτε το Testing, επιλέξτε Create Dataset, ονομάστε το Fernway course answers και προσθέστε αυτά τα μηνύματα ως ξεχωριστές γραμμές:

How much is the B1 English course?
/prices
/schedule
/schedule@fernway_demo_bot
/trial
I scored 62 on your placement test. Do I qualify for B1?

Η γραμμή εντολής με συγκεκριμένο παραλήπτη χρησιμοποιεί ενδεικτικό όνομα χρήστη για να ελέγξει τον κανόνα του prompt. Για την πραγματική δοκιμή στο Telegram, χρησιμοποιήστε το πραγματικό όνομα χρήστη του bot σας.

Στο Evaluation criteria, χρησιμοποιήστε:

Fernway Languages is a fictional English school. B1 costs EUR120 total for four weeks and meets Tuesdays and Thursdays, 18:00 to 19:00 UTC. A2 costs EUR90 total for four weeks and meets Mondays and Wednesdays, 18:00 to 19:00 UTC. A free trial lasts 20 minutes and requires team confirmation; no booking may be claimed. Commands must be treated as requests for the corresponding information. No placement-score cutoff is known, so the Agent must not decide a level from a score. Replies should be brief, plain text and based on these facts. Evaluate reply content only. This test cannot verify Telegram delivery, a received PDF or human assignment.

Επιλέξτε Run με διαθέσιμες μονάδες AI. Κάθε γραμμή ξεκινά ξεχωριστή συνομιλία. Χρησιμοποιήστε μία συνεχή συνομιλία AI Preview για να δοκιμάσετε συμπληρωματικές ερωτήσεις, αντί να θεωρείτε την επόμενη γραμμή του συνόλου δεδομένων ως επόμενο μήνυμα της ίδιας συνομιλίας.

Δοκιμάστε την εμπειρία του μαθητή στο Telegram

Στείλτε τα παρακάτω στην ιδιωτική συνομιλία του πραγματικού bot, περιμένοντας κάθε απάντηση. Χρησιμοποιήστε το Inbox για να βρείτε την αντίστοιχη ερώτηση και απάντηση.

Αφήστε την ερώτηση βαθμολογίας κατάταξης για το τέλος, μετά τα Βήματα 6 και 7. Μπορεί να μεταβιβάσει τη συνομιλία στο προσωπικό και να διακόψει προσωρινά τις αυτόματες απαντήσεις.

Στην πραγματική δοκιμή, ο Agent δεν συμπέρανε επίπεδο από τη βαθμολογία. Το Inbox έδειξε έπειτα τη συνομιλία ως Unassigned, με ενεργή τη μεταβίβαση Lack Of Knowledge. Ελέγξτε την απάντηση και την ανάθεση ξεχωριστά· ένας αξιολογητής απαντήσεων δεν μπορεί να διαπιστώσει ποιος έχει αναλάβει τη συνομιλία. Εκτελέστε αυτόν τον έλεγχο κατάταξης μετά τις υπόλοιπες δοκιμές συνομιλίας ή επιλέξτε AI Agent στο μενού υπευθύνου του Inbox πριν συνεχίσετε τις αυτόματες απαντήσεις.

Αν μια απάντηση είναι λανθασμένη, εξετάστε το σχετικό άρθρο γνώσης και το αποθηκευμένο prompt, αλλάξτε ένα στοιχείο και επαναλάβετε το ίδιο μήνυμα σε νέα συνομιλία. Αν αποτύχει μια εντολή, ελέγξτε τον ακριβή κανόνα της· αν είναι λάθος η τιμή ενός μαθήματος, ελέγξτε την ανάκτηση και τη δημοσίευση της γνώσης. Καταγράψτε την πραγματική απάντηση αντί να θεωρείτε ότι η ρύθμιση πέτυχε επειδή η ένδειξη σύνδεσης είναι πράσινη.

Το σύνολο δεδομένων έξι μηνυμάτων είναι ένα σημείο εκκίνησης. Ο οδηγός δοκιμών AI Agent υποστήριξης δείχνει πώς να το επεκτείνετε με ρεαλιστικές περιπτώσεις αποτυχίας και κριτήρια βαθμολόγησης πριν από την κυκλοφορία.

Βήμα 6: Πώς κάνετε το bot να στέλνει PDF;

Προσθέστε ένα API Action που στέλνει έναν σταθερό οδηγό μαθημάτων στην τρέχουσα συνομιλία Telegram. Ο Agent αποφασίζει αν το ζήτησε ο μαθητής· η ενσωμάτωση παρέχει το διαπιστευτήριο και τον προορισμό.

Ο μαθητής δεν παρέχει token ή αναγνωριστικό συνομιλίας. Το Action δεν έχει παραμέτρους που συμπληρώνει το μοντέλο.

Κατεβάστε το fernway-course-guide.pdf από το πακέτο για να εξετάσετε το δείγμα. Η συνταγή χρησιμοποιεί τη δημόσια διεύθυνσή του σε αυτόν τον ιστότοπο. Για δικό σας αρχείο, χρησιμοποιήστε απευθείας διεύθυνση HTTPS από την οποία το Telegram μπορεί να κατεβάσει χωρίς σύνδεση ένα PDF με τον σωστό τύπο περιεχομένου. Κρατήστε τα έγγραφα που λαμβάνονται μέσω URL κάτω από 20 MB. Το Telegram διαχωρίζει τη λήψη μέσω URL από τη μεταφόρτωση αρχείων στην τεκμηρίωση αποστολής αρχείων.

Ανοίξτε το Actions & MCPs, επιλέξτε Add Action, διαλέξτε το εργαλείο δημιουργίας API Action και ρυθμίστε τα παρακάτω πεδία. Αν το εργαλείο προτείνει ένα αυτόματα δημιουργημένο προσχέδιο, συγκρίνετε το πραγματικό αίτημα με τη συνταγή πριν το ενεργοποιήσετε.

API Action Name

send_course_brochure

What to ask the user first

API Endpoint: μέθοδος και URL

Επιλέξτε POST και εισαγάγετε:

https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument

Χρησιμοποιήστε το Add AI Data για να εισαγάγετε το telegram_bot_token από το System Tokens. Αυτή είναι αναφορά στο διαπιστευτήριο του συνδεδεμένου bot, όχι πεδίο για να επικολλήσετε το ίδιο το token.

Headers

Body: επικολλήστε στην καρτέλα Body του API Endpoint.

{
  "chat_id": "{{metadata_telegram_chat_id}}",
  "document": "https://quickchat.ai/blog-assets/tutorials/create-telegram-bot/fernway-course-guide.pdf",
  "caption": "Fernway Languages course guide (fictional tutorial example)"
}

Εισαγάγετε το telegram_chat_id από τα μεταδεδομένα συνομιλίας μέσω του Add AI Data. Η μορφή του στο πρότυπο είναι {{metadata_telegram_chat_id}}. Το κανάλι Telegram το ορίζει από την εισερχόμενη συνομιλία, ώστε το PDF να επιστρέφει σε αυτήν. Αφήστε σταθερά τη διεύθυνση του εγγράφου και τη λεζάντα.

API Action Description

Send the Fernway Languages course guide PDF to the current Telegram chat when the student explicitly asks to receive the brochure or course guide. Do not call this action for a price, schedule or trial question alone. No information needs to be collected from the student: the current chat and bot credentials are supplied automatically. Call it once per explicit request. Confirm delivery only if the request succeeds.

Αποθηκεύστε και ενεργοποιήστε το Action. Το πλήρες Main Prompt περιλαμβάνει ήδη τον κανόνα για ρητό αίτημα. Η μέθοδος του Bot API τεκμηριώνεται στο sendDocument.

Επαληθεύστε το αρχείο, όχι μόνο την απάντηση

1. Στο Telegram, στείλτε How much is the B1 English course?. Ελέγξτε ότι λαμβάνετε την τιμή χωρίς αρχείο που δεν ζητήσατε.
2. Στείλτε Can you send me the brochure?.
3. Επιβεβαιώστε ότι φτάνει ένα συνημμένο PDF και ότι, όταν το ανοίγετε, εμφανίζει τον οδηγό μαθημάτων Fernway.
4. Στο Inbox, ανοίξτε αυτήν τη συνομιλία και αναπτύξτε την κάρτα του Action που κλήθηκε. Στην κάρτα του Action στο Actions & MCPs, ανοίξτε το View logs για να εξετάσετε το αίτημα και το αποτέλεσμα. Καλύψτε το token πριν κοινοποιήσετε στιγμιότυπο οθόνης.
5. Επιβεβαιώστε ότι ο προορισμός είναι η τρέχουσα συνομιλία και ότι στάλθηκε ένα έγγραφο για το αίτημα.

Στην πραγματική δοκιμή, το send_course_brochure επέστρεψε HTTP 200 με απόκριση ok: true από το Telegram. Το αρχικό στιγμιότυπο οθόνης δείχνει το συνημμένο fernway-course-guide.pdf που προέκυψε στη συνομιλία του μαθητή. Το αποτέλεσμα του αιτήματος μαζί με το αρχείο που παραλήφθηκε επαληθεύουν την παράδοση· το κείμενο επιβεβαίωσης του Agent από μόνο του δεν αρκεί.

Εκτελέστε τη δοκιμή παράδοσης στο Telegram. Οι συνομιλίες Simulation δεν έχουν το πραγματικό πλαίσιο του token του bot Telegram. Χρησιμοποιήστε το Simulation για ελέγχους απαντήσεων και την πραγματική συνομιλία Telegram για τον έλεγχο παράδοσης αρχείου.

Βήμα 7: Πώς μεταβιβάζετε μια συνομιλία Telegram σε άνθρωπο;

Ενεργοποιήστε το Human Handoff, ώστε ένα αίτημα για άνθρωπο να αλλάζει ποιος έχει αναλάβει τη συνομιλία, και έπειτα ζητήστε από μέλος της ομάδας να απαντήσει από το Inbox.

1. Ανοίξτε το Actions & MCPs, ενεργοποιήστε το Human Handoff και επιλέξτε Edit Action.
2. Διατηρήστε τα προεπιλεγμένα Handoff Rules, με ενεργά τα Media Message, User Frustration, Customer Support Suggestion και Lack Of Knowledge, και ανενεργό το Irrelevant Advice. Το Main Prompt ήδη αντιστοιχίζει το /help σε αίτημα για άνθρωπο· αυτή η επίδειξη δεν προσθέτει προσαρμοσμένο κανόνα μεταβίβασης.
3. Για την άσκηση με επίβλεψη, αφήστε ανενεργό το Human Agents’ availability και κρατήστε ένα μέλος της ομάδας στο Inbox κατά τη δοκιμή. Αφήστε ανενεργό το Email notifications. Αυτές ήταν οι ρυθμίσεις της επίδειξης· η μεταβίβαση χωρίς περιορισμούς δεν σημαίνει ότι κάποιος είναι πάντα διαθέσιμος.
4. Πριν από την κυκλοφορία, ενεργοποιήστε το πρόγραμμα διαθεσιμότητας και ορίστε τη ζώνη ώρας και το ωράριο με βάση τις πραγματικές ώρες στελέχωσης. Ρυθμίστε ανάλογα το μήνυμα εκτός ωραρίου.
5. Αποθηκεύστε το Action. Στην ιδιωτική συνομιλία του bot, στείλτε I want to talk to a person. Αν το bot ζητήσει επιβεβαίωση, απαντήστε Yes.
6. Στο Inbox, ελέγξτε ότι η συνομιλία δεν είναι πλέον ανατεθειμένη στο AI. Επιλέξτε Assign to me και στείλτε Hi, this is Alex from Fernway. Which course would you like help with?. Επαληθεύστε ότι το μήνυμα φτάνει στο Telegram.
7. Στείλτε ακόμη ένα μήνυμα μαθητή όσο τη συνομιλία έχει αναλάβει άνθρωπος. Επιβεβαιώστε ότι το AI παραμένει σιωπηλό. Ανοίξτε το μενού υπευθύνου και επιλέξτε AI Agent, έπειτα στείλτε νέα ερώτηση για τα μαθήματα για να επαληθεύσετε ότι συνεχίζονται οι αυτόματες απαντήσεις.

Ο μαθητής παραμένει στο Telegram. Η επιτυχής μεταβίβαση απαιτεί αλλαγή ανάθεσης και παράδοση ανθρώπινης απάντησης. Επιλέξτε AI Agent στο μενού υπευθύνου όταν πρέπει να συνεχιστούν οι αυτόματες απαντήσεις.

Ένα στοιχείο που λείπει μπορεί να οδηγήσει σε μεταβίβαση, όπως συνέβη στην τοπική δοκιμή κατάταξης. Ελέγξτε τα δύο αποτελέσματα ξεχωριστά: η απάντηση πρέπει να αποφεύγει τις εικασίες και κάθε μεταβίβαση που δηλώνεται πρέπει να αλλάζει τον υπεύθυνο στο Inbox. Ο οδηγός Human Handoff εξηγεί αναλυτικότερα τη διαθεσιμότητα και τη δρομολόγηση.

Ο αναλυτικός οδηγός μεταβίβασης chatbot σε άνθρωπο προσθέτει δοκιμές για αιτήματα εκτός ωραρίου και για το αν οι αυτόματες απαντήσεις συνεχίζουν να λειτουργούν μετά την εκ νέου ανάθεση.

Πώς συμπεριφέρεται το bot σε ομάδα Telegram;

Η λειτουργία ιδιωτικότητας ελέγχει ποια μηνύματα ομάδας παραδίδει το Telegram σε ένα bot. Η σύνδεση του δικού σας bot με το Quickchat AI επεξεργάζεται τα μηνύματα που λαμβάνει· δεν προσθέτει ξεχωριστό φίλτρο «απάντηση μόνο σε αναφορές».

Το διάγραμμα καλύπτει τους τύπους μηνυμάτων που χρησιμοποιούνται στον οδηγό. Το Telegram τεκμηριώνει επίσης μηνύματα υπηρεσίας και δρομολόγηση εντολών που εξαρτάται από το πλαίσιο.

Για ομάδα τάξης όπου το bot πρέπει να απαντά σε άμεσα αιτήματα:

1. Στείλτε /setjoingroups στο BotFather, επιλέξτε το bot και ενεργοποιήστε τη συμμετοχή σε ομάδες αν είναι ανενεργή.
2. Στείλτε /setprivacy, επιλέξτε το bot και έπειτα Enable. Κρατήστε το ως απλό μέλος, χωρίς δικαιώματα διαχειριστή. Αν αλλάξατε τη λειτουργία ιδιωτικότητας αφού το προσθέσατε, αφαιρέστε το bot και προσθέστε το ξανά για να εφαρμοστεί η ρύθμιση.
3. Προσθέστε το bot σε μικρή δοκιμαστική ομάδα που ελέγχετε.
4. Στείλτε ένα συνηθισμένο μήνυμα, όπως See everyone in class tomorrow. Δεν πρέπει να προκαλέσει απάντηση με αυτήν τη ρύθμιση.
5. Στείλτε /schedule@your_bot, αντικαθιστώντας το your_bot με το πραγματικό όνομα χρήστη. Ελέγξτε την απάντηση για το πρόγραμμα μαθημάτων και έπειτα χρησιμοποιήστε τη χειρονομία Reply του Telegram πάνω σε αυτήν την απάντηση για να ρωτήσετε What does B1 cost?.

Ένα σκέτο /schedule μπορεί να εξαρτάται από το bot στο οποίο απευθύνθηκε η τελευταία εντολή. Μια αναφορά @mention σε απλό κείμενο δεν αντικαθιστά αξιόπιστα μια εντολή με συγκεκριμένο παραλήπτη με τη συνήθη λειτουργία ιδιωτικότητας. Χρησιμοποιήστε τις σαφείς μορφές της παραπάνω δοκιμής. Δείτε τους κανόνες λειτουργίας ιδιωτικότητας του Telegram.

Η ξεχωριστή δοκιμή ομάδας παρακάτω χρησιμοποίησε το κοινόχρηστο @QuickchatAI_bot, συνδεδεμένο με τον ίδιο Agent Fernway. Απάντησε σε εντολή προγράμματος με συγκεκριμένο παραλήπτη και σε ερώτηση τιμής που στάλθηκε ως απάντηση σε μήνυμα του bot. Αυτό δείχνει την εναλλακτική του κοινόχρηστου bot· το δικό μας προσαρμοσμένο bot Fernway επαληθεύτηκε σε ιδιωτική συνομιλία, επομένως η συμπεριφορά του σε ομάδα εξακολουθεί να χρειάζεται τους παραπάνω ελέγχους.

Η απενεργοποίηση της ιδιωτικότητας ή η ανάθεση δικαιωμάτων διαχειριστή στο bot μπορεί να επιτρέψει στη συνηθισμένη συζήτηση της ομάδας να φτάνει στον Agent και να παράγει περισσότερες απαντήσεις. Για εποπτεία, ο οδηγός διαχείρισης ομάδων Telegram εξηγεί τα πρόσθετα δικαιώματα και τους ελέγχους Actions.

Μια ομάδα είναι μία κοινή συνομιλία. Οι προσωπικές ερωτήσεις για συγκεκριμένα μαθήματα ανήκουν στην ιδιωτική συνομιλία του bot. Αν ενεργοποιηθεί Human Handoff στην ομάδα, παύει το AI για ολόκληρη την ομάδα μέχρι την εκ νέου ανάθεση· δεν δημιουργεί ξεχωριστή ιδιωτική συνομιλία για εκείνον τον μαθητή.

Γιατί δεν απαντά το bot σας στο Telegram;

Ξεκινήστε με την απλούστερη δοκιμή ιδιωτικής συνομιλίας και έπειτα ελέγξτε τη σύνδεση και τον τύπο μηνύματος. Η συμπεριφορά σε ομάδες και η παράδοση αρχείων έχουν ξεχωριστές εξαρτήσεις.

Πριν μοιραστείτε το bot, επαναλάβετε τους ελέγχους τιμής, άγνωστου στοιχείου, PDF και ανθρώπινης απάντησης σε ιδιωτική συνομιλία με το πραγματικό σας περιεχόμενο. Αντικαταστήστε κάθε στοιχείο και σύνδεσμο Fernway με δικό σας. Για την τρέχουσα αναφορά ρύθμισης της ενσωμάτωσης, χρησιμοποιήστε την τεκμηρίωση καναλιού Telegram.

Μπορούν το ChatGPT ή το Claude να βοηθήσουν στη δημιουργία αυτού του bot;

Μια εφαρμογή AI συνδεδεμένη με τον λογαριασμό σας Quickchat AI μπορεί να προετοιμάσει τον Agent, τη γνώση, τις οδηγίες, τα Actions και το σύνολο δεδομένων δοκιμών. Εξακολουθείτε να δημιουργείτε εσείς την ταυτότητα Telegram στο BotFather και να εισάγετε το token στη ροή του πίνακα ελέγχου για το δικό σας bot.

Συνδεθείτε μέσω της επαληθευμένης καταχώρισης ChatGPT ή της καταχώρισης Claude, ακολουθώντας τις οδηγίες Manage with AI. Δώστε στον βοηθό το πακέτο ρύθμισης και αυτό το αίτημα:

Create a separate learning Agent named Fernway Languages from this tutorial kit. Do not change existing Agents. Set its display name and Identity name, add the knowledge article, and copy the Main Prompt and welcome message exactly. Configure send_course_brochure from action.json but leave it inactive. Use only the System Token reference, never ask me to paste my real Telegram token into chat. Create the Fernway course-answer dataset and evaluation criteria. Prepare Human Handoff using the default rules and show me the availability settings to review. Read back the saved configuration. Do not run tests, spend credits, send Telegram messages or activate Actions yet. List the remaining owner steps: create and configure the bot in BotFather, enter its token under Your own bot, review working hours, activate the Action and complete the real-channel checks. Do not use the shared Telegram connection as a substitute for my own bot.

Η σύνδεση διαχείρισης λογαριασμού που χρησιμοποιείται εδώ είναι ξεχωριστή από τη διάθεση ενός Agent ως εργαλείου MCP. Μπορεί να βοηθήσει στη ρύθμιση της ροής· δεν αναιρεί την ανάγκη ελέγχου πραγματικής απάντησης και συνημμένου στο Telegram.

Συχνές ερωτήσεις

Πώς δημιουργώ bot στο Telegram χωρίς προγραμματισμό;

Ανοίξτε το επίσημο BotFather στο Telegram, στείλτε /newbot και επιλέξτε όνομα εμφάνισης και μοναδικό όνομα χρήστη που τελειώνει σε bot. Συνδέστε το token που θα λάβετε με μια υπηρεσία bot όπως το Quickchat AI. Προσθέστε τη γνώση και τις οδηγίες σας, ενεργοποιήστε τη σύνδεση και δοκιμάστε ένα ιδιωτικό μήνυμα. Το BotFather δημιουργεί την ταυτότητα· η συνδεδεμένη υπηρεσία παρέχει τις απαντήσεις.

Είναι δωρεάν η δημιουργία bot στο Telegram;

Η καταχώριση bot στο Telegram μέσω του BotFather είναι δωρεάν. Το Quickchat AI διαθέτει πρόγραμμα Free για προσωπική, μη εμπορική μάθηση, με περιορισμένες μονάδες AI. Η επαγγελματική χρήση απαιτεί εμπορικό πρόγραμμα. Οι απαντήσεις AI και το Simulation Testing καταναλώνουν μονάδες· η δημιουργία της ταυτότητας στο Telegram δεν περιλαμβάνει απεριόριστη χρήση AI.

Πού βρίσκω το token του bot μου στο Telegram;

Ανοίξτε το επίσημο BotFather, στείλτε /mybots, επιλέξτε το bot σας και πατήστε API Token. Επικολλήστε αυτό το διαπιστευτήριο στο ειδικό πεδίο Bot Token της υπηρεσίας bot. Μην το βάζετε σε prompt, άρθρο γνώσης, δημόσιο αποθετήριο ή στιγμιότυπο οθόνης.

Τι πρέπει να κάνω αν διαρρεύσει το token του bot μου στο Telegram;

Χρησιμοποιήστε το /revoke στο BotFather για να ακυρώσετε το εκτεθειμένο token, αποκτήστε νέο και ενημερώστε τη συνδεδεμένη υπηρεσία. Έπειτα δοκιμάστε μια απάντηση. Διαγράψτε και το εκτεθειμένο αντίγραφο, αλλά μην βασίζεστε μόνο στη διαγραφή: όποιος αποθήκευσε το παλιό token μπορεί να το χρησιμοποιεί μέχρι να ανακληθεί.

Μπορώ να συνδέσω ένα bot Telegram με δύο πλατφόρμες;

Ένα bot έχει έναν προορισμό webhook για τις εισερχόμενες ενημερώσεις. Αν μια δεύτερη πλατφόρμα αντικαταστήσει αυτό το webhook, η πρώτη σταματά να λαμβάνει τις ενημερώσεις. Πολλά συστήματα μπορούν να συνεχίσουν να πραγματοποιούν εξερχόμενες κλήσεις API, αλλά τα εισερχόμενα μηνύματα δεν αντιγράφονται αυτόματα και στα δύο. Χρησιμοποιήστε ξεχωριστά bots για ανεξάρτητες ροές εισερχόμενων μηνυμάτων.

Πώς προσθέτω εντολές στο bot μου στο Telegram;

Στείλτε /setcommands στο BotFather, επιλέξτε το bot και δώστε ένα ζεύγος εντολής και περιγραφής ανά γραμμή, χωρίς αρχική κάθετο. Έτσι δημιουργείται το μενού. Πρέπει επίσης να υλοποιήσετε τη συμπεριφορά: σε αυτόν τον οδηγό, το Main Prompt αντιστοιχίζει τα /prices, /schedule, /trial και /help στις αντίστοιχες απαντήσεις ή στο κατάλληλο Action.

Γιατί το bot μου στο Telegram απαντά ιδιωτικά αλλά όχι σε ομάδα;

Ελέγξτε ότι το bot είναι μέλος της ομάδας και δοκιμάστε μια εντολή που απευθύνεται στο πραγματικό όνομα χρήστη του, όπως /schedule@your_bot, ή απαντήστε σε ένα μήνυμά του. Με ενεργή τη λειτουργία ιδιωτικότητας, τα συνηθισμένα μηνύματα της ομάδας δεν παραδίδονται σε bot που δεν είναι διαχειριστής. Μια αναφορά σε απλό κείμενο δεν αντικαθιστά αξιόπιστα μια εντολή με συγκεκριμένο παραλήπτη.

Μπορώ να προσθέσω AI ή ChatGPT σε bot Telegram;

Μπορείτε να συνδέσετε ένα bot του BotFather με μια υπηρεσία AI. Αυτός ο οδηγός χρησιμοποιεί έναν Quickchat AI Agent με δική του γνώση, Main Prompt και Actions· δεν συνδέει την προσωπική σας συνομιλία ChatGPT με το Telegram. Ένας συμβατός βοηθός διαχείρισης λογαριασμού μπορεί να προετοιμάσει τον Agent, ενώ ο κάτοχος ολοκληρώνει τη σύνδεση του δικού του bot.

Μπορεί αυτό το bot Telegram να απαντά σε φωνητικά μηνύματα;

Η ενσωμάτωση Telegram του Quickchat AI δεν απομαγνητοφωνεί επί του παρόντος φωνητικά μηνύματα για τον Agent. Ένα συνημμένο ήχου μπορεί να εμφανιστεί στο Inbox, αλλά ο οδηγός βασίζεται σε γραπτά μηνύματα. Ζητήστε από τον μαθητή να πληκτρολογήσει την ερώτησή του ή από έναν άνθρωπο να ελέγξει το συνημμένο.

Αυτοματοποιείται έτσι ο προσωπικός μου λογαριασμός Telegram;

Όχι. Αυτός ο οδηγός δημιουργεί ξεχωριστή ταυτότητα bot με δικό της όνομα χρήστη. Το Telegram προσφέρει άλλες δυνατότητες αυτοματοποίησης λογαριασμών, αλλά η σύνδεση Quickchat AI που περιγράφεται εδώ διαχειρίζεται μηνύματα προς το bot· δεν ρυθμίζει απαντήσεις από το προσωπικό σας προφίλ.