Vytvorte si evidenciu výdavkov v Telegrame s Google Sheets

Káva, lístok na autobus, zápisník. Na drobné nákupy ľahko zabudnete, kým otvoríte tabuľku. Čo keby na zaznamenanie nákupu stačila jedna správa v Telegrame a na kontrolu mesiaca ďalšia?

V tomto návode vytvoríme Pocket Ledger, evidenciu výdavkov v Telegrame s Google Sheets. Pošlite nákup, potvrďte navrhnuté údaje a opýtajte sa na mesačný súčet. Tabuľka uchováva riadky a počíta; bot vedie rozhovor. Takto vyzerá hotový výsledok.

Prvým míľnikom je jedna uložená káva. Druhým je súčet, ktorý môžete overiť v tabuľke. Zistíte aj to, prečo slovo „uložené“ v odpovedi predstavuje iba polovicu dôkazu.

Stiahnite si balík na nastavenie Pocket Ledger s naformátovaným úvodným zošitom, avatarom, promptom, nastaveniami Actions a testovacím hárkom. Zošit importujte do tabuľky vytvorenej cez Quickchat AI a potom postupujte podľa krokov nižšie. Kopírovateľné príklady používajú angličtinu a november 2026, aby ste mohli svoje výsledky porovnať so snímkami.

Čo potrebujete na vytvorenie evidencie výdavkov v Telegrame?

Potrebujete Telegram, účet Google a účet Quickchat AI. Nastavenie využíva ovládací panel a vzorec v tabuľke; nemusíte prevádzkovať vlastný program.

1. Vytvorte si účet Quickchat AI, dokončite overenie a vytvorte Agent s názvom Pocket Ledger.
2. Pripravte si účet Google pre novú tabuľku. Začnite fiktívnymi záznamami uvedenými nižšie.
3. Na toto cvičenie použite nového telegramového bota. Na záverečný test prístupu si pripravte druhý dôveryhodný účet Telegram.

Program Free služby Quickchat AI je určený na osobné nekomerčné vzdelávanie a obsahuje obmedzený prídel. AI rozhovory aj Simulation Testing spotrebúvajú kredity. Pred výberom programu na pravidelné používanie si pozrite aktuálne programy a limity.

Dva smery, dve Actions. Uloženie riadka nedáva Agentovi spôsob, ako čítať predchádzajúce súčty.

Krok 1: Ako pripojíte súkromného telegramového bota?

BotFather vytvorí identitu bota. Quickchat AI poskytne Agent, ktorý odpovedá na jeho správy.

Otvorte oficiálny @BotFather, pošlite /newbot, pomenujte bota Pocket Ledger a vyberte dostupné používateľské meno končiace na bot. Pomocou /setuserpic nahrajte avatar z balíka. Token uchovajte v súkromí; vložíte ho priamo do Quickchat AI.

V Quickchat AI otvorte External Apps → Telegram a nájdite Your own bot. Kliknite na Connect to Telegram a vložte prihlasovací údaj do poľa Bot Token v dialógovom okne a potvrďte dialóg. Zapnite Enable your own bot a kliknite na Save. Návod pre BotFather podrobne opisuje jednotlivé obrazovky.

Otvorte odkaz nového bota v Telegrame, pošlite /start a potom Hello v súkromnom chate. /start odošle uvítaciu správu; bežná správa vytvorí konverzáciu v Inboxe a metadáta odosielateľa potrebné nižšie. Actions pracujúce s osobnými údajmi nechajte počas nastavovania neaktívne.

Tento rozhovor otvorte v Quickchat AI cez Inbox → Details → Visitor. Nájdite Telegram User Id a Telegram Chat Type (kľúče metadát sú telegram_user_id a telegram_chat_type). Pomocou ovládacieho prvku zobrazeného po prejdení myšou skopírujte číselné ID používateľa a overte, že typ chatu je private.

ID pochádza z metadát odosielateľa, ktoré poskytuje Telegram. Vaše používateľské meno, číslo napísané do správy a ID samotného bota sú odlišné veci. ID odosielateľa použijete v ďalších krokoch na obmedzenie oboch Actions.

Krok 2: Ako pripravíte tabuľku Google Sheets?

Integrácia Google Sheets vytvorí tabuľku a úvodnú Action. Použite túto istú tabuľku, aby Action aj povolenie Google odkazovali na rovnaký zdroj.

1. Otvorte Actions & MCPs → Add Action → Google Sheets a autorizujte účet Google. Návod na pripojenie Google Sheets vysvetľuje súhlas a úvodnú konfiguráciu.
2. Úvodnú Action okamžite vypnite. Vytvára sa ako aktívna. Ponechajte jej názov log_lead_to_google_sheet, pretože opätovné pripojenie ju vyhľadáva podľa tohto názvu. Jej účel zmeníme na ukladanie výdavkov.
3. Otvorte vytvorenú tabuľku a pomenujte ju Pocket Ledger demo. V tomto novom ukážkovom súbore vyberte File → Import → Upload, z balíka vyberte pocket-ledger-starter.xlsx a zvoľte Replace spreadsheet a potom kliknite na Import data. Tým pripravíte Expenses aj Summary v súbore, ku ktorému má Quickchat AI prístup. Túto možnosť použite iba v novej ukážkovej tabuľke.
4. Skontrolujte tri úvodné riadky nižšie. V Summary majú byť počiatočné súčty EUR 7.70 a USD 6.00. Krok 6 vysvetľuje vzorec a pripája čítaciu Action.

Začnite pripojením Google Sheets. Jeho autorizácia vytvorí tabuľku, ktorú používajú obe Actions.

Chcete si hárky vytvoriť sami? Úvodný hárok premenujte na Expenses. Pre tieto anglické príklady nastavte File → Settings → Locale → United States. A:D a F:H naformátujte ako Plain text a E ako Number s dvoma desatinnými miestami. Potom do A1 vložte blok uvedený nižšie. Ukotvite hlavičku a rozšírte stĺpce. Podľa kroku 6 pridajte Summary. Google opisuje aj import zošita Excel do existujúcej tabuľky.

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

Stĺpec conversation_url prepojí každý nový výdavok s jeho rozhovorom. Pri troch ručne zadaných príkladoch ho nechajte prázdny. Povolenie Google drive.file sa vzťahuje na súbory vytvorené aplikáciou alebo výslovne sprístupnené súbory; tento postup používa tabuľku vytvorenú integráciou a neposkytuje prístup k celému Drive.

Krok 3: Ako obmedzíte výdavky na svoj vlastný chat?

Nastavte Run only when na každej Action, ktorá číta alebo zapisuje evidenciu. Musia platiť obe podmienky, takže samotné vaše ID v skupinovom chate nestačí.

1. Otvorte neaktívnu Action log_lead_to_google_sheet a nájdite Run only when.
2. Pridajte obe uvedené podmienky. Použite presné kľúče metadát a číslice svojho ID bez používateľského mena či predpony @.
3. Action uložte a ponechajte ju neaktívnu. Rovnaké podmienky nastavte na čítacej Action, keď ju vytvoríte v kroku 6.

Podmienky ukladacej Action v lokálnej ukážke. Fiktívne ID nahraďte svojím skutočným ID odosielateľa a obe podmienky zopakujte na čítacej Action.

Obe podmienky patria na obe Actions. Iný odosielateľ alebo skupinový chat musí byť odmietnutý skôr, ako HTTP požiadavka dorazí do Google Sheets.

Ide o podmienky Actions vynucované serverom. Pokyn „odpovedaj iba mne“ v prompte nie je kontrolou prístupu. Obmedzte aj zdieľanie tabuľky a prístup k účtu Quickchat AI.

Krok 4: Ako dosiahnete, aby bot uložil potvrdený výdavok?

Úvodnú Action upravte tak, aby pridávala jeden riadok v poradí stĺpcov tabuľky. Nastavte When to run → AI decides, aby mohla čakať na potvrdenie. Pred jej zapnutím dajte Agentovi pravidlo potvrdenia.

Nastavte polia výdavku

V časti What to ask the user first nahraďte polia potenciálneho zákazníka týmito parametrami. Názvy parametrov zachovajte presne podľa ukážky.

Ponechajte skutočné ID tabuľky z existujúceho API Endpoint. Zmeňte rozsah na Expenses!A:H, ponechajte metódu POST a nastavte Query Params na valueInputOption=RAW a insertDataOption=INSERT_ROWS. Duplicitné parametre odstráňte, ak sú už súčasťou 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 je vysvetľujúca zástupná hodnota. Ponechajte skutočné ID, ktoré už je v úvodnej URL; neprepisujte ho touto hodnotou. V hodnote Authorization vyberte existujúci Google Sheets System Token a v tele požiadavky vstavanú premennú URL rozhovoru.

Na karte Body zadajte:

{"values":[["{{date}}","{{month}}","{{item}}","{{category}}","{{amount}}","{{currency}}","{{note}}","{{conversation_url}}"]]}

Lokálna konfigurácia výdavkovej Action. Telo definuje poradie buniek; formát parametra sumy definuje jej číselný typ.

Úvodzovky okolo {{amount}} v editore ponechajte. Keďže presne táto zástupná hodnota odkazuje na parameter Decimal Number, nahradenie vytvorí JSON číslo, napríklad 4.5. Odstránením úvodzoviek vznikne neplatný JSON. Vo výslednej tabuľke overte, že stĺpec E je číselný a započítava sa do vzorca.

Append API od Google pridá riadok. RAW zachová text, napríklad poznámku začínajúcu na =, doslovne namiesto vyhodnotenia ako vzorca. Číselný parameter určuje typ sumy.

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.

Dajte Pocket Ledger pokyny

Otvorte Identity → Main Prompt a vložte nasledujúci text. Obsahuje názvy oboch Actions, takže druhý míľnik bude fungovať po pridaní čítačky súhrnu.

Main Prompt sa nachádza v Identity. Táto lokálna snímka ukazuje umiestnenie poľa; použite úplný blok na kopírovanie nižšie.

Pravidlo potvrdenia vám dáva užitočnú prestávku. Pred schválením nákupu môžete opraviť „EUR 4.50“ na „EUR 5.00“; Agent má aktualizovať návrh a znova sa opýtať.

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.

Uložte prompt, znovu skontrolujte obe podmienky spustenia a zapnite výdavkovú Action. Názov zostáva log_lead_to_google_sheet; nové parametre, opis a telo teraz definujú postup evidencie výdavkov.

Krok 5: Ako uložíte svoj prvý výdavok?

Teraz pridajte do zápisníka prvý nový záznam. Nechajte otvorený Telegram, Inbox aj tabuľku: budete sledovať tú istú kávu vo všetkých troch.

1. V súkromnom telegramovom chate pošlite Coffee, 4.50 euros on 2026-11-04.
2. Skontrolujte návrh: dátum 2026-11-04, položka Coffee, kategória Food, suma 4.50, mena EUR. Action pri ukladaní riadka odvodí month ako 2026-11.
3. Pred potvrdením skontrolujte Expenses: tri úvodné riadky majú byť stále jedinými záznamami.

Pošlite Save it raz a potom otvorte rozhovor v Quickchat AI Inbox. Odpoveď potvrdzujúca uloženie obsahuje rozbaľovaciu časť 1 action called. Otvorte ju a pozrite sa, čo sa odohralo za krátkou odpoveďou v Telegrame.

Rozbaľte Result → Show full. Skontrolujte dátum, odvodený mesiac, číselnú sumu, menu a stav HTTP. V tomto skutočnom behu Google vrátil HTTP 200, updatedRows: 1 a updatedRange: Expenses!A5:H5.

Nakoniec otvorte Expenses. Riadok 5 má obsahovať tú istú kávu, s 2026-11 v stĺpci mesiaca, 4.50 v sume a EUR v mene. Posledný stĺpec odkazuje na rozhovor v Inboxe, takže môžete dohľadať správu, ktorá záznam vytvorila.

Teraz máte užitočný každodenný návyk: odoslať, potvrdiť, skontrolovať. Ďalej dajte botovi spoľahlivý zdroj, z ktorého môže čítať, keď sa opýtate, kam išli peniaze za daný mesiac.

Krok 6: Ako sa opýtate na mesačný súčet?

Nechajte Google Sheets vypočítať súčet a potom ho načítajte čítacou Action. Keď výpočet zostáva v tabuľke, odpoveď sa dá overiť aj po skončení rozhovoru.

Pridajte hárok Summary

Ak ste importovali úvodný zošit, Summary aj jeho vzorce sú už pripravené. Počiatočné hodnoty sú EUR 7.70 a USD 6.00; uloženie kávy zmení iba riadok EUR. Ak tabuľku vytvárate ručne, postupujte podľa krokov nižšie.

1. Vytvorte hárok s názvom Summary. Stĺpce A:B nastavte na Plain text a do A1:C1 zadajte month, currency, total.
2. Do A2:B2 zadajte 2026-11 a EUR, potom do A3:B3 2026-11 a USD.
3. Do C2 vložte tento vzorec a vyplňte ho nadol do C3. Stĺpec C naformátujte ako číslo s dvoma desatinnými miestami.

=SUMIFS(Expenses!$E$2:$E$501,Expenses!$B$2:$B$501,A2,Expenses!$F$2:$F$501,B2)

Funkcia SUMIFS sčíta sumy, ktorých mesiac aj mena zodpovedajú riadku súhrnu. Ak miestne nastavenie tabuľky vyžaduje medzi argumentmi bodkočiarky, nahraďte nimi čiarky vo vzorci. Čísla v JSON požiadavkách naďalej používajú desatinnú bodku.

Úvodných 7,70 EUR plus nová káva za 4,50 EUR dáva 12,20 EUR. Zápisník za 6,00 USD patrí do samostatného súčtu.

Úvodný vzorec pokrýva riadky 2 až 501. V zachytenom behu sa jeho tri rozsahy po vložení nového riadka končia na 502. Sheets môže pri vkladaní upraviť odkazy; skontrolujte, že všetky tri rozsahy Expenses zostávajú zosúladené, a rozšírte ich spolu skôr, než záznamy prekročia pokrytý rozsah. Pre každú kombináciu mesiaca a meny, na ktorú sa chcete pýtať, pridajte riadok súhrnu.

Pridajte čítaciu Action

Otvorte Actions & MCPs → Add Action → API Action. Použite Generate s požiadavkou nižšie; vygenerované Actions začínajú neaktívne. Pomenujte ju read_expense_summary a ponechajte When to run na AI decides, aby výsledok mohol ovplyvniť odpoveď. Znova použite rovnaké skutočné ID tabuľky a Google Sheets System Token. Nie sú potrebné žiadne parametre zadávané používateľom.

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.

Porovnajte vygenerované nastavenia s nasledujúcou referenciou. Ak zvolíte Create manually, pridajte obe podmienky pred prvým platným uložením, ktoré môže Action aktivovať. Response filter nechajte prázdny na oboch Actions, aby zostali zachované polia používané pri kontrolách.

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

Koncový bod values.get vracia values daného rozsahu vrátane hlavičky a vypočítaných súm. UNFORMATTED_VALUE vracia číselné výsledky namiesto reťazcov naformátovaných ako mena. Odpoveď nechajte Agentovi dostupnú, aby mohol hodnoty prečítať.

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.

Použite rovnaké dve podmienky Run only when z kroku 3, uložte a aktivujte Action. Rozsah čítania zahŕňa 24 riadkov súhrnu; pri pridávaní ďalších ho cielene rozšírte.

Druhá Action potrebuje vlastné podmienky. Ide o lokálnu snímku nastavení, nie o skutočný test autorizácie odosielateľa.

Opýtajte sa What is my November 2026 total in EUR? a potom sa opýtajte na USD. V našom rozhovore v Telegrame Pocket Ledger vrátil 12.2 EUR a 6 USD, čo zodpovedá formátovaným hodnotám 12.20 a 6.00 v tabuľke. Pre každú odpoveď načítal uložený súhrn.

Otvorte odpoveď s mesačným súčtom v Inboxe a rozbaľte jej Action. Vrátený riadok porovnajte s Summary!C2. Skutočná odpoveď nižšie obsahuje 2026-11, EUR, 12.2 a samostatný riadok USD, 6, so stavom HTTP 200.

Ako overíte chyby pred použitím skutočných výdavkov?

Neúplné požiadavky a blokovaných odosielateľov testujte rovnako dôsledne ako úspešne uloženú kávu. Vzorové údaje ponechajte, kým neprejdú nasledujúce kontroly.

Pre opakovateľné jazykové testy otvorte Testing → Create Dataset → Paste messages a použite správy a hodnotiace kritériá z balíka. Postup potvrdenia otestujte samostatne v úplnom rozhovore. Metadáta v Preview alebo Simulation sú testovacie údaje; nedokazujú, že skutočný druhý odosielateľ z Telegramu bude zablokovaný.

Lokálny dataset je pripravený na testovanie. Jeho existencia neznamená dokončený beh Simulation ani dôkaz zápisu do Google Sheets.

Ak správanie zlyhá, zmeňte jeden relevantný pokyn, zopakujte rovnaký vstup a znova skontrolujte volanie aj tabuľku. Predčasné pridanie riadka napríklad vyžaduje podrobnejšiu kontrolu formulácie potvrdenia v ukladacej Action. Potvrdenie je pokyn, nie databázová záruka jedinečnosti. Po vypršaní časového limitu je dôležitejšie skontrolovať tabuľku než znova stlačiť odoslanie.

Keď postup funguje, odstráňte fiktívne riadky výdavkov, ponechajte hlavičky a vzorce a pridajte súhrnné riadky pre mesiace a meny, ktoré skutočne používate. Prvý skutočný nákup môže nasledovať rovnaký jednoduchý postup ako káva.

Môže s nastavením Pocket Ledger pomôcť AI asistent?

Pripojený asistent na správu účtu môže pomôcť pripraviť Agent a skontrolovať nastavenia Actions. Postupujte podľa Manage with AI cez položku Quickchat AI v ChatGPT alebo položku v Claude. Dajte mu balík na nastavenie a túto požiadavku:

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.

Vlastník dokončí udelenie súhlasu Google a pripojenie Telegramu. Nastavenia skontrolujte a vykonajte rovnaké uvedené kontroly bez ohľadu na to, kto ich zadával.

Často kladené otázky

Ako sledovať výdavky v Telegrame pomocou Google Sheets?

Pripojte telegramového bota ku Quickchat AI Agent a autorizujte Google Sheets. Nastavte jednu Action na pridanie výdavku po potvrdení a druhú na čítanie mesačného súhrnu vypočítaného vzorcami. Obe Actions obmedzte na svoje telegramové používateľské ID a súkromný chat.

Dokáže mi bot povedať, koľko som minul tento mesiac?

Áno, ak má požadovaný mesiac a mena riadok v nastavenom rozsahu Summary. Google Sheets vypočíta súčet pomocou SUMIFS a čítacia Action ho načíta. Action, ktorá iba pridáva riadky, nedokáže načítať súčty a chýbajúci súhrnný riadok nie je nula.

Môže niekto iný čítať moje výdavky cez telegramového bota?

Obe Actions pre osobné údaje musia vyžadovať vaše overené telegram_user_id a telegram_chat_type rovné private. Tieto podmienky blokujú volania iných odosielateľov a skupín. Pred pridaním osobných údajov otestujte oba prípady a obmedzte aj prístup k tabuľke a účtu Quickchat AI.

Je táto evidencia výdavkov v Telegrame bezplatná?

Vytvorenie telegramového bota je bezplatné. Program Free služby Quickchat AI podporuje osobné nekomerčné vzdelávanie s obmedzeným prídelom AI kreditov. AI odpovede a Simulation Testing využívajú kredity; ďalšie používanie závisí od dostupného prídelu a programu.

Potrebujem Apps Script, Python alebo automatizačný server?

Tento postup používa Quickchat AI Actions a vzorec Google Sheets. Dodané nastavenia požiadaviek, JSON telo a prompt vložíte do ovládacieho panela; nenasadzujete Apps Script, Python bota ani automatizačný server.

Môžem použiť svoju existujúcu tabuľku výdavkov?

Tento postup používa tabuľku vytvorenú integráciou Google Sheets v Quickchat AI. Autorizácia drive.file jej nedáva neobmedzený prístup k Drive. Nenahrádzajte ID tabuľky ľubovoľným existujúcim súborom s predpokladom, že bude dostupný.

Dokáže bot čítať fotografie bločkov alebo hlasové správy?

Tento návod sa venuje písaným výdavkom. Extrakcia údajov z bločkov potrebuje vlastný test doručenia obrázka a potvrdenia v Telegrame, skôr než sa na ňu spoľahnete. Prepis hlasu a spracovanie PDF bločkov nie sú súčasťou tohto nastavenia.

Ako rieši rôzne meny a duplicitné záznamy?

Každá mena má samostatný mesačný súčet; postup meny neprepočítava. Potvrdenie znižuje počet náhodných záznamov, neposkytuje však atómovú ochranu pred duplicitami. Ak pri ukladaní vyprší časový limit, pred opätovným odoslaním skontrolujte tabuľku.