Telegram और Google Sheets से खर्च ट्रैकर बनाएँ

Piotr Grudzień
प्रकाशित पढ़ने का समय: 15 मिनट
Google Sheets के EUR 12.20 और USD 6.00 वाले सारांश के साथ Pocket Ledger की वास्तविक Telegram बातचीत

एक कॉफ़ी, बस का टिकट, एक नोटबुक। स्प्रेडशीट खोलने तक छोटी खरीदारी आसानी से भूल जाती है। क्या हो अगर उसे दर्ज करने के लिए एक Telegram संदेश और महीने का हिसाब देखने के लिए बस एक और संदेश काफ़ी हो?

इस गाइड में हम Pocket Ledger, यानी Telegram और Google Sheets से बना खर्च ट्रैकर बनाएँगे। खरीदारी का विवरण भेजें, सुझाए गए डेटा की पुष्टि करें और अपने महीने का कुल पूछें। आपकी शीट पंक्तियाँ रखती है और गणना करती है; बॉट बातचीत संभालता है। तैयार होने पर परिणाम ऐसा दिखता है।

पहला पड़ाव है एक कॉफ़ी सहेजना। दूसरा है ऐसा कुल जिसे शीट में जाँच सकें। आप यह भी समझेंगे कि चैट में “सहेज दिया” कहना केवल आधा प्रमाण क्यों है।

फ़ॉर्मैट की गई शुरुआती वर्कबुक, अवतार, प्रॉम्प्ट, Action सेटिंग और परीक्षण वर्कशीट के लिए Pocket Ledger सेटअप किट डाउनलोड करें। वर्कबुक को Quickchat AI द्वारा बनाई गई शीट में इंपोर्ट करें, फिर नीचे दिए गए चरणों का पालन करें। कॉपी किए जा सकने वाले सभी उदाहरण अंग्रेज़ी और नवंबर 2026 का इस्तेमाल करते हैं, ताकि आप अपने परिणाम स्क्रीनशॉट से मिला सकें।

Telegram खर्च ट्रैकर बनाने के लिए क्या चाहिए?

आपको Telegram, एक Google खाता और एक Quickchat AI खाता चाहिए। सेटअप में डैशबोर्ड की सेटिंग और स्प्रेडशीट का फ़ॉर्मूला इस्तेमाल होता है; कोई प्रोग्राम होस्ट नहीं करना है।

  1. Quickchat AI खाता बनाएँ, सत्यापन पूरा करें और Pocket Ledger नाम का Agent बनाएँ।
  2. नई शीट के लिए Google खाता तैयार रखें। नीचे के काल्पनिक रिकॉर्ड से शुरुआत करें।
  3. इस अभ्यास के लिए नया Telegram बॉट इस्तेमाल करें। अंत में एक्सेस की जाँच के लिए कोई दूसरा भरोसेमंद Telegram खाता भी उपलब्ध रखें।

Quickchat AI का Free प्लान व्यक्तिगत, गैर-व्यावसायिक सीखने के लिए है और उसका उपयोग सीमित है। AI बातचीत और Simulation Testing में क्रेडिट लगते हैं। लगातार इस्तेमाल के लिए प्लान चुनने से पहले वर्तमान प्लान और सीमाएँ देखें।

एक Action खर्च की पंक्तियाँ लिखती है और अलग Action सारांश पढ़ती है, इसका आरेख दो दिशाएँ, दो Actions। पंक्ति सहेज पाने से Agent को पुराने कुल पढ़ने का तरीका अपने आप नहीं मिलता।

चरण 1: अपना निजी Telegram बॉट कैसे जोड़ें?

BotFather आपके बॉट की पहचान बनाता है। Quickchat AI वह Agent देता है जो उसके संदेशों का जवाब देता है।

आधिकारिक @BotFather खोलें, /newbot भेजें, बॉट का नाम Pocket Ledger रखें और उपलब्ध ऐसा यूज़रनेम चुनें जो bot पर समाप्त हो। किट का अवतार अपलोड करने के लिए /setuserpic इस्तेमाल करें। टोकन को गुप्त रखें; आप उसे सीधे Quickchat AI में पेस्ट करेंगे।

BotFather में Pocket Ledger बॉट बनाते हुए, जिसका टोकन छिपाया गया है

दिखने वाला नाम और एक अलग यूज़रनेम चुनें। BotFather का टोकन छिपाया गया है।

Quickchat AI में External Apps → Telegram → Your own bot खोलें। Connect to Telegram चुनें, क्रेडेंशियल को Bot Token में पेस्ट करें और डायलॉग सबमिट करें। Enable your own bot चालू करें और Save चुनें। BotFather की विस्तृत गाइड में इन स्क्रीन का पूरा विवरण है।

Quickchat AI में Pocket Ledger जुड़ा हुआ है और Enable your own bot चालू है जुड़े हुए बॉट का नाम वही Pocket Ledger है जो आपको Telegram में दिखेगा।

Telegram में नए बॉट का लिंक खोलें, निजी चैट में /start भेजें और फिर Hello भेजें। /start स्वागत संदेश भेजता है; सामान्य संदेश से Inbox की बातचीत और भेजने वाले का मेटाडेटा बनता है, जिनकी आगे ज़रूरत होगी। व्यक्तिगत डेटा वाली Actions को सेटअप के दौरान निष्क्रिय रखें।

वास्तविक निजी Telegram बातचीत में Pocket Ledger, start और Hello का उत्तर देता है

Hello का उत्तर पुष्टि करता है कि Telegram आपके Agent तक पहुँच रहा है। Hello वाला संवाद Quickchat Inbox में भी दिखता है।

Quickchat AI में यह बातचीत Inbox → Details → Visitor के अंतर्गत खोलें। Telegram User Id और Telegram Chat Type खोजें। उनके मेटाडेटा कीज़ telegram_user_id और telegram_chat_type हैं। होवर करने पर दिखाई देने वाले बटन से संख्यात्मक यूज़र ID कॉपी करें और पुष्टि करें कि चैट प्रकार private है।

Inbox के विज़िटर विवरण में Telegram User Id फ़ील्ड और private पर सेट Telegram Chat Type, व्यक्तिगत मान छिपे हुए हैं इसी फ़ील्ड से अपनी भेजने वाले की ID लें। स्क्रीनशॉट में व्यक्तिगत पहचान छिपाई गई है; अपना वास्तविक मान इस्तेमाल करें।

यह ID Telegram के भेजने वाले के मेटाडेटा से आती है। आपका यूज़रनेम, संदेश में लिखा कोई नंबर और बॉट की अपनी ID अलग-अलग चीज़ें हैं। अगले चरणों में आप भेजने वाले की ID से दोनों Actions सीमित करेंगे।

चरण 2: Google Sheet कैसे तैयार करें?

Google Sheets इंटीग्रेशन एक स्प्रेडशीट और शुरुआती Action बनाता है। उसी फ़ाइल को इस्तेमाल करें, ताकि Action और Google की अनुमति एक ही संसाधन के लिए हों।

  1. Actions & MCPs → Add Action → Google Sheets खोलें और अपने Google खाते को अधिकृत करें। Google Sheets जोड़ने की गाइड में सहमति और शुरुआती सेटिंग समझाई गई है।
  2. शुरुआती Action तुरंत बंद करें। यह सक्रिय अवस्था में बनती है। इसका नाम log_lead_to_google_sheet रखें, क्योंकि दोबारा जोड़ते समय इसे इसी नाम से खोजा जाता है। हम इसका काम बदलकर खर्च सहेजना करेंगे।
  3. बनी हुई स्प्रेडशीट खोलें और उसका नाम Pocket Ledger demo रखें। इस नई डेमो फ़ाइल में File → Import → Upload चुनें, किट से pocket-ledger-starter.xlsx चुनें, फिर Replace spreadsheet चुनें और Import data पर क्लिक करें। इससे उस फ़ाइल में Expenses और Summary तैयार हो जाते हैं जिसे Quickchat AI ऐक्सेस कर सकता है। यह विकल्प केवल नई डेमो स्प्रेडशीट में इस्तेमाल करें।
  4. नीचे दी गई तीन शुरुआती पंक्तियाँ जाँचें। Summary में शुरुआती कुल EUR 7.70 और USD 6.00 होने चाहिए। चरण 6 फ़ॉर्मूला समझाता है और पढ़ने वाली Action जोड़ता है।

Quickchat AI का Google Sheets कनेक्शन डायलॉग, जो बनाई जाने वाली स्प्रेडशीट और शुरुआती Action समझाता है Google Sheets कनेक्शन से शुरू करें। इसकी अनुमति प्रक्रिया वह स्प्रेडशीट बनाती है जिसे दोनों Actions इस्तेमाल करती हैं।

टैब खुद बनाना चाहते हैं? शुरुआती टैब का नाम बदलकर Expenses रखें। इन अंग्रेज़ी उदाहरणों के लिए File → Settings → Locale → United States सेट करें। A:D और F:H को Plain text, और E को दो दशमलव अंकों वाला Number फ़ॉर्मैट दें, फिर नीचे का ब्लॉक A1 में पेस्ट करें। हेडर पंक्ति फ़्रीज़ करें और कॉलम चौड़े करें। चरण 6 के अनुसार Summary जोड़ें। 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

Telegram से सहेजने से पहले वास्तविक Expenses टैब, जिसमें तीन काल्पनिक शुरुआती खरीदारी हैं तीन शुरुआती खर्च, चौथे के लिए तैयार। E में राशियाँ संख्याएँ हैं; F में मुद्रा कोड अलग टेक्स्ट मान हैं।

conversation_url कॉलम हर नए खर्च को उसकी बातचीत से जोड़ेगा। मैन्युअल रूप से दर्ज तीन उदाहरणों के लिए इसे खाली रखें। Google की drive.file अनुमति ऐप द्वारा बनाई गई या स्पष्ट रूप से अनुमति दी गई फ़ाइलों पर लागू होती है। यह सेटअप इंटीग्रेशन से बनाई गई शीट इस्तेमाल करता है और आपके पूरे Drive का एक्सेस नहीं देता।

चरण 3: खर्चों को अपनी चैट तक कैसे सीमित रखें?

डायरी पढ़ने या लिखने वाली हर Action पर Run only when सेट करें। दोनों शर्तें पूरी होनी चाहिए, इसलिए समूह चैट में केवल आपकी ID काफ़ी नहीं है।

मेटाडेटा कीतुलनामान
telegram_user_idequalsचरण 1 से मिली आपकी वास्तविक संख्यात्मक भेजने वाले की ID
telegram_chat_typeequalsprivate
  1. निष्क्रिय log_lead_to_google_sheet Action खोलें और Run only when खोजें।
  2. ऊपर की दोनों शर्तें जोड़ें। ठीक वही मेटाडेटा कीज़ और अपनी ID के अंक इस्तेमाल करें, यूज़रनेम या @ प्रीफ़िक्स नहीं।
  3. Action को निष्क्रिय रखते हुए सहेजें। चरण 6 में पढ़ने वाली Action बनाते समय उस पर भी यही शर्तें लागू करें।

खर्च Action का एडिटर, जिसमें मालिक की ID और निजी चैट की शर्तें दिखती हैं स्थानीय डेमो में सहेजने वाली Action की शर्तें। काल्पनिक ID को अपनी वास्तविक भेजने वाले की ID से बदलें और पढ़ने वाली Action पर भी दोनों शर्तें दोहराएँ।

व्यक्तिगत डेटा की किसी भी Action के चलने से पहले मालिक की पहचान और निजी Telegram चैट की आवश्यकता दिखाने वाला आरेख दोनों Actions पर दोनों शर्तें ज़रूरी हैं। दूसरे भेजने वाले या समूह चैट को Google Sheets तक HTTP अनुरोध पहुँचने से पहले जाँच में रुक जाना चाहिए।

ये सर्वर द्वारा लागू Action शर्तें हैं। प्रॉम्प्ट में “केवल मुझे जवाब देना” लिखना एक्सेस की जाँच नहीं है। शीट की शेयरिंग और Quickchat AI खाते के एक्सेस को भी सीमित रखें।

चरण 4: बॉट से पुष्टि किया गया खर्च कैसे सहेजवाएँ?

शुरुआती Action को बदलें ताकि वह शीट के कॉलम क्रम में एक पंक्ति जोड़े। When to run → AI decides सेट करें, ताकि वह पुष्टि की प्रतीक्षा कर सके। फिर उसे सक्रिय करने से पहले Agent को पुष्टि का नियम दें।

खर्च के फ़ील्ड सेट करें

What to ask the user first में लीड वाले फ़ील्ड को इन पैरामीटर से बदलें। पैरामीटर के नाम बिल्कुल दिखाए गए नामों जैसे रखें।

पैरामीटरफ़ॉर्मैटआवश्यकदर्ज करने वाला विवरण
dateTextहाँमालिक द्वारा पुष्टि की गई खर्च की तारीख YYYY-MM-DD में। न होने पर पूछें।
monthTextहाँपुष्टि की गई तारीख से लिया गया YYYY-MM।
itemTextहाँखरीद का छोटा नाम।
categoryTextहाँमालिक से तय की गई सरल श्रेणी, जैसे भोजन या परिवहन।
amountDecimal Numberहाँधनात्मक संख्यात्मक राशि, मुद्रा चिह्न के बिना।
currencyTextहाँपुष्टि किया गया ISO मुद्रा कोड, जैसे EUR या USD। अस्पष्ट चिह्नों को स्पष्ट करें।
noteTextनहींवैकल्पिक नोट। न दिया गया हो तो खाली रखें।

मौजूदा API Endpoint से वास्तविक स्प्रेडशीट ID बनाए रखें। रेंज को 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 में मौजूद वास्तविक ID रखें; उस पर यह प्लेसहोल्डर पेस्ट न करें। Authorization के मान में मौजूदा Google Sheets System Token चुनें और बॉडी में पहले से उपलब्ध बातचीत URL का वेरिएबल चुनें।

Body टैब में यह दर्ज करें:

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

वास्तविक API Endpoint Body एडिटर, जिसमें खर्च की पंक्ति और पैरामीटर चिप्स दिखते हैं स्थानीय खर्च Action की सेटिंग। बॉडी सेल का क्रम तय करती है; राशि पैरामीटर का फ़ॉर्मैट उसका संख्यात्मक प्रकार तय करता है।

एडिटर में {{amount}} के आसपास के उद्धरण चिह्न रहने दें। यह सटीक प्लेसहोल्डर Decimal Number पैरामीटर को संदर्भित करता है, इसलिए मान बदलने पर 4.5 जैसी JSON संख्या बनती है। उद्धरण हटाने से एडिटर का JSON अमान्य हो जाता है। बनी हुई शीट में जाँचें कि E संख्यात्मक है और फ़ॉर्मूले में शामिल होता है।

Google का append API पंक्ति जोड़ता है। 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 जोड़ने के बाद दूसरा पड़ाव भी काम करे।

Quickchat AI में Pocket Ledger का Main Prompt एडिटर Main Prompt, Identity में मिलता है। यह स्थानीय स्क्रीनशॉट फ़ील्ड की जगह दिखाता है; नीचे का पूरा कॉपी करने योग्य ब्लॉक इस्तेमाल करें।

पुष्टि का नियम आपको जाँचने का उपयोगी अवसर देता है। खरीदारी स्वीकार करने से पहले आप “EUR 4.50” को “EUR 5.00” कर सकते हैं; Agent को प्रस्ताव अपडेट करके फिर से पुष्टि माँगनी चाहिए।

Pocket Ledger का Main Prompt कॉपी करें
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.

प्रॉम्प्ट सहेजें, चलने की दोनों शर्तें फिर जाँचें और खर्च Action सक्रिय करें। नाम अभी भी log_lead_to_google_sheet है, लेकिन नए पैरामीटर, विवरण और बॉडी अब खर्च का काम तय करते हैं।

चरण 5: पहला खर्च कैसे सहेजें?

अब डायरी में पहली नई प्रविष्टि जोड़ें। Telegram, Inbox और अपनी शीट खुली रखें: आप उसी कॉफ़ी को तीनों में आगे बढ़ते देखेंगे।

  1. अपनी निजी Telegram चैट में Coffee, 4.50 euros on 2026-11-04 भेजें।
  2. प्रस्ताव जाँचें: तारीख 2026-11-04, वस्तु Coffee, श्रेणी Food, राशि 4.50, मुद्रा EUR। पंक्ति सहेजते समय Action, month का मान 2026-11 निकालती है।
  3. पुष्टि से पहले Expenses देखें: उसमें अभी भी केवल शुरुआती तीन पंक्तियाँ होनी चाहिए।

Save it एक बार भेजें, फिर Quickchat AI के Inbox में बातचीत खोलें। सहेजने की पुष्टि वाले उत्तर में 1 action called नाम का खुलने वाला अनुभाग है। उसे खोलकर देखें कि छोटे से Telegram उत्तर के पीछे क्या हुआ।

Quickchat Inbox में कॉफ़ी सहेजने का उत्तर और एक Action कॉल दिखाने वाला खुलने योग्य अनुभाग Inbox में वही पुष्टि, जहाँ Action की जाँच की जा सकती है।

Result → Show full खोलें। तारीख, उससे निकाला गया महीना, संख्यात्मक राशि, मुद्रा और HTTP स्टेटस जाँचें। इस वास्तविक रन में Google ने HTTP 200, updatedRows: 1 और updatedRange: Expenses!A5:H5 लौटाए।

Inbox में खोली गई खर्च Action के वास्तविक इनपुट और एक पंक्ति सफलतापूर्वक जोड़ने का उत्तर, व्यक्तिगत पहचान छिपाई गई है सहेजने वाली Action ने राशि 4.5 संख्या के रूप में भेजी और एक पंक्ति लिखी। व्यक्तिगत पहचान छिपाई गई है; लौटाई गई रेंज और परिणाम दिखते रहते हैं।

आखिर में Expenses खोलें। पंक्ति 5 में वही कॉफ़ी होनी चाहिए, महीने के कॉलम में 2026-11, राशि में 4.50 और मुद्रा में EUR के साथ। आखिरी कॉलम Inbox बातचीत का लिंक देता है, जिससे आप प्रविष्टि को उसे बनाने वाले संदेश तक खोज सकते हैं।

Telegram में पुष्टि के बाद Google Sheets, जिसमें Expenses की पंक्ति 5 पर नई कॉफ़ी है चौथा खर्च Telegram के ज़रिए आया। प्रकाशित तस्वीर में निजी Inbox लिंक छिपाया गया है।

अब आपके पास रोज़ काम आने वाली आदत है: भेजें, पुष्टि करें, जाँचें। अगला काम है बॉट को ऐसा भरोसेमंद डेटा देना, जिसे वह तब पढ़ सके जब आप पूछें कि महीने का पैसा कहाँ गया।

चरण 6: मासिक कुल कैसे पूछें?

Google Sheets को कुल की गणना करने दें, फिर पढ़ने वाली Action से उसे प्राप्त करें। गणना शीट में रहने से बातचीत समाप्त होने के बाद भी जवाब जाँचा जा सकता है।

Summary टैब जोड़ें

अगर आपने शुरुआती वर्कबुक इंपोर्ट की है, तो Summary और उसके फ़ॉर्मूले पहले से तैयार हैं। शुरुआती मान EUR 7.70 और USD 6.00 हैं; कॉफ़ी सहेजने से केवल EUR की पंक्ति बदलती है। अगर आप शीट खुद बना रहे हैं, तो नीचे दिए गए चरण अपनाएँ।

कॉफ़ी सहेजने से पहले शुरुआती Summary टैब, जिसमें EUR 7.70 और USD 6.00 हैं शुरुआत: दो मुद्राएँ, दो स्वतंत्र कुल।

  1. Summary नाम का टैब बनाएँ। A:B कॉलम को Plain text पर सेट करें, फिर A1:C1 में month, currency, total दर्ज करें।
  2. A2:B2 में 2026-11 और EUR दर्ज करें, फिर A3:B3 में 2026-11 और USD।
  3. C2 में यह फ़ॉर्मूला दर्ज करें और उसे C3 तक भरें। C को दो दशमलव स्थानों वाली संख्या के रूप में फ़ॉर्मैट करें।
=SUMIFS(Expenses!$E$2:$E$501,Expenses!$B$2:$B$501,A2,Expenses!$F$2:$F$501,B2)

SUMIFS फ़ंक्शन उन राशियों को जोड़ता है जिनका महीना और मुद्रा सारांश पंक्ति से मेल खाते हैं। अगर शीट की लोकैल को आर्ग्युमेंट के बीच सेमीकोलन चाहिए, तो फ़ॉर्मूले के कॉमा को सेमीकोलन से बदलें। JSON अनुरोध की संख्याओं में फिर भी दशमलव बिंदु इस्तेमाल होता है।

कॉफ़ी सहेजने के बाद Summary का वास्तविक फ़ॉर्मूला और नवंबर के अपडेट किए गए कुल EUR 12.20 के पीछे का फ़ॉर्मूला देखने के लिए C2 चुनें। USD की पंक्ति 6.00 ही रहती है।

नवंबर के EUR 12.20 को USD 6.00 से अलग रखने वाली उदाहरण गणना शुरुआती EUR 7.70 में नई EUR 4.50 की कॉफ़ी जोड़ने पर EUR 12.20 होते हैं। USD 6.00 की नोटबुक का अलग कुल है।

शुरुआती फ़ॉर्मूला पंक्ति 2 से 501 तक कवर करता है। इस रिकॉर्ड किए गए रन में नई पंक्ति जुड़ने के बाद उसकी तीनों रेंज 502 पर समाप्त होती हैं। पंक्ति जोड़ते समय Sheets रेफ़रेंस बदल सकता है; जाँचें कि Expenses की तीनों रेंज के आरंभ और अंत समान रहें, और प्रविष्टियाँ सीमा से बाहर जाने से पहले तीनों को एक साथ बढ़ाएँ। जिस महीने और मुद्रा के संयोजन का कुल पूछना चाहते हैं, उसके लिए सारांश पंक्ति जोड़ें।

पढ़ने वाली Action जोड़ें

Actions & MCPs → Add Action → API Action खोलें। नीचे के अनुरोध के साथ Generate इस्तेमाल करें; इससे बनी Actions शुरुआत में निष्क्रिय होती हैं। नाम read_expense_summary रखें और When to run को AI decides पर रहने दें, ताकि परिणाम जवाब में इस्तेमाल हो सके। वही वास्तविक स्प्रेडशीट ID और Google Sheets System Token दोबारा इस्तेमाल करें। उपयोगकर्ता से मिलने वाले पैरामीटर आवश्यक नहीं हैं।

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 सक्रिय हो सकती है। जाँच में इस्तेमाल होने वाले फ़ील्ड बनाए रखने के लिए दोनों Actions पर Response filter खाली छोड़ें।

सारांश पढ़ने का अनुरोध कॉपी करें
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

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.

चरण 3 की वही दो Run only when शर्तें लगाएँ, सहेजें और Action चालू करें। पढ़ने की रेंज में सारांश की 24 पंक्तियाँ शामिल हैं; और पंक्तियाँ जोड़ने पर इस रेंज को भी ध्यान से बढ़ाएँ।

खर्च सारांश पढ़ने वाली Action, जिसमें वही मालिक ID और निजी चैट की शर्तें हैं दूसरी Action पर भी अलग से शर्तें लगानी हैं। यह स्थानीय सेटिंग का स्क्रीनशॉट है, वास्तविक भेजने वाले की अनुमति का परीक्षण नहीं।

What is my November 2026 total in EUR? पूछें, फिर USD का कुल पूछें। हमारी Telegram बातचीत में Pocket Ledger ने 12.2 EUR और 6 USD लौटाए, जो शीट में फ़ॉर्मैट किए गए 12.20 और 6.00 से मेल खाते हैं। हर उत्तर के लिए उसने सहेजा हुआ सारांश पढ़ा।

कॉफ़ी सहेजने के बाद नवंबर के EUR और USD कुल के वास्तविक Telegram उत्तर

हर मुद्रा के लिए एक सवाल। Pocket Ledger याद रखे गए चैट संदेशों का जोड़ निकालने के बजाय शीट पढ़ता है।

Inbox में मासिक कुल वाला उत्तर खोलें और उसकी Action का विवरण खोलें। लौटाई गई पंक्ति को Summary!C2 से मिलाएँ। नीचे दिए गए वास्तविक उत्तर में 2026-11, EUR, 12.2 और अलग USD, 6 वाली पंक्ति है, HTTP 200 के साथ।

Inbox में खर्च सारांश पढ़ने वाली Action, जो Google Sheets से नवंबर के वास्तविक EUR और USD कुल लौटाती है उत्तर, लौटे हुए मान और शीट अब एक-दूसरे से मेल खाते हैं। यही वह मंज़िल है जो आपने सबसे ऊपर देखी थी।

असली खर्च इस्तेमाल करने से पहले गलतियाँ कैसे जाँचें?

अधूरे अनुरोध और ब्लॉक किए जाने वाले उपयोगकर्ताओं की उतनी ही सावधानी से जाँच करें जितनी सफल कॉफ़ी रिकॉर्ड की। नीचे की जाँचें पास होने तक डेमो डेटा रहने दें।

यह आज़माएँक्या जाँचना है
Lunch, $12 yesterdayAgent मुद्रा और वास्तविक तारीख पूछता है। कोई नई पंक्ति नहीं आती।
पुष्टि से पहले सुझाई गई राशि सुधारेंएक पंक्ति जुड़ने से पहले सुधारे गए प्रस्ताव की पुष्टि होती है।
नवंबर का कुल पहले EUR, फिर USD में पूछेंउदाहरण डेटा के लिए अलग परिणाम: EUR 12.20 और USD 6.00।
दिसंबर की सारांश पंक्ति न होने पर दिसंबर 2026 पूछेंAgent मनगढ़ंत शून्य बताने के बजाय कहता है कि कुल उपलब्ध नहीं है।
दूसरा भेजने वाला कुल पूछता है और खर्च सहेजने की कोशिश करता हैदोनों Actions रोकी जाती हैं और व्यक्तिगत मान उजागर नहीं होते।
मालिक समूह में वही अनुरोध करता हैचैट निजी न होने के कारण दोनों Actions रोकी जाती हैं।
सेव विफल होती है या समय समाप्त हो जाता हैजवाब विफलता या अनिश्चितता बताता है। दोबारा कोशिश से पहले शीट देखें।

दोहराए जा सकने वाले भाषा परीक्षणों के लिए Testing → Create Dataset → Paste messages खोलें और किट के संदेश तथा मूल्यांकन मानदंड इस्तेमाल करें। पुष्टि का क्रम जाँचने के लिए पूरी बातचीत अलग से चलाएँ। Preview या Simulation का मेटाडेटा परीक्षण डेटा है; वह यह साबित नहीं करता कि दूसरा वास्तविक Telegram भेजने वाला ब्लॉक होता है।

Quickchat AI के वास्तविक Testing इंटरफ़ेस में Pocket Ledger का परीक्षण डेटासेट स्थानीय डेटासेट परीक्षण के लिए तैयार है। उसकी मौजूदगी का अर्थ पूरा हुआ Simulation रन या Google Sheets में लिखे जाने का प्रमाण नहीं है।

अगर व्यवहार गलत हो, तो एक संबंधित निर्देश बदलें, फिर वही इनपुट दोहराकर कॉल और शीट फिर जाँचें। उदाहरण के लिए, समय से पहले पंक्ति जुड़ने पर सहेजने वाली Action में पुष्टि की भाषा ध्यान से देखें। पुष्टि एक निर्देश है, डेटाबेस में विशिष्टता की गारंटी नहीं। टाइमआउट के बाद फिर भेजने से ज़्यादा ज़रूरी शीट जाँचना है।

जब पूरा क्रम काम करने लगे, तो काल्पनिक खर्च पंक्तियाँ हटाएँ, हेडर और फ़ॉर्मूले रखें और उन महीनों तथा मुद्राओं के सारांश जोड़ें जिन्हें आप वास्तव में इस्तेमाल करते हैं। पहली असली खरीद भी कॉफ़ी वाले इसी छोटे क्रम से दर्ज की जा सकती है।

क्या AI सहायक Pocket Ledger सेट करने में मदद कर सकता है?

जुड़ा हुआ खाता प्रबंधन सहायक Agent तैयार करने और Action सेटिंग की समीक्षा में मदद कर सकता है। Quickchat AI की ChatGPT लिस्टिंग या Claude लिस्टिंग के साथ Manage with AI का पालन करें। उसे सेटअप किट और यह अनुरोध दें:

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 से खर्च कैसे ट्रैक करें?

Telegram बॉट को Quickchat AI Agent से जोड़ें और Google Sheets की अनुमति दें। एक Action को पुष्टि के बाद खर्च जोड़ने के लिए और दूसरी को फ़ॉर्मूले से बने मासिक सारांश को पढ़ने के लिए सेट करें। दोनों Actions को अपनी Telegram यूज़र ID और निजी चैट तक सीमित रखें।

क्या बॉट बता सकता है कि मैंने इस महीने कितना खर्च किया?

हाँ, जब माँगे गए महीने और मुद्रा की पंक्ति सेट की गई Summary रेंज में हो। Google Sheets, SUMIFS से कुल निकालता है और पढ़ने वाली Action उसे प्राप्त करती है। केवल पंक्ति जोड़ने वाली Action कुल नहीं पढ़ सकती, और सारांश पंक्ति का न होना शून्य नहीं है।

क्या कोई दूसरा व्यक्ति Telegram बॉट से मेरे खर्च पढ़ सकता है?

व्यक्तिगत डेटा की दोनों Actions में आपकी सत्यापित telegram_user_id और private के बराबर telegram_chat_type आवश्यक होना चाहिए। ये शर्तें दूसरे भेजने वालों और समूहों की कॉल रोकती हैं। व्यक्तिगत डेटा जोड़ने से पहले दोनों स्थितियाँ जाँचें और शीट तथा Quickchat AI खाते का एक्सेस भी सीमित रखें।

क्या यह Telegram खर्च ट्रैकर मुफ़्त है?

Telegram बॉट बनाना मुफ़्त है। Quickchat AI का Free प्लान सीमित AI क्रेडिट के साथ व्यक्तिगत, गैर-व्यावसायिक सीखने के लिए है। AI जवाब और Simulation Testing में क्रेडिट लगते हैं; लगातार इस्तेमाल उपलब्ध सीमा और प्लान पर निर्भर करता है।

क्या मुझे Apps Script, Python या ऑटोमेशन सर्वर चाहिए?

इस सेटअप में Quickchat AI Actions और Google Sheets का फ़ॉर्मूला इस्तेमाल होता है। आप दिए गए अनुरोध की सेटिंग, JSON बॉडी और प्रॉम्प्ट डैशबोर्ड में पेस्ट करते हैं; Apps Script, Python बॉट या ऑटोमेशन सर्वर डिप्लॉय नहीं करते।

क्या मैं अपनी मौजूदा खर्च स्प्रेडशीट इस्तेमाल कर सकता हूँ?

इस सेटअप में Quickchat AI के Google Sheets इंटीग्रेशन से बनाई गई स्प्रेडशीट इस्तेमाल होती है। उसकी drive.file अनुमति आपके Drive का असीमित एक्सेस नहीं देती। स्प्रेडशीट ID को किसी भी मौजूदा फ़ाइल से बदलकर यह न मानें कि वह उपलब्ध होगी।

क्या बॉट रसीद की तस्वीरें या वॉइस नोट पढ़ सकता है?

यह ट्यूटोरियल टाइप किए गए खर्चों के लिए है। रसीद से जानकारी निकालने पर भरोसा करने से पहले Telegram से तस्वीर पहुँचने और पुष्टि का अलग परीक्षण चाहिए। वॉइस ट्रांसक्रिप्शन और PDF रसीद पार्सिंग इस सेटअप में शामिल नहीं हैं।

अलग-अलग मुद्राओं और डुप्लिकेट प्रविष्टियों को कैसे संभाला जाता है?

हर मुद्रा का अलग मासिक कुल होता है; यह सेटअप मुद्रा बदलता नहीं है। पुष्टि से अनजाने में बनी प्रविष्टियाँ कम होती हैं, लेकिन एक ही परमाणु ऑपरेशन में डुप्लिकेट रोकने की गारंटी नहीं मिलती। सेव में टाइमआउट हो तो दोबारा भेजने से पहले शीट जाँचें।

Quickchat AI Quickchat AI Ask Quickchat AI a question