Telegram Instant Messenger

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

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.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:697c1191a08dcbe06d11b98c
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/697c1191a08dcbe06d11b98c/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

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

Usage Instructions

Usage guidance provided directly by the developer for this product.

Telegram Instant Messenger

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

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

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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Telegram Instant Messenger

Description