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.

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

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

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

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

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

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

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.

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

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 697c1191a08dcbe06d11b98c ("Telegram Instant Messenger"). Then call the same tool with action 'call_tool', tool_id 697c1191a08dcbe06d11b98c, and the parameters needed for my request.

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

Use Cases

Actions(4)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

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?

Workflows Using This Tool

Gmail Inbox Triage to Telegram - Urgency and Intent

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