Custom Telegram Bot by Apoth3osis

Name: Custom Telegram Bot
Brand: Apoth3osis
SKU: 69dabe30448c9686fae464e3
Price: 0.02 USD
Availability: InStock

Custom Telegram Bot

Function

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

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.

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": "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.

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

About this Product

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.

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 69dabe30448c9686fae464e3 ("Custom Telegram Bot"). Then call the same tool with action 'call_tool', tool_id 69dabe30448c9686fae464e3, 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.

Custom Telegram Bot

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Actions(5)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Custom Telegram Bot

Setup

Actions

`send_message`

`send_photo`

`send_document`

`get_updates`

`list_known_chat_ids`

File Manager Flows

Shared Optional Params (send actions)

About this Product

Your Bot, Your Brand, Your Rules

Getting Started

Step 1: Create Your Bot

Step 2: Customize Your Bot (Optional)

Step 3: Connect Your Token

Step 4: Activate Your Bot

What You Can Do

Perfect For

Custom Bot vs. Instant Messenger

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

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