Skip to content

Every 5 minutes

Get a Telegram message when a Google Sheet gets a new row

Every 5 minutes ClickRuntime checks a Google Sheet and sends a Telegram message for each new row, such as a form response or order, with the columns you pick.

Runs
Every 5 minutes
Apps
Google Sheets, Telegram
AI
Not needed
Access
Sheets read-only (spreadsheets.readonly); bot token

Send this to your assistant

Create a ClickRuntime automation: every 5 minutes, check my "Orders" Google Sheet and send me a Telegram message for each new row with the Name, Product, Amount and Phone columns.

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

Google Sheets is where many small businesses collect orders, sign-ups and form responses. Sheets can email you about changes, but those emails are vague, delayed and do not show what was added.

This automation checks the sheet every 5 minutes and sends a Telegram message for each new row, with the columns that matter written out, so you can call the customer or start the order straight away.

It suits shops taking orders through Google Forms, event organisers tracking sign-ups and anyone whose sheet is filled by another tool.

What you get out of it

  • See the row, not just a change notice

    The message shows the actual values, so you know what came in without opening the sheet.

  • Pick the columns

    Only the fields you need are sent, so long rows do not turn into long messages.

  • Works with any source

    Forms, website integrations or teammates typing in rows all trigger the same alert.

  • No scripts inside the sheet

    Nothing is added to the spreadsheet itself, and your bot token stays out of shared files.

  • Share with a team

    Send to a Telegram group so whoever is free can pick up the new order.

How it works

What happens, step by step

  1. Every 5 minutes, ClickRuntime reads the tab you chose in your Google Sheet.

  2. It compares the number of rows with the last check to find new ones.

  3. For each new row it sends a Telegram message with the columns you picked, labelled by their header names.

Before it runs live

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

What you get

RunsEvery 5 minutes
Get a Telegram message when a Google Sheet gets a new rowtoday, 9:00Succeeded
Telegram · Orders🆕 New row in Orders Name: Leila Haddad Product: Oak shelf, 90 cm Amount: 145.00 Phone: +44 7700 900123

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

  • Act only on the items that match your own rules, and skip the rest
  • Add an AI step, for example to summarize, sort or draft a reply
  • 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.
get_a_telegram_message_when_a_google_sheet_gets_a_new_row.pyexample
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
from clickruntime import on_trigger, credentials, http, state

SHEET_ID, TAB, CHAT_ID = "your-sheet-id", "Orders", "123456789"
COLUMNS = ["Name", "Product", "Amount", "Phone"]

def tg(method, **params):
    r = http.post(f"https://api.telegram.org/bot{credentials.secret('TELEGRAM_BOT_TOKEN')}/{method}", json=params)
    r.raise_for_status()
    return r.json()["result"]

@on_trigger
def run(event):
    rows = build("sheets", "v4", credentials=Credentials(credentials.connection("google", "work")), cache_discovery=False).spreadsheets().values().get(
        spreadsheetId=SHEET_ID, range=f"{TAB}!A:Z").execute().get("values", [])
    if not rows:
        return {"new": 0}
    header, data = rows[0], rows[1:]
    seen = state.get("rows")
    if seen is None:  # first run: start from now
        state.set("rows", len(data))
        return {"new": 0}
    new = data[seen:]
    for row in new:
        rec = dict(zip(header, row + [""] * (len(header) - len(row))))
        lines = [f"{c}: {rec.get(c, '')}" for c in COLUMNS if rec.get(c)]
        tg("sendMessage", chat_id=CHAT_ID, text=f"🆕 New row in {TAB}\n" + "\n".join(lines))
    state.set("rows", len(data))
    return {"new": len(new)}

FAQ

Common questions

Does it work with Google Forms responses?
Yes. Point it at the responses sheet linked to your form and each submission becomes a Telegram message.
What if someone deletes a row?
The row count goes down and the next check starts counting from there. Ask your assistant to track a unique ID column instead if rows are often deleted or sorted.
Can it send to a group?
Yes. Use the group's chat ID instead of your own and add the bot to the group, so the whole team sees new rows.
What permissions does it need?
Sheets read-only (spreadsheets.readonly); bot token. Nothing else in your accounts is used.
Does it need AI?
No. It runs without AI, so it doesn't use your plan's AI allowance.
How many runs does it use?
One run each time it checks. Checks that find nothing new 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 Telegram message when a Google Sheet gets a new row” from your assistant

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