Ένας καφές, ένα εισιτήριο λεωφορείου, ένα σημειωματάριο. Οι μικρές αγορές ξεχνιούνται εύκολα μέχρι να ανοίξετε το υπολογιστικό φύλλο. Κι αν αρκούσε ένα μήνυμα στο Telegram για να καταγράψετε μία και άλλο ένα για να ελέγξετε το σύνολο του μήνα;
Σε αυτόν τον οδηγό δημιουργούμε το Pocket Ledger, έναν καταγραφέα εξόδων στο Telegram με Google Sheets. Στείλτε μια αγορά, επιβεβαιώστε τα προτεινόμενα στοιχεία και ρωτήστε για το μηνιαίο σύνολό σας. Το φύλλο αποθηκεύει τις γραμμές και κάνει τους υπολογισμούς· το bot αναλαμβάνει τη συνομιλία. Αυτό είναι το τελικό αποτέλεσμα.
Το ίδιο αποτέλεσμα στο φύλλο. Ο καφές των 4,50 EUR αυξάνει τα 7,70 EUR σε 12,20 EUR· τα 6,00 USD παραμένουν ξεχωριστά.
Τα στιγμιότυπα ακολουθούν μια ζωντανή επίδειξη με φανταστικά έξοδα. Ελέγξαμε την αποθηκευμένη γραμμή σε σχέση με την κλήση του Action στο Inbox και έπειτα συγκρίναμε και τις δύο απαντήσεις του Telegram με τις τιμές που επέστρεψε το Google Sheets. Τα προσωπικά αναγνωριστικά και τα διαπιστευτήρια έχουν αποκρυφτεί στις δημοσιευμένες εικόνες.
Το πρώτο ορόσημο είναι ένας αποθηκευμένος καφές. Το δεύτερο είναι ένα σύνολο που μπορείτε να ελέγξετε στο φύλλο. Θα μάθετε επίσης γιατί η απάντηση «αποθηκεύτηκε» στη συνομιλία αποτελεί μόνο τη μισή απόδειξη.
Κατεβάστε το πακέτο ρύθμισης του Pocket Ledger για το μορφοποιημένο αρχικό βιβλίο εργασίας, το avatar, το prompt, τις ρυθμίσεις των Actions και το φύλλο δοκιμών. Εισαγάγετε το βιβλίο εργασίας στο φύλλο που δημιούργησε το Quickchat AI και ακολουθήστε τα παρακάτω βήματα. Τα παραδείγματα προς αντιγραφή χρησιμοποιούν αγγλικά και τον Νοέμβριο του 2026 σε όλο τον οδηγό, ώστε να μπορείτε να συγκρίνετε τα αποτελέσματά σας με τα στιγμιότυπα.
Τι χρειάζεστε για να φτιάξετε ένα bot εξόδων στο Telegram;
Χρειάζεστε Telegram, λογαριασμό Google και λογαριασμό Quickchat AI. Η εγκατάσταση χρησιμοποιεί ρυθμίσεις στον πίνακα ελέγχου και έναν τύπο υπολογιστικού φύλλου. Δεν υπάρχει πρόγραμμα που πρέπει να φιλοξενήσετε.
- Δημιουργήστε λογαριασμό Quickchat AI, ολοκληρώστε την επαλήθευση και δημιουργήστε έναν Agent με όνομα
Pocket Ledger. - Έχετε έτοιμο έναν λογαριασμό Google για το νέο φύλλο. Ξεκινήστε με τις πλασματικές εγγραφές που ακολουθούν.
- Χρησιμοποιήστε ένα νέο bot στο Telegram για αυτή την άσκηση. Φροντίστε να έχετε διαθέσιμο έναν δεύτερο έμπιστο λογαριασμό Telegram για τον έλεγχο πρόσβασης στο τέλος.
Το πρόγραμμα Free του Quickchat AI προορίζεται για προσωπική, μη εμπορική εκμάθηση και περιλαμβάνει περιορισμένο όριο χρήσης. Οι συνομιλίες AI και το Simulation Testing καταναλώνουν πιστώσεις. Δείτε τα ισχύοντα προγράμματα και όρια χρήσης, πριν επιλέξετε πρόγραμμα για συνεχή χρήση.
Δύο κατευθύνσεις, δύο Actions. Η αποθήκευση μιας γραμμής δεν δίνει στον Agent τρόπο να διαβάζει προηγούμενα σύνολα.
Βήμα 1: Πώς συνδέετε το ιδιωτικό σας bot στο Telegram;
Το BotFather δημιουργεί την ταυτότητα του bot. Το Quickchat AI παρέχει τον Agent που απαντά στα μηνύματά του.
Ανοίξτε τον επίσημο @BotFather, στείλτε /newbot, ονομάστε το bot Pocket Ledger και επιλέξτε ένα διαθέσιμο όνομα χρήστη που τελειώνει σε bot. Χρησιμοποιήστε το /setuserpic για να ανεβάσετε το avatar από το πακέτο. Κρατήστε το token μυστικό· θα το επικολλήσετε απευθείας στο Quickchat AI.
Στο Quickchat AI, ανοίξτε External Apps → Telegram → Your own bot. Επιλέξτε Connect to Telegram, επικολλήστε το διαπιστευτήριο στο Bot Token και υποβάλετε το παράθυρο διαλόγου. Ενεργοποιήστε το Enable your own bot και επιλέξτε Save. Ο οδηγός του BotFather παρουσιάζει αναλυτικά τις οθόνες.
Το συνδεδεμένο bot έχει το ίδιο όνομα Pocket Ledger που θα βλέπετε στο Telegram.
Ανοίξτε τον σύνδεσμο του νέου bot στο Telegram, στείλτε /start και έπειτα στείλτε Hello στην ιδιωτική συνομιλία. Το /start στέλνει το μήνυμα καλωσορίσματος· το κανονικό μήνυμα δημιουργεί τη συνομιλία στο Inbox και τα μεταδεδομένα αποστολέα που χρειάζονται παρακάτω. Αφήστε ανενεργά τα Actions που χειρίζονται προσωπικά δεδομένα όσο τα ρυθμίζετε.
Ανοίξτε αυτή τη συνομιλία στο Quickchat AI μέσω Inbox → Details → Visitor. Βρείτε τα Telegram User Id και Telegram Chat Type (τα κλειδιά μεταδεδομένων είναι telegram_user_id και telegram_chat_type). Αντιγράψτε το αριθμητικό αναγνωριστικό χρήστη με το κουμπί που εμφανίζεται όταν περνάτε τον δείκτη από πάνω και επιβεβαιώστε ότι ο τύπος συνομιλίας είναι private.
Πάρτε το αναγνωριστικό αποστολέα σας από αυτό το πεδίο. Τα προσωπικά αναγνωριστικά είναι κρυμμένα στο στιγμιότυπο· χρησιμοποιήστε τη δική σας πραγματική τιμή.
Το αναγνωριστικό προέρχεται από τα μεταδεδομένα του αποστολέα στο Telegram. Το όνομα χρήστη σας, ένας αριθμός γραμμένος σε μήνυμα και το αναγνωριστικό του ίδιου του bot είναι διαφορετικά πράγματα. Στα επόμενα βήματα θα χρησιμοποιήσετε το αναγνωριστικό του αποστολέα για να περιορίσετε και τα δύο Actions.
Βήμα 2: Πώς προετοιμάζετε το φύλλο στο Google Sheets;
Η ενσωμάτωση Google Sheets δημιουργεί ένα υπολογιστικό φύλλο και ένα αρχικό Action. Χρησιμοποιήστε ξανά αυτό το αρχείο, ώστε το Action και η άδεια της Google να αφορούν τον ίδιο πόρο.
- Ανοίξτε Actions & MCPs → Add Action → Google Sheets και εξουσιοδοτήστε τον λογαριασμό σας Google. Ο οδηγός σύνδεσης Google Sheets εξηγεί τη συγκατάθεση και την αρχική ρύθμιση.
- Απενεργοποιήστε αμέσως το αρχικό Action. Δημιουργείται ενεργό. Κρατήστε το όνομά του,
log_lead_to_google_sheet, επειδή η επανασύνδεση χρησιμοποιεί αυτό το όνομα για να το εντοπίσει. Θα αλλάξουμε τον σκοπό του ώστε να αποθηκεύει έξοδα. - Ανοίξτε το υπολογιστικό φύλλο που δημιουργήθηκε και ονομάστε το
Pocket Ledger demo. Σε αυτό το νέο αρχείο επίδειξης, επιλέξτε File → Import → Upload, διαλέξτε τοpocket-ledger-starter.xlsxαπό το πακέτο και επιλέξτε Replace spreadsheet. Έπειτα πατήστε Import data. Έτσι προετοιμάζονται ταExpensesκαιSummaryμέσα στο αρχείο στο οποίο έχει πρόσβαση το Quickchat AI. Χρησιμοποιήστε αυτή την επιλογή μόνο στο νέο υπολογιστικό φύλλο επίδειξης. - Ελέγξτε τις τρεις αρχικές γραμμές παρακάτω. Στο
Summary, τα αρχικά σύνολα πρέπει να είναι 7,70 EUR και 6,00 USD. Το Βήμα 6 εξηγεί τον τύπο και συνδέει το Action ανάγνωσης.
Ξεκινήστε με τη σύνδεση του Google Sheets. Η εξουσιοδότηση δημιουργεί το υπολογιστικό φύλλο που χρησιμοποιούν και τα δύο Actions.
Προτιμάτε να δημιουργήσετε μόνοι σας τις καρτέλες; Μετονομάστε την αρχική καρτέλα σε Expenses. Για αυτά τα αγγλικά παραδείγματα, ορίστε File → Settings → Locale → United States. Μορφοποιήστε τις A:D και F:H ως Plain text και την E ως Number με δύο δεκαδικά ψηφία, έπειτα επικολλήστε το παρακάτω μπλοκ στο A1. Παγώστε τη γραμμή κεφαλίδων και αυξήστε το πλάτος των στηλών. Προσθέστε το Summary σύμφωνα με το Βήμα 6. Η Google τεκμηριώνει επίσης την εισαγωγή ενός βιβλίου εργασίας Excel σε υπάρχον φύλλο.
Αντιγράψτε τα τρία αρχικά έξοδα
date month item category amount currency note conversation_url
2026-11-01 2026-11 coffee food 4.50 EUR synthetic example
2026-11-02 2026-11 bus ticket transport 3.20 EUR synthetic example
2026-11-03 2026-11 notebook stationery 6.00 USD synthetic example
Τρία αρχικά έξοδα, έτοιμα για το τέταρτο. Τα ποσά είναι αριθμοί στην E· οι κωδικοί νομισμάτων είναι ξεχωριστές τιμές κειμένου στην F.
Η στήλη conversation_url θα συνδέει κάθε νέο έξοδο με τη συνομιλία του. Αφήστε την κενή για τα τρία παραδείγματα που εισάγονται χειροκίνητα. Η άδεια drive.file της Google καλύπτει αρχεία που δημιουργεί η εφαρμογή ή στα οποία έχει δοθεί ρητά πρόσβαση. Αυτή η ρύθμιση χρησιμοποιεί το φύλλο που δημιουργεί η ενσωμάτωση και δεν δίνει πρόσβαση σε ολόκληρο το Drive σας.
Βήμα 3: Πώς περιορίζετε τα έξοδα στη δική σας συνομιλία;
Ορίστε Run only when σε κάθε Action που διαβάζει ή γράφει στο σημειωματάριο. Οι δύο συνθήκες πρέπει να ισχύουν ταυτόχρονα, επομένως το αναγνωριστικό σας από μόνο του δεν αρκεί σε ομαδική συνομιλία.
| Κλειδί μεταδεδομένων | Σύγκριση | Τιμή |
|---|---|---|
telegram_user_id | ισούται με | Το πραγματικό αριθμητικό αναγνωριστικό αποστολέα σας από το βήμα 1 |
telegram_chat_type | ισούται με | private |
- Ανοίξτε το ανενεργό Action
log_lead_to_google_sheetκαι βρείτε το Run only when. - Προσθέστε και τις δύο παραπάνω συνθήκες. Χρησιμοποιήστε τα ακριβή κλειδιά μεταδεδομένων και τα ψηφία του αναγνωριστικού σας, χωρίς όνομα χρήστη ή πρόθεμα
@. - Αποθηκεύστε το Action, αφήνοντάς το ανενεργό. Εφαρμόστε τις ίδιες συνθήκες στο Action ανάγνωσης όταν το δημιουργήσετε στο βήμα 6.
Οι συνθήκες του Action αποθήκευσης στην τοπική επίδειξη. Αντικαταστήστε το πλασματικό αναγνωριστικό με το πραγματικό αναγνωριστικό αποστολέα σας και επαναλάβετε και τις δύο συνθήκες στο Action ανάγνωσης.
Και οι δύο συνθήκες πρέπει να υπάρχουν και στα δύο Actions. Ένας διαφορετικός αποστολέας ή μια ομαδική συνομιλία πρέπει να απορρίπτονται από τον έλεγχο πριν φτάσει αίτημα HTTP στο Google Sheets.
Πρόκειται για συνθήκες των Actions που επιβάλλονται από τον διακομιστή. Η οδηγία «απάντα μόνο σε εμένα» στο prompt δεν αποτελεί έλεγχο πρόσβασης. Περιορίστε επίσης τις ρυθμίσεις κοινής χρήσης του φύλλου και την πρόσβαση στον λογαριασμό σας Quickchat AI.
Βήμα 4: Πώς κάνετε το bot να αποθηκεύει ένα επιβεβαιωμένο έξοδο;
Προσαρμόστε το αρχικό Action ώστε να προσθέτει μία γραμμή με τη σειρά των στηλών του φύλλου σας. Ορίστε When to run → AI decides, ώστε να μπορεί να περιμένει επιβεβαίωση. Έπειτα δώστε στον Agent έναν κανόνα επιβεβαίωσης πριν ενεργοποιήσετε το Action.
Ρυθμίστε τα πεδία του εξόδου
Στο What to ask the user first, αντικαταστήστε τα πεδία υποψήφιων πελατών με αυτές τις παραμέτρους. Διατηρήστε τα ονόματα των παραμέτρων ακριβώς όπως εμφανίζονται.
| Παράμετρος | Τύπος δεδομένων | Υποχρεωτική | Περιγραφή προς εισαγωγή |
|---|---|---|---|
date | Κείμενο | Ναι | Ημερομηνία εξόδου σε μορφή YYYY-MM-DD, επιβεβαιωμένη από τον κάτοχο. Ζητήστε τη όταν λείπει. |
month | Κείμενο | Ναι | YYYY-MM από την επιβεβαιωμένη ημερομηνία. |
item | Κείμενο | Ναι | Σύντομο όνομα της αγοράς. |
category | Κείμενο | Ναι | Απλή κατηγορία που έχει συμφωνηθεί με τον κάτοχο, όπως φαγητό ή μεταφορές. |
amount | Δεκαδικός αριθμός | Ναι | Θετικό αριθμητικό ποσό, χωρίς σύμβολο νομίσματος. |
currency | Κείμενο | Ναι | Επιβεβαιωμένος κωδικός νομίσματος ISO, όπως EUR ή USD. Διευκρινίστε τα αμφίσημα σύμβολα. |
note | Κείμενο | Όχι | Προαιρετική σημείωση. Αφήστε κενό αν δεν έχει δοθεί. |
Κρατήστε το πραγματικό αναγνωριστικό του υπολογιστικού φύλλου από το υπάρχον API Endpoint. Αλλάξτε το εύρος σε Expenses!A:H, διατηρήστε τη μέθοδο POST και ορίστε τα Query Params σε valueInputOption=RAW και insertDataOption=INSERT_ROWS. Αφαιρέστε τις διπλές ρυθμίσεις παραμέτρων ερωτήματος αν υπάρχουν ήδη στο URL.
Αντιγράψτε το υπόδειγμα αιτήματος προσθήκης
POST https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Expenses!A:H:append
Query Params:
valueInputOption = RAW
insertDataOption = INSERT_ROWS
Headers:
Authorization = Bearer {{google_sheets_access_token}}
Content-Type = application/jsonΤο YOUR_CREATED_SHEET_ID είναι επεξηγηματικό σύμβολο κράτησης θέσης. Κρατήστε το πραγματικό αναγνωριστικό που υπάρχει ήδη στο αρχικό URL. Μην το αντικαταστήσετε με αυτό το σύμβολο. Επιλέξτε το υπάρχον System Token του Google Sheets στην τιμή Authorization και την ενσωματωμένη μεταβλητή URL συνομιλίας στο σώμα.
Στην καρτέλα Body, εισαγάγετε:
{"values":[["{{date}}","{{month}}","{{item}}","{{category}}","{{amount}}","{{currency}}","{{note}}","{{conversation_url}}"]]}
Τοπική ρύθμιση του Action εξόδων. Το σώμα ορίζει τη σειρά των κελιών και η μορφή της παραμέτρου ποσού ορίζει τον αριθμητικό της τύπο.
Κρατήστε τα εισαγωγικά γύρω από το {{amount}} στον επεξεργαστή. Επειδή αυτό το συγκεκριμένο σύμβολο κράτησης θέσης αναφέρεται σε παράμετρο Decimal Number, η αντικατάσταση παράγει έναν αριθμό JSON, όπως 4.5. Η αφαίρεση των εισαγωγικών καθιστά το JSON του επεξεργαστή μη έγκυρο. Στο τελικό φύλλο, ελέγξτε ότι η E περιέχει αριθμητική τιμή και συμπεριλαμβάνεται στον τύπο.
Το API προσθήκης της Google προσθέτει τη γραμμή. Το RAW διατηρεί κυριολεκτικά κείμενο όπως μια σημείωση που αρχίζει με =, αντί να το υπολογίζει ως τύπο. Η αριθμητική παράμετρος παρέχει τον τύπο του ποσού.
Αντιγράψτε την περιγραφή του Action αποθήκευσης
Save one personal expense to the configured Google Sheet. Call only after the owner explicitly confirms the proposed date, item, category, amount and currency. Ask for missing or ambiguous fields before saving. After confirmation, append one row once. Report success only after a successful API response. If the outcome is uncertain, tell the owner to inspect the Sheet before submitting again.Δώστε στο Pocket Ledger τις οδηγίες του
Ανοίξτε Identity → Main Prompt και επικολλήστε τα παρακάτω. Αναφέρονται και τα δύο Actions, ώστε το δεύτερο ορόσημο να λειτουργήσει μόλις προσθέσετε το Action ανάγνωσης της σύνοψης.
Το Main Prompt βρίσκεται στο Identity. Αυτό το τοπικό στιγμιότυπο δείχνει τη θέση του πεδίου. Χρησιμοποιήστε το πλήρες μπλοκ προς αντιγραφή που ακολουθεί.
Ο κανόνας επιβεβαίωσης σας δίνει μια χρήσιμη παύση. Μπορείτε να διορθώσετε τα «4,50 EUR» σε «5,00 EUR» πριν εγκρίνετε την αγορά· ο Agent θα πρέπει να ενημερώσει την πρόταση και να ζητήσει ξανά επιβεβαίωση.
Αντιγράψτε το Main Prompt του Pocket Ledger
You are Pocket Ledger, a personal expense notebook.
For an expense, collect its date, item, positive amount and ISO currency code. Suggest a simple category and include an optional note only when supplied. Ask for an explicit YYYY-MM-DD date if it is missing or relative; do not guess today's date or the owner's timezone. Clarify ambiguous currency symbols. Derive month as YYYY-MM from the confirmed date.
Show the proposed date, item, category, amount and currency. Wait for explicit confirmation. Apply corrections and ask for confirmation again. Only then call log_lead_to_google_sheet once for that expense. Do not claim it was saved unless the Action succeeds. If a request fails or its outcome is uncertain, explain that and ask the owner to inspect the Sheet before retrying.
For monthly totals, ask for an explicit month and currency when unclear, then call read_expense_summary. Quote the matching month, currency and total returned from the Sheet. Keep currencies separate. A missing summary row is unavailable, not zero. Never calculate totals from remembered conversation messages.
Personal-data Actions are restricted to the owner's private Telegram chat. If a condition blocks an Action, do not claim success or suggest changing identity values in chat. This notebook handles typed expenses, not bank accounts, voice transcription or PDF receipts.Αποθηκεύστε το prompt, ελέγξτε ξανά και τις δύο συνθήκες εκτέλεσης και ενεργοποιήστε το Action εξόδων. Το όνομα παραμένει log_lead_to_google_sheet, αλλά οι νέες παράμετροι, η περιγραφή και το σώμα του ορίζουν πλέον τη διαδικασία εξόδων.
Βήμα 5: Πώς αποθηκεύετε το πρώτο σας έξοδο;
Τώρα προσθέστε την πρώτη νέα εγγραφή στο σημειωματάριο. Κρατήστε ανοιχτά το Telegram, το Inbox και το φύλλο σας: θα παρακολουθήσετε τον ίδιο καφέ και στα τρία.
- Στην ιδιωτική σας συνομιλία στο Telegram, στείλτε
Coffee, 4.50 euros on 2026-11-04. - Ελέγξτε την πρόταση: ημερομηνία
2026-11-04, είδοςCoffee, κατηγορίαFood, ποσό4.50, νόμισμαEUR. Το Action προσδιορίζει τοmonthως2026-11όταν αποθηκεύει τη γραμμή. - Πριν επιβεβαιώσετε, ελέγξτε το
Expenses: οι τρεις αρχικές γραμμές πρέπει ακόμη να είναι οι μόνες εγγραφές.
Στείλτε το Save it μία φορά και ανοίξτε τη συνομιλία στο Inbox του Quickchat AI. Η απάντηση που επιβεβαιώνει την αποθήκευση έχει μια αναπτυσσόμενη ενότητα 1 action called. Ανοίξτε την για να δείτε τι έγινε πίσω από τη σύντομη απάντηση στο Telegram.
Η ίδια επιβεβαίωση στο Inbox, με το Action διαθέσιμο για έλεγχο.
Αναπτύξτε το Result → Show full. Ελέγξτε την ημερομηνία, τον μήνα που προκύπτει, το αριθμητικό ποσό, το νόμισμα και την κατάσταση HTTP. Σε αυτή τη ζωντανή εκτέλεση, η Google επέστρεψε HTTP 200, updatedRows: 1 και updatedRange: Expenses!A5:H5.
Το Action αποθήκευσης έστειλε το ποσό 4.5 ως αριθμό και έγραψε μία γραμμή. Τα προσωπικά αναγνωριστικά είναι κρυμμένα· το επιστρεφόμενο εύρος και το αποτέλεσμα παραμένουν ορατά.
Τέλος, ανοίξτε το Expenses. Η γραμμή 5 πρέπει να περιέχει τον ίδιο καφέ, με 2026-11 στη στήλη μήνα, 4.50 στο ποσό και EUR στο νόμισμα. Η τελευταία στήλη παραπέμπει στη συνομιλία του Inbox, ώστε να μπορείτε να εντοπίσετε το μήνυμα που δημιούργησε την εγγραφή.
Το τέταρτο έξοδο έφτασε μέσω Telegram. Ο ιδιωτικός σύνδεσμος του Inbox είναι κρυμμένος στη δημοσιευμένη εικόνα.
Σε αυτό το σημείο έχετε μια χρήσιμη καθημερινή συνήθεια: αποστολή, επιβεβαίωση, έλεγχος. Στη συνέχεια, δώστε στο bot μια αξιόπιστη πηγή να διαβάζει όταν ρωτάτε πού πήγαν τα χρήματα του μήνα.
Βήμα 6: Πώς ζητάτε ένα μηνιαίο σύνολο;
Αφήστε το Google Sheets να υπολογίσει το σύνολο και κατόπιν αφήστε το Action ανάγνωσης να το ανακτήσει. Όταν οι υπολογισμοί παραμένουν στο φύλλο, μπορείτε να ελέγξετε την απάντηση ακόμη και μετά το τέλος της συνομιλίας.
Προσθέστε μια καρτέλα Summary
Αν εισαγάγατε το αρχικό βιβλίο εργασίας, το Summary και οι τύποι του είναι ήδη έτοιμα. Οι αρχικές τιμές είναι 7,70 EUR και 6,00 USD· η αποθήκευση του καφέ αλλάζει μόνο τη γραμμή EUR. Αν δημιουργείτε το φύλλο χειροκίνητα, ακολουθήστε τα παρακάτω βήματα.
Το σημείο εκκίνησης: δύο νομίσματα, δύο ανεξάρτητα σύνολα.
- Δημιουργήστε μια καρτέλα με όνομα
Summary. Ορίστε τις στήλες A:B ως Plain text και εισαγάγετεmonth,currency,totalστα A1:C1. - Εισαγάγετε
2026-11καιEURστα A2:B2, και έπειτα2026-11καιUSDστα A3:B3. - Εισαγάγετε αυτόν τον τύπο στο C2 και αντιγράψτε τον προς τα κάτω στο C3. Μορφοποιήστε τη C ως αριθμό με δύο δεκαδικά ψηφία.
=SUMIFS(Expenses!$E$2:$E$501,Expenses!$B$2:$B$501,A2,Expenses!$F$2:$F$501,B2)Η συνάρτηση SUMIFS προσθέτει ποσά των οποίων ο μήνας και το νόμισμα αντιστοιχούν στη γραμμή σύνοψης. Αν οι τοπικές ρυθμίσεις του φύλλου απαιτούν τον χαρακτήρα ; ανάμεσα στα ορίσματα, αντικαταστήστε τα κόμματα του τύπου με αυτόν. Οι αριθμοί στα αιτήματα JSON εξακολουθούν να χρησιμοποιούν τελεία ως δεκαδικό διαχωριστικό.
Επιλέξτε το C2 για να δείτε τον τύπο πίσω από τα 12,20 EUR. Η γραμμή USD παραμένει 6,00.
Τα αρχικά 7,70 EUR μαζί με τον νέο καφέ των 4,50 EUR δίνουν 12,20 EUR. Το σημειωματάριο των 6,00 USD ανήκει στο δικό του σύνολο.
Ο αρχικός τύπος καλύπτει τις γραμμές 2 έως 501. Στην καταγεγραμμένη εκτέλεση, τα τρία εύρη του τελειώνουν στο 502 μετά την εισαγωγή της νέας γραμμής. Το Sheets μπορεί να προσαρμόζει τις αναφορές κατά την εισαγωγή· ελέγξτε ότι και τα τρία εύρη του Expenses έχουν τα ίδια όρια και επεκτείνετέ τα μαζί πριν βρεθούν εγγραφές έξω από το καλυπτόμενο εύρος. Προσθέστε μια γραμμή σύνοψης μήνα/νομίσματος για κάθε συνδυασμό που θέλετε να ρωτάτε.
Προσθέστε το Action ανάγνωσης
Ανοίξτε Actions & MCPs → Add Action → API Action. Χρησιμοποιήστε το Generate με το παρακάτω αίτημα. Τα Actions που δημιουργούνται με αυτόν τον τρόπο ξεκινούν ανενεργά. Ονομάστε το read_expense_summary και κρατήστε το When to run στο AI decides, ώστε το αποτέλεσμα να μπορεί να χρησιμοποιηθεί στην απάντηση. Χρησιμοποιήστε ξανά το ίδιο πραγματικό αναγνωριστικό υπολογιστικού φύλλου και το System Token του Google Sheets. Δεν χρειάζονται παράμετροι από τον χρήστη.
Αντιγράψτε το αίτημα για τη δημιουργία του Action
Create a read-only Google Sheets Action named read_expense_summary. Use GET for the Summary!A1:C25 range of the spreadsheet already created by this Agent's Google Sheets integration. Reuse its actual spreadsheet ID and google_sheets_access_token System Token. Set valueRenderOption=UNFORMATTED_VALUE, no body, and no visitor parameters. Preserve the response headers and values. Leave it inactive so I can review the configuration and add my owner-ID and private-chat Run only when conditions before enabling it.Συγκρίνετε τις ρυθμίσεις που δημιουργήθηκαν με το ακόλουθο υπόδειγμα. Αν επιλέξετε Create manually, προσθέστε και τις δύο συνθήκες πριν από την πρώτη έγκυρη αποθήκευση, η οποία μπορεί να ενεργοποιήσει ένα Action. Αφήστε το Response filter κενό και στα δύο Actions, ώστε να διατηρηθούν τα πεδία που χρησιμοποιούνται στους ελέγχους.
Αντιγράψτε το αίτημα ανάγνωσης της σύνοψης
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Summary!A1:C25
Query Params:
valueRenderOption = UNFORMATTED_VALUE
Headers:
Authorization = Bearer {{google_sheets_access_token}}
Body: noneΤο endpoint values.get επιστρέφει τα values του εύρους, μαζί με την κεφαλίδα και τα υπολογισμένα ποσά. Το UNFORMATTED_VALUE επιστρέφει αριθμητικά αποτελέσματα αντί για συμβολοσειρές μορφοποιημένες ως νόμισμα. Αφήστε την απόκριση διαθέσιμη στον Agent, ώστε να μπορεί να διαβάζει αυτές τις τιμές.
Αντιγράψτε την περιγραφή του Action ανάγνωσης
Read monthly expense totals from the configured Summary range. Use this when the owner asks for a total. Quote only the returned row matching the requested YYYY-MM and currency. If either is unclear, ask. If the row is absent or the request fails, say the total is unavailable. Never infer a total from conversation history, combine currencies, or accept a different spreadsheet ID or range from the visitor.Εφαρμόστε τις ίδιες δύο συνθήκες Run only when από το Βήμα 3, αποθηκεύστε και ενεργοποιήστε το Action. Το εύρος ανάγνωσης περιλαμβάνει 24 γραμμές σύνοψης· επεκτείνετέ το συνειδητά όταν προσθέτετε περισσότερες.
Το δεύτερο Action χρειάζεται δικές του συνθήκες. Πρόκειται για τοπικό στιγμιότυπο ρυθμίσεων, όχι για πραγματικό έλεγχο εξουσιοδότησης αποστολέα.
Ρωτήστε What is my November 2026 total in EUR? και μετά ρωτήστε για USD. Στη δική μας συνομιλία στο Telegram, το Pocket Ledger επέστρεψε 12.2 EUR και 6 USD, που αντιστοιχούν στις μορφοποιημένες τιμές 12.20 και 6.00 του φύλλου. Διάβασε την αποθηκευμένη σύνοψη για κάθε απάντηση.
Ανοίξτε την απάντηση για το μηνιαίο σύνολο στο Inbox και αναπτύξτε το Action της. Συγκρίνετε την επιστρεφόμενη γραμμή με το Summary!C2. Η παρακάτω ζωντανή απάντηση περιλαμβάνει 2026-11, EUR, 12.2 και μια ξεχωριστή γραμμή USD, 6, με HTTP 200.
Η απάντηση, οι επιστρεφόμενες τιμές και το φύλλο συμφωνούν πλέον. Αυτός είναι ο τελικός στόχος που είδατε στην αρχή.
Πώς ελέγχετε για λάθη πριν χρησιμοποιήσετε πραγματικά έξοδα;
Ελέγξτε τα ελλιπή αιτήματα και τους αποκλεισμένους αποστολείς με την ίδια προσοχή που δίνετε στο επιτυχημένο παράδειγμα του καφέ. Κρατήστε τα δεδομένα επίδειξης μέχρι να περάσουν οι παρακάτω έλεγχοι.
| Δοκιμάστε αυτό | Τι να επαληθεύσετε |
|---|---|
Lunch, $12 yesterday | Ο Agent ζητά το νόμισμα και την ακριβή ημερομηνία. Δεν εμφανίζεται νέα γραμμή. |
| Διορθώστε ένα προτεινόμενο ποσό πριν από την επιβεβαίωση | Η διορθωμένη πρόταση επιβεβαιώνεται πριν προστεθεί ακριβώς μία γραμμή. |
| Ζητήστε το σύνολο Νοεμβρίου σε EUR και μετά σε USD | Ξεχωριστά αποτελέσματα: 12,20 EUR και 6,00 USD για τα δεδομένα του παραδείγματος. |
| Ρωτήστε για τον Δεκέμβριο του 2026 χωρίς να υπάρχει γραμμή Δεκεμβρίου στη σύνοψη | Ο Agent λέει ότι το σύνολο δεν είναι διαθέσιμο, αντί να επινοεί μηδενικό ποσό. |
| Ένας δεύτερος αποστολέας ζητά σύνολο και προσπαθεί να αποθηκεύσει έξοδο | Και τα δύο Actions απορρίπτονται και δεν αποκαλύπτονται προσωπικές τιμές. |
| Ο κάτοχος κάνει τα ίδια αιτήματα σε ομάδα | Και τα δύο Actions απορρίπτονται επειδή η συνομιλία δεν είναι ιδιωτική. |
| Μια αποθήκευση αποτυγχάνει ή λήγει το χρονικό όριο | Η απάντηση αναφέρει αποτυχία ή αβεβαιότητα. Ελέγξτε το φύλλο πριν προσπαθήσετε ξανά. |
Για επαναλήψιμους γλωσσικούς ελέγχους, ανοίξτε Testing → Create Dataset → Paste messages και χρησιμοποιήστε τα μηνύματα και τα κριτήρια αξιολόγησης του πακέτου. Εκτελέστε ξεχωριστά μια πλήρη συνομιλία για την ακολουθία επιβεβαίωσης. Τα μεταδεδομένα του Preview ή του Simulation είναι δεδομένα δοκιμής. Δεν αποδεικνύουν ότι ένας πραγματικός δεύτερος αποστολέας στο Telegram αποκλείεται.
Το τοπικό σύνολο δεδομένων είναι έτοιμο για δοκιμή. Η παρουσία του δεν αποτελεί ολοκληρωμένη εκτέλεση Simulation ούτε απόδειξη εγγραφής στο Google Sheets.
Αν μια συμπεριφορά αποτύχει, αλλάξτε μία σχετική οδηγία, επαναλάβετε την ίδια είσοδο και ελέγξτε ξανά την κλήση και το φύλλο. Για παράδειγμα, μια πρόωρη προσθήκη απαιτεί προσεκτικότερη εξέταση της διατύπωσης επιβεβαίωσης στο Action αποθήκευσης. Η επιβεβαίωση είναι οδηγία, όχι εγγύηση μοναδικότητας στη βάση δεδομένων. Μετά από λήξη χρονικού ορίου, ο έλεγχος του φύλλου έχει μεγαλύτερη σημασία από μια νέα αποστολή.
Μόλις λειτουργήσει όλη η διαδρομή, αφαιρέστε τις πλασματικές γραμμές εξόδων, κρατήστε τις κεφαλίδες και τους τύπους και προσθέστε γραμμές σύνοψης για τους μήνες και τα νομίσματα που χρησιμοποιείτε πραγματικά. Η πρώτη πραγματική σας αγορά μπορεί να ακολουθήσει την ίδια σύντομη διαδικασία με τον καφέ.
Μπορεί ένας AI assistant να βοηθήσει στη ρύθμιση του Pocket Ledger;
Ένας συνδεδεμένος βοηθός διαχείρισης λογαριασμού μπορεί να βοηθήσει στην προετοιμασία του Agent και στον έλεγχο των ρυθμίσεων των Actions. Ακολουθήστε το Manage with AI χρησιμοποιώντας την καταχώριση του Quickchat AI στο ChatGPT ή στο Claude. Δώστε του το πακέτο ρυθμίσεων και αυτό το αίτημα:
Help me configure Pocket Ledger from this setup kit. Inspect the available Quickchat AI tools first. Prepare the Main Prompt and the two HTTP Actions using the exact field names, numeric amount type and fixed ranges. Keep log_lead_to_google_sheet as the starter name. Ask me to complete Google OAuth and Telegram Bot Token setup in the dashboard. Apply both owner/private run conditions before enabling either Action. Do not run credit-consuming tests or append expenses until I ask. Report any setting your tools cannot configure so I can complete it in the dashboard.Ο κάτοχος ολοκληρώνει τη συγκατάθεση Google και τη σύνδεση Telegram. Ελέγξτε τις ρυθμίσεις και εκτελέστε τους ίδιους παραπάνω ελέγχους, ανεξάρτητα από το ποιος τις εισήγαγε.
Συχνές ερωτήσεις
Πώς παρακολουθώ έξοδα στο Telegram με Google Sheets;
Συνδέστε ένα bot Telegram με έναν Agent του Quickchat AI και εξουσιοδοτήστε το Google Sheets. Ρυθμίστε ένα Action να προσθέτει έξοδο μετά από επιβεβαίωση και ένα άλλο να διαβάζει μια μηνιαία σύνοψη που βασίζεται σε τύπο. Περιορίστε και τα δύο Actions στο δικό σας αναγνωριστικό χρήστη Telegram και σε ιδιωτική συνομιλία.
Μπορεί το bot να μου πει πόσα ξόδεψα αυτόν τον μήνα;
Ναι, όταν ο μήνας και το νόμισμα που ζητάτε έχουν γραμμή στο ρυθμισμένο εύρος Summary. Το Google Sheets υπολογίζει το σύνολο με τη SUMIFS και το Action ανάγνωσης το ανακτά. Ένα Action που μόνο προσθέτει γραμμές δεν μπορεί να ανακτήσει σύνολα, και μια γραμμή σύνοψης που λείπει δεν σημαίνει μηδέν.
Μπορεί κάποιος άλλος να διαβάσει τα έξοδά μου μέσω του bot Telegram;
Και τα δύο Actions προσωπικών δεδομένων πρέπει να απαιτούν το επαληθευμένο telegram_user_id σας και telegram_chat_type ίσο με private. Αυτές οι συνθήκες αποκλείουν κλήσεις από άλλους αποστολείς και ομάδες. Ελέγξτε και τις δύο περιπτώσεις πριν προσθέσετε προσωπικά δεδομένα και περιορίστε επίσης την πρόσβαση στο φύλλο και στον λογαριασμό Quickchat AI.
Είναι δωρεάν αυτό το bot εξόδων στο Telegram;
Η δημιουργία bot στο Telegram είναι δωρεάν. Το πρόγραμμα Free του Quickchat AI υποστηρίζει προσωπική, μη εμπορική εκμάθηση με περιορισμένες πιστώσεις AI. Οι απαντήσεις AI και το Simulation Testing χρησιμοποιούν πιστώσεις. Η συνεχής χρήση εξαρτάται από τις διαθέσιμες πιστώσεις και το πρόγραμμά σας.
Χρειάζομαι Apps Script, Python ή διακομιστή αυτοματισμού;
Αυτή η ρύθμιση χρησιμοποιεί Actions του Quickchat AI και έναν τύπο Google Sheets. Επικολλάτε τις παρεχόμενες ρυθμίσεις αιτήματος, το σώμα JSON και το prompt στον πίνακα ελέγχου. Δεν αναπτύσσετε Apps Script, bot Python ή διακομιστή αυτοματισμού.
Μπορώ να χρησιμοποιήσω το υπάρχον υπολογιστικό φύλλο εξόδων μου;
Αυτή η ρύθμιση χρησιμοποιεί το υπολογιστικό φύλλο που δημιουργεί η ενσωμάτωση Google Sheets του Quickchat AI. Η εξουσιοδότηση drive.file δεν της δίνει απεριόριστη πρόσβαση στο Drive σας. Μην αντικαταστήσετε το αναγνωριστικό του φύλλου με οποιοδήποτε υπάρχον αρχείο θεωρώντας ότι είναι προσβάσιμο.
Μπορεί το bot να διαβάσει φωτογραφίες αποδείξεων ή φωνητικά μηνύματα;
Αυτός ο οδηγός καλύπτει έξοδα που πληκτρολογείτε. Η εξαγωγή στοιχείων από αποδείξεις χρειάζεται ξεχωριστό έλεγχο παράδοσης εικόνων μέσω Telegram και επιβεβαίωσης πριν βασιστείτε σε αυτή. Η απομαγνητοφώνηση φωνής και η ανάλυση αποδείξεων PDF δεν αποτελούν μέρος αυτής της ρύθμισης.
Πώς αντιμετωπίζει τα διαφορετικά νομίσματα και τις διπλές εγγραφές;
Κάθε νόμισμα έχει ξεχωριστό μηνιαίο σύνολο. Η ρύθμιση δεν μετατρέπει νομίσματα. Η επιβεβαίωση μειώνει τις ακούσιες εγγραφές, αλλά δεν παρέχει ατομική αποτροπή διπλοτύπων. Αν λήξει το χρονικό όριο μιας αποθήκευσης, ελέγξτε το φύλλο πριν τη στείλετε ξανά.