Vytvořte si evidenci výdajů v Telegramu s Google Sheets

Káva, jízdenka, zápisník. Než otevřete tabulku, drobné nákupy snadno zapomenete. Co kdyby k jejich zaznamenání stačila zpráva v Telegramu a ke kontrole měsíce další?

V tomto návodu vytvoříte Pocket Ledger, evidenci výdajů v Telegramu s Google Sheets. Pošlete nákup, potvrďte navržené údaje a zeptejte se na měsíční součet. Tabulka uchovává řádky a počítá; bot vede rozhovor. Tady je hotový výsledek.

Prvním milníkem je jedna uložená káva. Druhým je součet, který ověříte v tabulce. Dozvíte se také, proč je slovo „uloženo“ v odpovědi jen polovinou důkazu.

Stáhněte sadu pro nastavení Pocket Ledger s upraveným výchozím sešitem, avatarem, promptem, nastavením Actions a testovacím listem. Importujte sešit do tabulky vytvořené Quickchat AI a pokračujte podle kroků níže. Kopírovatelné příklady používají angličtinu a listopad 2026, abyste mohli výsledky porovnat se snímky.

Co potřebujete pro evidenci výdajů v Telegramu?

Potřebujete Telegram, účet Google a účet Quickchat AI. Použijete nastavení v administraci a vzorec v tabulce, nemusíte hostovat žádný program.

1. Vytvořte si účet Quickchat AI, dokončete ověření a vytvořte Agenta s názvem Pocket Ledger.
2. Připravte si účet Google pro novou tabulku. Začněte níže uvedenými fiktivními záznamy.
3. Pro toto cvičení použijte nového bota v Telegramu. Pro závěrečný test přístupu mějte k dispozici druhý důvěryhodný účet Telegram.

Tarif Free v Quickchat AI je určen pro osobní, nekomerční učení a zahrnuje omezený příděl. AI konverzace i Simulation Testing spotřebovávají kredity. Před výběrem tarifu pro průběžné používání si prohlédněte aktuální tarify a limity.

Dva směry, dvě Actions. Uložení řádku samo o sobě nedává Agentovi možnost číst dřívější součty.

Krok 1: Jak připojit vlastního soukromého bota v Telegramu?

BotFather vytvoří identitu bota. Quickchat AI dodá Agenta, který odpovídá na zprávy.

Otevřete oficiálního @BotFather, pošlete /newbot, pojmenujte bota Pocket Ledger a zvolte dostupné uživatelské jméno končící na bot. Příkazem /setuserpic nahrajte avatar ze sady. Token uchovejte v soukromí; vložíte ho přímo do Quickchat AI.

V Quickchat AI otevřete External Apps → Telegram → Your own bot. Vyberte Connect to Telegram, vložte přihlašovací údaj do Bot Token a potvrďte dialog. Zapněte Enable your own bot a vyberte Save. Průvodce BotFather podrobně popisuje jednotlivé obrazovky.

Otevřete odkaz nového bota v Telegramu, odešlete /start a potom v soukromém chatu odešlete Hello. /start odešle uvítací zprávu; běžná zpráva vytvoří konverzaci v Inbox a metadata odesílatele potřebná v dalších krocích. Během nastavování nechte Actions pracující s osobními údaji neaktivní.

Otevřete tuto konverzaci v Quickchat AI přes Inbox → Details → Visitor. Najděte Telegram User Id a Telegram Chat Type (klíče metadat jsou telegram_user_id a telegram_chat_type). Zkopírujte číselné ID uživatele ovládacím prvkem, který se zobrazí při najetí myší, a ověřte typ chatu private.

ID pochází z metadat odesílatele Telegramu. Uživatelské jméno, číslo napsané do zprávy a vlastní ID bota jsou odlišné údaje. V dalších krocích použijete ID odesílatele k omezení obou Actions.

Krok 2: Jak připravit tabulku Google?

Integrace Google Sheets vytvoří tabulku a výchozí Action. Použijte tentýž soubor, aby Action i oprávnění Google odkazovaly na stejný zdroj.

1. Otevřete Actions & MCPs → Add Action → Google Sheets a autorizujte účet Google. Průvodce připojením Google Sheets vysvětluje udělení souhlasu i výchozí konfiguraci.
2. Výchozí Action ihned vypněte. Vytváří se jako aktivní. Ponechte název log_lead_to_google_sheet, protože při opětovném připojení se podle něj vyhledává. Změníme její účel na ukládání výdajů.
3. Otevřete vytvořenou tabulku a pojmenujte ji Pocket Ledger demo. V tomto novém ukázkovém souboru zvolte File → Import → Upload, vyberte pocket-ledger-starter.xlsx ze sady a zvolte Replace spreadsheet, poté klikněte na Import data. Připraví se tím Expenses i Summary v souboru, ke kterému má Quickchat AI přístup. Tuto volbu použijte pouze v nové ukázkové tabulce.
4. Zkontrolujte tři výchozí řádky níže. V Summary mají být počáteční součty EUR 7.70 a USD 6.00. Krok 6 vysvětluje vzorec a připojí čtecí Action.

Začněte připojením Google Sheets. Autorizace vytvoří tabulku, kterou používají obě Actions.

Chcete si listy vytvořit sami? Přejmenujte výchozí list na Expenses. Pro tyto anglické příklady nastavte File → Settings → Locale → United States. A:D a F:H naformátujte jako Plain text, E jako Number se dvěma desetinnými místy a vložte blok níže do A1. Ukotvěte záhlaví a rozšiřte sloupce. Přidejte Summary podle kroku 6. Google popisuje také import sešitu Excel do existující tabulky.

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

Sloupec conversation_url propojí každý nový výdaj s konverzací. U tří ručně zadaných příkladů jej nechte prázdný. Oprávnění Google drive.file zahrnuje soubory vytvořené aplikací nebo výslovně zpřístupněné soubory; tento postup používá tabulku vytvořenou integrací a nedává přístup k celému Disku.

Krok 3: Jak omezit výdaje na vlastní chat?

Nastavte Run only when u každé Action, která evidenci čte nebo do ní zapisuje. Musí platit obě podmínky, takže samotné vaše ID ve skupinovém chatu nestačí.

1. Otevřete neaktivní Action log_lead_to_google_sheet a najděte Run only when.
2. Přidejte obě uvedené podmínky. Použijte přesné klíče metadat a číslice svého ID, bez uživatelského jména nebo předpony @.
3. Action uložte a ponechte neaktivní. Stejné podmínky přidejte ke čtecí Action při jejím vytváření v kroku 6.

Podmínky ukládací Action v místním demu. Nahraďte fiktivní ID skutečným ID odesílatele a zopakujte obě podmínky na čtecí Action.

Obě podmínky patří na obě Actions. Jiný odesílatel nebo skupinový chat musí být zablokován ještě před odesláním HTTP požadavku do Google Sheets.

Jde o podmínky Actions vynucované serverem. Pokyn „odpovídej jen mně“ v promptu není kontrola přístupu. Omezte také sdílení tabulky a přístup k účtu Quickchat AI.

Krok 4: Jak nechat bota uložit potvrzený výdaj?

Upravte výchozí Action tak, aby přidávala jeden řádek v pořadí sloupců tabulky. Nastavte When to run → AI decides, aby mohla čekat na potvrzení. Před zapnutím pak Agentovi dejte pravidlo pro potvrzování.

Nastavte pole výdaje

V části What to ask the user first nahraďte pole pro leady těmito parametry. Jejich názvy ponechte přesně podle ukázky.

Ponechte skutečné ID tabulky ze stávajícího API Endpoint. Změňte rozsah na Expenses!A:H, ponechte metodu POST a v Query Params nastavte valueInputOption=RAW a insertDataOption=INSERT_ROWS. Pokud už jsou tyto parametry v URL, odstraňte duplicity.

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 vysvětlující zástupný text. Ponechte skutečné ID v původní URL a nenahrazujte ho tímto textem. V hodnotě Authorization vyberte existující Google Sheets System Token a v těle vestavěnou proměnnou URL konverzace.

Na kartě Body zadejte:

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

Místní konfigurace Action pro výdaje. Tělo určuje pořadí buněk; formát parametru amount určuje jeho číselný typ.

V editoru ponechte uvozovky kolem {{amount}}. Tento přesný zástupný výraz odkazuje na parametr Decimal Number, a proto se při nahrazení vytvoří číslo JSON, například 4.5. Bez uvozovek by JSON v editoru nebyl platný. Ve výsledné tabulce ověřte, že E obsahuje číslo zahrnuté do vzorce.

Google append API přidá řádek. RAW zachovává text, například poznámku začínající =, doslovně místo vyhodnocení jako vzorce. Číselný parametr dodá správný typ částky.

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.

Dejte Pocket Ledger instrukce

Otevřete Identity → Main Prompt a vložte následující text. Jmenuje obě Actions, takže druhý milník bude fungovat po přidání čtení přehledu.

Main Prompt se nachází v Identity. Místní snímek ukazuje umístění pole; použijte celý kopírovatelný blok níže.

Pravidlo potvrzení vám dává užitečnou pauzu. Před schválením nákupu můžete opravit „EUR 4.50“ na „EUR 5.00“; Agent má návrh upravit a znovu se zeptat.

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 zkontrolujte obě podmínky a zapněte Action pro výdaje. Název zůstává log_lead_to_google_sheet; nový postup evidence nyní určují parametry, popis a tělo.

Krok 5: Jak uložit první výdaj?

Teď přidejte do zápisníku první nový záznam. Nechte otevřené Telegram, Inbox i tabulku: uvidíte, jak stejná káva projde všemi třemi.

1. V soukromém chatu Telegram pošlete Coffee, 4.50 euros on 2026-11-04.
2. Zkontrolujte návrh: datum 2026-11-04, položka Coffee, kategorie Food, částka 4.50, měna EUR. Při ukládání řádku Action odvodí month jako 2026-11.
3. Před potvrzením zkontrolujte Expenses: měly by tam stále být jen tři výchozí řádky.

Pošlete Save it jednou a otevřete konverzaci v Inbox Quickchat AI. U odpovědi o uložení je rozbalovací položka 1 action called. Otevřete ji a podívejte se, co proběhlo za krátkou odpovědí v Telegramu.

Rozbalte Result → Show full. Zkontrolujte datum, odvozený měsíc, číselnou částku, měnu a HTTP stav. Při tomto živém běhu Google vrátil HTTP 200, updatedRows: 1 a updatedRange: Expenses!A5:H5.

Nakonec otevřete Expenses. Řádek 5 má obsahovat stejnou kávu, 2026-11 ve sloupci měsíce, 4.50 v částce a EUR v měně. Poslední sloupec odkazuje na konverzaci v Inbox, takže lze záznam dohledat ke zprávě, která ho vytvořila.

Nyní máte užitečný každodenní návyk: poslat, potvrdit, ověřit. Dále dejte botovi spolehlivý zdroj pro odpověď na to, kam tento měsíc odešly peníze.

Krok 6: Jak se zeptat na měsíční součet?

Nechte Google Sheets vypočítat součet a čtecí Action ho načíst. Díky výpočtu v tabulce zůstane odpověď ověřitelná i po ukončení konverzace.

Přidejte list Summary

Pokud jste importovali výchozí sešit, Summary i vzorce jsou už připravené. Počáteční hodnoty jsou EUR 7.70 a USD 6.00; uložení kávy změní jen řádek EUR. Pokud tabulku vytváříte ručně, postupujte podle kroků níže.

1. Vytvořte list Summary. Sloupce A:B nastavte na Plain text a do A1:C1 zadejte month, currency, total.
2. Do A2:B2 zadejte 2026-11 a EUR, do A3:B3 pak 2026-11 a USD.
3. Vložte tento vzorec do C2 a vyplňte ho dolů do C3. Sloupec C naformátujte jako číslo se dvěma desetinnými místy.

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

Funkce SUMIFS sčítá částky, jejichž měsíc i měna odpovídají řádku přehledu. Vyžaduje-li místní nastavení tabulky mezi argumenty středníky, nahraďte jimi čárky ve vzorci. Čísla v požadavcích JSON stále používají desetinnou tečku.

Výchozích EUR 7.70 plus nová káva za EUR 4.50 dává EUR 12.20. Zápisník za USD 6.00 má vlastní součet.

Výchozí vzorec pokrývá řádky 2 až 501. V zachyceném běhu končí jeho tři rozsahy po vložení nového řádku na 502. Sheets může při vkládání upravit odkazy; zkontrolujte, že všechny tři rozsahy Expenses zůstávají sladěné, a rozšiřte je společně dříve, než záznamy překročí pokrytý rozsah. Přidejte souhrnný řádek pro každou kombinaci měsíce a měny, na kterou se chcete ptát.

Přidejte čtecí Action

Otevřete Actions & MCPs → Add Action → API Action. Použijte Generate s níže uvedeným požadavkem; vytvořené Actions začínají jako neaktivní. Pojmenujte ji read_expense_summary a ponechte When to run na AI decides, aby se výsledek mohl použít v odpovědi. Znovu použijte stejné skutečné ID tabulky a Google Sheets System Token. Uživatelské parametry nejsou potřeba.

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.

Porovnejte vygenerované nastavení s následujícím vzorem. Pokud zvolíte Create manually, přidejte obě podmínky před prvním platným uložením, které může Action aktivovat. U obou Actions nechte Response filter prázdný, aby zůstala dostupná pole potřebná pro kontroly.

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 vrací values z rozsahu včetně záhlaví a vypočtených částek. UNFORMATTED_VALUE vrací číselné výsledky místo řetězců naformátovaných jako měna. Odpověď ponechte dostupnou Agentovi, aby mohl tyto hodnoty přečíst.

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žijte stejné dvě podmínky Run only when z kroku 3, uložte a aktivujte Action. Rozsah čtení zahrnuje 24 souhrnných řádků; při přidávání dalších ho vědomě rozšiřte.

Druhá Action potřebuje vlastní podmínky. Jde o snímek místního nastavení, nikoli skutečný test autorizace odesílatele.

Zeptejte se What is my November 2026 total in EUR? a potom na USD. V naší konverzaci Telegramu Pocket Ledger vrátil 12.2 EUR a 6 USD, což odpovídá formátovaným hodnotám 12.20 a 6.00 v tabulce. Pro každou odpověď načetl uložený přehled.

Otevřete odpověď s měsíčním součtem v Inbox a rozbalte její Action. Porovnejte vrácený řádek s Summary!C2. Živá odpověď níže obsahuje 2026-11, EUR, 12.2 a samostatný řádek USD, 6, s HTTP 200.

Jak zkontrolovat chyby před použitím skutečných výdajů?

Neúplné požadavky a blokované volající otestujte stejně pečlivě jako úspěšné uložení kávy. Ponechte ukázková data, dokud níže uvedené kontroly neprojdou.

Pro opakovatelné jazykové testy otevřete Testing → Create Dataset → Paste messages a použijte zprávy a hodnoticí kritéria ze sady. Potvrzovací sekvenci otestujte zvlášť v celé konverzaci. Metadata Preview nebo Simulation jsou testovací data; nedokazují zablokování skutečného druhého odesílatele Telegramu.

Místní dataset je připraven k testování. Jeho přítomnost není dokončený běh Simulation ani důkaz zápisu do Google Sheets.

Pokud chování neodpovídá očekávání, změňte jednu relevantní instrukci, zopakujte tentýž vstup a znovu prohlédněte volání i tabulku. Například předčasné přidání vyžaduje kontrolu formulace potvrzení v ukládací Action. Potvrzení je instrukce, nikoli databázová záruka jedinečnosti. Po timeoutu je kontrola tabulky důležitější než opětovné odeslání.

Jakmile postup funguje, odstraňte fiktivní výdaje, ponechte záhlaví i vzorce a přidejte souhrnné řádky pro měsíce a měny, které skutečně používáte. První reálný nákup může projít stejným krátkým postupem jako káva.

Může s nastavením Pocket Ledger pomoci AI asistent?

Připojený asistent pro správu účtu může připravit Agenta a zkontrolovat nastavení Actions. Postupujte podle Manage with AI přes záznam Quickchat AI v ChatGPT nebo záznam v Claude. Dejte mu sadu pro nastavení a tento požadavek:

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.

Souhlas Google i připojení Telegramu dokončí vlastník. Zkontrolujte nastavení a proveďte stejné kontroly bez ohledu na to, kdo údaje zadal.

Často kladené otázky

Jak evidovat výdaje v Telegramu pomocí Google Sheets?

Připojte bota Telegram k Quickchat AI Agentovi a autorizujte Google Sheets. Nastavte jednu Action pro přidání výdaje po potvrzení a druhou pro čtení měsíčního přehledu vypočítaného vzorcem. Obě Actions omezte na své uživatelské ID Telegram a soukromý chat.

Může mi bot říct, kolik jsem tento měsíc utratil?

Ano, pokud má požadovaný měsíc a měna řádek v nastaveném rozsahu Summary. Google Sheets vypočítá součet pomocí SUMIFS a čtecí Action ho načte. Action pouze pro přidávání řádků neumí součty načíst a chybějící souhrnný řádek neznamená nulu.

Může někdo jiný přes bota v Telegramu číst moje výdaje?

Obě Actions pro osobní data musí vyžadovat vaše ověřené telegram_user_id a telegram_chat_type rovné private. Tyto podmínky blokují volání jiných odesílatelů a skupin. Před přidáním osobních dat otestujte oba případy a omezte také přístup k tabulce a účtu Quickchat AI.

Je tato evidence výdajů v Telegramu zdarma?

Vytvoření bota Telegram je zdarma. Tarif Free v Quickchat AI umožňuje osobní, nekomerční učení s omezeným přídělem AI kreditů. AI odpovědi a Simulation Testing spotřebovávají kredity; průběžné používání závisí na dostupném přídělu a tarifu.

Potřebuji Apps Script, Python nebo server pro automatizaci?

Tento postup využívá Quickchat AI Actions a vzorec Google Sheets. Do administrace vložíte dodané nastavení požadavků, tělo JSON a prompt; nemusíte nasazovat Apps Script, bota v Pythonu ani automatizační server.

Mohu použít svou stávající tabulku výdajů?

Tento postup používá tabulku vytvořenou integrací Google Sheets v Quickchat AI. Oprávnění drive.file neposkytuje neomezený přístup k Disku. Nenahrazujte ID tabulky libovolným existujícím souborem s předpokladem, že bude dostupný.

Umí bot číst fotografie účtenek nebo hlasové zprávy?

Tento návod se věnuje výdajům zadaným textem. Extrakce z účtenek potřebuje vlastní test doručení obrázku v Telegramu a potvrzení, než se na ni lze spolehnout. Přepis hlasu a zpracování PDF účtenek nejsou součástí nastavení.

Jak řeší různé měny a duplicitní záznamy?

Každá měna má samostatný měsíční součet; tento postup měny nepřevádí. Potvrzení omezuje nechtěné záznamy, ale neposkytuje atomickou ochranu před duplicitami. Když uložení překročí časový limit, před opakováním zkontrolujte tabulku.