Custom Telegram Bot

Available ActionsEach successful request consumes credits as outlined below.

send_message^2crsend_photo^2crsend_document^2crget_updates^2crlist_known_chat_ids

Details

Build your own branded Telegram bot and connect it to your AI agent for fully customizable two-way communication. Create a bot through Telegram's BotFather, choose your own name and profile picture, define custom commands, then connect it here. Send and receive text messages, share photos and documents, track unread conversations with smart cursors, and create interactive button menus — all under your own brand identity.

Use Cases

Build a branded customer support bot on Telegram, Send business notifications under your own bot identity, Receive and respond to inbound customer messages, Share photos and documents from your branded bot, Create interactive menus with inline keyboard buttons, Run automated conversational workflows, Collect leads and feedback through your own Telegram bot, Internal team communication with a custom bot

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": "69dabe30448c9686fae464e3",
    "parameters": {
      "action": "send_message",
      "chat_id": "example_chat_id",
      "text": "example_text"
    }
  }'

import requests
import json

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

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

data = {
    "product_id": "69dabe30448c9686fae464e3",
    "parameters": {
        "action": "send_message",
        "chat_id": "example_chat_id",
        "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: "69dabe30448c9686fae464e3",
  parameters: {
    "action": "send_message",
    "chat_id": "example_chat_id",
    "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: "69dabe30448c9686fae464e3",
  parameters: {
    "action": "send_message",
    "chat_id": "example_chat_id",
    "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:69dabe30448c9686fae464e3
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/69dabe30448c9686fae464e3/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(5)

send_message^2cr7 params(2 required)

Send a text message to a Telegram user, group, or channel your bot can access.

chat_idrequiredstring

Telegram chat ID (numeric) or @username. Required.

textrequiredstring

Message text (max 4096 characters). Required.

parse_modestring

Text formatting mode

Values:

HTMLMarkdownMarkdownV2

reply_markupobject

Inline keyboard markup for interactive buttons

disable_notificationboolean

Send silently without sound

protect_contentboolean

Prevent forwarding/saving

message_thread_idinteger

Topic ID for group chats with topics

send_photo^2cr8 params(1 required)

Send a photo via URL/file_id/base64 or File Manager file_id.

chat_idrequiredstring

Telegram chat ID (numeric) or @username. Required.

photostring

Photo URL, Telegram file_id, or base64 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

Values:

HTMLMarkdownMarkdownV2

disable_notificationboolean

Send silently without sound

protect_contentboolean

Prevent forwarding/saving

message_thread_idinteger

Topic ID for group chats with topics

send_document^2cr9 params(1 required)

Send a document via URL/file_id/base64 or File Manager file_id.

chat_idrequiredstring

Telegram chat ID (numeric) or @username. Required.

documentstring

Document URL, Telegram file_id, or base64 data.

document_file_idstring

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

filenamestring

Filename required for base64 document payloads.

captionstring

Document caption (max 1024 characters)

parse_modestring

Caption formatting mode

Values:

HTMLMarkdownMarkdownV2

disable_notificationboolean

Send silently without sound

protect_contentboolean

Prevent forwarding/saving

message_thread_idinteger

Topic ID for group chats with topics

get_updates^2cr10 params

Poll incoming updates with persisted cursor and optional media ingestion into File Manager.

offsetinteger

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

limitinteger

Max 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

Update types to receive

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

list_known_chat_ids0 params

List known chat IDs discovered by get_updates for this BYO bot scope.

No parameters for this action.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Custom Telegram Bot

Two-way messaging through your own Telegram bot connection.

Setup

Create your Telegram bot
Connect the required Telegram credential in AgentPMT
Send /start to your bot in Telegram
Use get_updates to read inbound messages and reply

Actions

`send_message`

Required: chat_id, text

`send_photo`

Required: chat_id Provide one of:

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

`send_document`

Required: chat_id 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

`list_known_chat_ids`

Returns chat IDs seen by this BYO bot within this budget scope. Use get_updates first to discover chats.

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

Your Bot, Your Brand, Your Rules

Custom Telegram Bot lets you create your own branded Telegram bot and connect it to your AI agent for fully customizable two-way communication. Everything runs under your own bot identity — your name, your profile picture, your commands.

Getting Started

Step 1: Create Your Bot

Open Telegram and message @BotFather
Send /newbot and follow the prompts
Choose a display name (e.g. "Acme Support Bot")
Choose a username ending in bot (e.g. acme_support_bot)
Copy the bot token that BotFather gives you

Step 2: Customize Your Bot (Optional)

Message @BotFather with these commands to brand your bot:

/setdescription — what users see before starting the bot
/setabouttext — the bot's About section
/setuserpic — upload your bot's profile photo
/setcommands — define slash commands your users can use

Step 3: Connect Your Token

In AgentPMT, add the bot token as a Telegram Bot Token connection. The platform securely stores your token and injects it automatically at runtime — you never need to paste it into messages or share it.

Step 4: Activate Your Bot

Search for your bot's username in Telegram
Tap Start
Send a test message to make sure everything is working

What You Can Do

Full branding control — your own bot name, profile photo, description, and custom commands
Send and receive text messages — real-time two-way conversations under your brand
Share photos and documents — send images, PDFs, and any file type directly in chat
Track unread messages — a smart cursor keeps track of what's been read so you never miss a message
Interactive buttons — inline keyboard menus for quick user responses and navigation
Rich formatting — HTML, Markdown, or MarkdownV2 support for beautiful messages
Silent delivery — send messages without notification sounds when appropriate

Perfect For

Branded customer support and helpdesk bots
Business notification and alert systems
Internal team communication channels
Lead capture and sales outreach bots
Custom conversational AI experiences
Feedback collection and survey bots

Custom Bot vs. Instant Messenger

If you don't need your own branded bot and just want to start chatting right away, check out Telegram Instant Messenger — it uses a shared pre-configured bot with zero setup. Choose Custom Telegram Bot when you want full control over your bot's identity and branding.

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.

Custom Telegram Bot

Description