Independent, unofficial connector for Telegram. Not affiliated with, endorsed by, or sponsored by Telegram. "Telegram" is a trademark of its owner, used only to identify the service this connector works with.

Scripts for a Telegram bot, against the Telegram Bot API (https://api.telegram.org/bot<token>/<method>). Send text, media, locations, contacts, and polls; edit, delete, forward, copy, and pin messages; and resolve the chats, members, and files a bot interacts with. Every script acts as the bot — the bot must be a member of any chat it messages, and a user must message the bot first before the bot can DM them.

When to use this

An agent needs a Telegram bot to send a message, photo, document, video, audio, location, contact, or poll to a chat.
An agent needs to manage messages the bot sent — edit, delete, forward, copy, pin, or unpin.
An agent needs to resolve a chat or member — find a chat_id (via listRecentChats), confirm a chat (getChat), check a member's role (getChatMember), or list admins.

Setup

This is an agentskills.io skill.

If the connector has not been installed as a skill yet, install it first with npx skills add zapier/connectors --skill telegram (or your harness's own skill-install mechanism), then continue here. Installing the skill copies these files, not dependencies. Before running the CLI, a local MCP server, or zapier-sdk auth commands, run npm install --omit=dev here once. Importing the published package as a dependency in your own project instead? That npm install already resolves everything — see references/use-as-sdk.md.

The connector runs on Node.js 22.18+. Pick the reference that matches how you're running it, and load it before doing anything else: