Telegram Instant Messenger by Apoth3osis

Name: Telegram Instant Messenger
Brand: Apoth3osis
SKU: 697c1191a08dcbe06d11b98c
Price: 0.02 USD
Availability: InStock

Telegram Instant Messenger

Connector

Available ActionsEach successful request consumes credits as outlined below.

send_message^2crsend_photo^2crsend_document^2crget_updates^2cr

Details

Two-way Telegram messaging through the shared @AgentPMT_bot with budget-scoped chat binding. If not connected, the tool returns `status: connection_required` with `chat_url`, `otp_code`, and `start_command` (for example `/start 123456`). Open `chat_url`, send `start_command` exactly, then send any follow-up message to bind. After binding, send/receive text, photos, and documents with unread cursor controls and File Manager ingestion.

Workflows Using This Tool

2 / 3

Workflow

Saves ~45 min

AI Gmail Inbox Classifier & Auto-Archive with Hourly Telegram Alerts

Automatically organize and clean up your Gmail inbox every hour, hands-free. This AI email automation reads each new message, classifies it into one of seven of your own Gmail labels (across the "00 Automated" and "00 Human" label groups), applies the right label, and archives it out of your inbox — so you reach inbox zero without lifting a finger. The moment a message is tagged Important, you get an instant Telegram alert with a direct link to that email, so urgent messages never slip through. Ideal for busy professionals and teams who want smart email sorting, automated inbox triage, and real-time Telegram notifications for the emails that actually matter.

Use Cases

Instant two-way Telegram chat with zero setup, Send alerts and notifications to users or teams, Customer support and helpdesk automation, Collect feedback and survey responses via chat, Share reports and documents through Telegram, Build conversational AI workflows on Telegram, Send photos and media to users, Prototype Telegram automations quickly

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

Actions(4)

send_message^2cr6 params(1 required)

Send a text message to the budget's bound Telegram chat (shared AgentPMT bot).

textrequiredstring

Message text (max 4096 characters). Required.

parse_modestring

Text formatting mode: HTML, Markdown, or MarkdownV2

Values:

HTMLMarkdownMarkdownV2

reply_markupobject

Inline keyboard markup for interactive buttons.

disable_notificationboolean

Send message silently (users receive without sound). Default: false

protect_contentboolean

Protect content from forwarding and saving. Default: false

message_thread_idinteger

Topic ID for group chats with topics enabled (optional)

send_photo^2cr7 params

Send a photo to the budget's bound Telegram chat via URL/file_id/base64 or File Manager file_id.

photostring

Photo as a URL, Telegram file_id, or base64-encoded data.

photo_file_idstring

AgentPMT File Manager file_id to send as photo (alternative to photo).

captionstring

Photo caption (max 1024 characters)

parse_modestring

Caption formatting mode: HTML, Markdown, or MarkdownV2

Values:

HTMLMarkdownMarkdownV2

disable_notificationboolean

Send message silently (users receive without sound). Default: false

protect_contentboolean

Protect content from forwarding and saving. Default: false

message_thread_idinteger

Topic ID for group chats with topics enabled (optional)

send_document^2cr8 params

Send a document to the budget's bound Telegram chat via URL/file_id/base64 or File Manager file_id.

documentstring

Document as a URL, Telegram file_id, or base64-encoded data.

document_file_idstring

AgentPMT File Manager file_id to send as document (alternative to document).

filenamestring

Document filename. Required when sending base64 document data.

captionstring

Document caption (max 1024 characters)

parse_modestring

Caption formatting mode: HTML, Markdown, or MarkdownV2

Values:

HTMLMarkdownMarkdownV2

disable_notificationboolean

Send message silently (users receive without sound). Default: false

protect_contentboolean

Protect content from forwarding and saving. Default: false

message_thread_idinteger

Topic ID for group chats with topics enabled (optional)

get_updates^2cr10 params

Fetch incoming updates with persisted cursor and optional media ingestion into File Manager. Returns deep link binding instructions when budget is not yet connected.

offsetinteger

Explicit Telegram update_id offset (absolute). Overrides cursor-derived start when provided.

limitinteger

Maximum number of updates to retrieve (1-100). Default: 100

Default: 100

Range: 1 - 100

timeoutinteger

Long polling timeout in seconds (0-60). Default: 30

Default: 30

Range: 0 - 60

allowed_updatesarray

Filter update types to receive, e.g. ['message','callback_query']

Array of: string

unread_onlyboolean

When true, return only updates newer than the stored read cursor.

cursor_offsetinteger

Relative offset from cursor-derived start. Negative values look older; positive values skip newer.

mark_as_readboolean

Persist highest unread update_id as read. Defaults to true when unread_only=true.

ingest_files_to_managerboolean

When true, download Telegram photo/document files from returned updates and upload them into AgentPMT File Manager.

ingest_max_filesinteger

Maximum number of files to ingest from one get_updates response.

Default: 10

Range: 1 - 25

ingest_expiration_daysinteger

File Manager expiration in days for ingested files (1-7).

Default: 7

Range: 1 - 7

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "697c1191a08dcbe06d11b98c",
    "parameters": {
      "action": "send_message",
      "text": "example_text"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "697c1191a08dcbe06d11b98c",
    "parameters": {
        "action": "send_message",
        "text": "example_text"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697c1191a08dcbe06d11b98c",
  parameters: {
    "action": "send_message",
    "text": "example_text"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "697c1191a08dcbe06d11b98c",
  parameters: {
    "action": "send_message",
    "text": "example_text"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

Recommended

Credit-Based Access Using AgentAddress

AgentAddress is preferred when an autonomous agent needs persistent file access, stored platform state, or maximum tool use ability across repeated calls.

Open Credit-Based Access Using AgentAddress

Direct x402 Payment

Use direct x402 for independent one-off tool calls that do not require shared files or stored platform state.

Accepted public payments

Stablecoin: USDC
Chains: Base, Arbitrum, Optimism, Polygon, and Avalanche

Direct x402 payments are not enabled for this product; use AgentAddress credit access instead.

Product Skill Package

This product has a published Agent Skill package. Install it when an autonomous agent needs product-specific operating instructions in its local skill registry.

Download SKILL.md View package source OpenClaw listing

OpenClaw install

Copied to clipboard

skills.sh install

Copied to clipboard

Usage Instructions

Usage guidance provided directly by the developer for this product.

Telegram Instant Messenger

Two-way messaging through the shared AgentPMT Telegram bot.

User Setup

The shared tool binds each budget to one Telegram user/chat via a short 6-digit OTP.

Call any action (send_message, send_photo, send_document, or get_updates)
The tool checks whether the budget is already bound
If not bound, it returns status: connection_required with chat_url, otp_code, and start_command
User opens chat_url and sends start_command exactly (example: /start 123456)
User sends any follow-up message in the same chat
On every request while unbound, the tool checks Telegram updates for a matching /start <otp_code> and binds immediately when found

Shared Bot Scope

For the shared AgentPMT bot, each budget is scoped to one Telegram chat.

chat_id is not accepted in shared-tool requests
Outbound actions automatically use the stored scoped chat from the budget binding
get_updates automatically filters to the bound chat/user once connected

Actions

`send_message`

Required: text

`send_photo`

Provide one of:

photo (URL, Telegram file_id, or base64)
photo_file_id (AgentPMT File Manager file_id)

`send_document`

Provide one of:

document (URL, Telegram file_id, or base64)
document_file_id (AgentPMT File Manager file_id)

If using base64 document, filename is required.

`get_updates`

Optional:

offset, limit (1-100), timeout (0-60), allowed_updates
unread_only, cursor_offset, mark_as_read
ingest_files_to_manager, ingest_max_files, ingest_expiration_days

When not yet connected, this action returns status: connection_required with chat_url, otp_code, and start_command.

File Manager Flows

Send from File Manager: use photo_file_id or document_file_id
Save inbound Telegram media: set ingest_files_to_manager: true on get_updates
Ingested uploads are returned in ingested_files with new File Manager file_id values

Shared Optional Params (send actions)

parse_mode, caption, reply_markup, disable_notification, protect_content, message_thread_id

About this Product

Start Chatting on Telegram in Seconds

Telegram Instant Messenger gives you a ready-to-use two-way communication channel between your AI agent and anyone on Telegram — no bot creation, no API keys, and no technical setup required.

How It Works

Open Telegram on your phone or computer and search for @AgentPMT_bot
Tap Start — that's it, you're connected
Send a message and your agent can read and respond instantly

Share the bot link with anyone you want to communicate with. As soon as they tap Start and send a message, your agent has their chat ID and can reply.

What You Can Do

Send and receive text messages — have real-time two-way conversations with users through Telegram
Share photos and documents — send images, PDFs, spreadsheets, and any file type directly in chat
Track unread messages — a smart cursor keeps track of what's been read so your agent never misses a message
Add interactive buttons — create inline keyboard menus for quick user responses and navigation
Format messages beautifully — use HTML, Markdown, or MarkdownV2 for rich text formatting
Send silently — deliver messages without notification sounds when needed

Perfect For

Quick prototyping of Telegram-based workflows
Customer support and helpdesk automation
Sending alerts, reminders, and notifications to users or teams
Collecting feedback and survey responses through conversational chat
Building interactive AI experiences on Telegram
Sharing reports, receipts, and documents with customers

No Setup, No Hassle

Unlike custom bots that require creating a bot with BotFather and managing tokens, Telegram Instant Messenger uses a shared pre-configured bot that's ready from the moment you activate the tool. If you need your own branded bot with a custom name and profile picture, check out Custom Telegram Bot instead.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 697c1191a08dcbe06d11b98c ("Telegram Instant Messenger"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Telegram Instant Messenger

Available ActionsEach successful request consumes credits as outlined below.

Details

Workflows Using This Tool

AI Gmail Inbox Classifier & Auto-Archive with Hourly Telegram Alerts

Use Cases

Dynamic MCP Setup

30 Second Setup

Hosted Streamable HTTPS

Config Example

Actions(4)

Credit-Based Access Using AgentAddress

Direct x402 Payment

Product Skill Package

Usage Instructions

Telegram Instant Messenger

User Setup

Shared Bot Scope

Actions

`send_message`

`send_photo`

`send_document`

`get_updates`

File Manager Flows

Shared Optional Params (send actions)

About this Product

Start Chatting on Telegram in Seconds

How It Works

What You Can Do

Perfect For

No Setup, No Hassle

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Related Content

Business Automation Gets a Two-Way Telegram Channel

Build a Gmail-to-Telegram AI Workflow in 60 Seconds

Looking for help integrating AI into your business? Set up a free consultation.