Skip to content

Daily

Get a daily vocabulary quiz from your sheet on Telegram

Every evening your Telegram bot quizzes you on five words from your sheet, checks your answers and records your score next to each word.

Runs
Daily
Apps
Google Sheets, Telegram
AI
Yes, uses the built-in AI allowance
Access
Telegram bot token; Sheets read+write

Send this to your assistant

Create a ClickRuntime automation: every evening, send me 5 words from my Vocab sheet on Telegram. When I answer, check it and record the result in the sheet.

Paste it into your assistant. It tells you what it will send or change before it runs live.

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

Someone learning Spanish for a move abroad keeps a sheet of new words from lessons and podcasts. The list grows every week, but it rarely gets reviewed, and the words that never stick are the ones that get skipped. Flashcard apps mean retyping everything into yet another place.

A short quiz on Telegram each evening turns the sheet into a study routine. Answers are checked with some tolerance for typos and synonyms, and each word's score is written back, so the words you keep missing come up more often.

What you get out of it

  • Review happens without planning it

    The quiz arrives at the same time each evening, in an app you already open. Five words takes two minutes, which is easy to keep up for months.

  • Your own word list, not a generic course

    The words come from your sheet, so they are the ones from your lessons, your job or your reading. Adding a word is just adding a row.

  • Fair marking for real answers

    Answers are checked for meaning, so a small typo or a close synonym is not marked wrong. That keeps the score honest without being discouraging.

  • Scores show what still needs work

    Each word keeps a running record of right and wrong answers in the sheet. You can sort by it to see which words to practise, and weak words are picked more often.

How it works

What happens, step by step

  1. Every evening, ClickRuntime picks five words from your Vocab sheet, favouring ones you have got wrong before.

  2. It sends them to you as a quiz on Telegram.

  3. When you reply, AI compares your answers with the meanings in the sheet, allowing for small typos and synonyms.

  4. You get your result back on Telegram, and each word's score is updated in the sheet.

Before it runs live

  • Connect your Google Sheets account and pick the spreadsheets it may use
  • Connect Telegram

What you get

RunsDaily
Get a daily vocabulary quiz from your sheet on Telegramtoday, 9:00Succeeded
Telegram · Vocab bot4/5 correct. aprovechar = to make the most of

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.
  • Your own rules

    Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.

  • Any number of apps

    One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.

  • AI where it helps

    Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.

  • On a schedule or on each event

    Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

  • Run it at a different time, more or less often, or only on weekdays
  • Change what the AI looks for, or how it writes the result
  • Add another app, for example also send it to Slack
  • Combine it with other Google Sheets and Telegram steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.
daily_vocabulary_quiz_from_a_sheet.pyexample
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
from clickruntime import on_trigger, on_event, credentials, http, state, ai

SHEET_ID = "your-spreadsheet-id"
CHAT_ID = "your-telegram-chat-id"

def tg(text):
    http.post(f"https://api.telegram.org/bot{credentials.secret('TELEGRAM_BOT_TOKEN')}/sendMessage", json={"chat_id": CHAT_ID, "text": text})

def sheet():
    return build("sheets", "v4", credentials=Credentials(credentials.connection("google", "work")), cache_discovery=False).spreadsheets().values()

@on_trigger
def quiz(event):
    rows = sheet().get(spreadsheetId=SHEET_ID, range="Vocab!A2:D").execute().get("values", [])
    rows = [(r + ["", "", "0", "0"])[:4] for r in rows]
    ranked = sorted(range(len(rows)), key=lambda i: int(rows[i][2] or 0) - int(rows[i][3] or 0))[:5]
    state.set("quiz", [[i] + rows[i] for i in ranked])
    tg("Tonight's words:\n" + "\n".join(f"{n + 1}. {rows[i][0]}" for n, i in enumerate(ranked)))
    return {"asked": len(ranked)}

@on_event
def answer(event):
    quiz = state.get("quiz")
    reply = ((event.json or {}).get("message") or {}).get("text", "")
    if not quiz or not reply:
        return {"skipped": True}
    try:
        res = ai.generate(f"Words and meanings: {[q[1:3] for q in quiz]}\nAnswers: {reply}\nFor each word, is the answer right (allow typos, synonyms)?",
                          json_schema={"type": "array", "items": {"type": "boolean"}}, max_output_tokens=60).json
    except ai.AIError:
        tg("Could not check your answers right now, try again later.")
        return {"checked": False}
    for (i, word, meaning, right, wrong), ok in zip(quiz, res):
        counts = [int(right or 0) + ok, int(wrong or 0) + (not ok)]
        sheet().update(spreadsheetId=SHEET_ID, range=f"Vocab!C{i + 2}:D{i + 2}", valueInputOption="RAW", body={"values": [counts]}).execute()
    tg(f"{sum(res)}/{len(quiz)} correct. " + ", ".join(f"{q[1]} = {q[2]}" for q, ok in zip(quiz, res) if not ok))
    state.delete("quiz")
    return {"correct": sum(res)}

FAQ

Common questions

Which words are picked each evening?
Words with the lowest scores and those not asked recently are chosen first. New words you have just added get asked soon, so they are practised while they are fresh.
What columns does the sheet need?
One column for the word and one for its meaning, plus columns for correct and wrong counts that the quiz fills in. Notes or example sentences in other columns are left alone.
Can I quiz in both directions?
Yes. The quiz can show the word and ask for the meaning, or show the meaning and ask for the word, or alternate between the two.
What permissions does it need?
Telegram bot token; Sheets read+write. Nothing else in your accounts is used.
Does it need AI?
Yes. It uses ClickRuntime's built-in AI, so you don't need an OpenAI or Anthropic key. Every plan includes a monthly AI allowance.
How many runs does it use?
One run each time it runs (daily). Checks that find nothing to do and stop right away aren't counted.
Can I change how it works?
Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

Set up “Get a daily vocabulary quiz from your sheet on Telegram” from your assistant

Copy the prompt above, or connect your assistant first. Free plan, no credit card.