{"uid":"cap_rW5e2j2AUEacGoFJ_2WSB","slug":"telagent-telegram-message-delivery-for-ai-agents-f43d6442","name":"TelAgent — Telegram Message Delivery for AI Agents","description":"Pay-per-message Telegram delivery for AI agents. No accounts, no API keys — just x402.","url":"https://agentcash-proxy.onrender.com/api/v1/telegram/send","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","minLength":1,"description":"Telegram chat ID, numeric user ID, or @username (must have /start'd the bot first)"},"message":{"type":"string","minLength":1,"description":"Message text"}}},"responseSchema":{"type":"json","example":{"cost":"0.01 USDC","success":true,"message_id":123456,"payment_verified":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sL65tlzuV8HH1q0jfW4K_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Sends a Telegram message on behalf of an AI agent via pay-per-use x402 micropayment, with no API keys or account setup required.","exampleAgentPrompt":"Send a Telegram message to chat ID 987654321 saying 'Your order has shipped and will arrive tomorrow!' — use the pay-per-message Telegram delivery so I don't need to set up a bot.","exampleUseCases":[{"title":"Agent alert for completed task","prompt":"When my data pipeline finishes, send a Telegram message to chat ID 112233445 saying 'Pipeline complete — 10,000 rows processed successfully.' Use the pay-per-message delivery so I don't need a bot account."},{"title":"E-commerce order status notification","prompt":"Notify the customer on Telegram — their chat ID is 556677889 — that their package has been delivered. Message should say 'Your order #4821 was delivered today. Thanks for shopping with us!'"},{"title":"Autonomous agent status update","prompt":"My agent just finished its nightly report. Send a Telegram message to chat ID 223344556 with the text: 'Nightly summary done: 47 new leads found, 3 flagged for review. See dashboard for details.'"}],"resultDescription":"A JSON object confirming the delivery with fields: success (boolean), message_id (the Telegram message ID assigned to the sent message), payment_verified (boolean confirming the 0.01 USDC micropayment was accepted), and cost ('0.01 USDC').","failureModes":["Invalid or inaccessible chat ID returns a failed delivery status","Insufficient USDC payment causes payment_verified to be false and message not sent","Telegram API downtime may cause delivery failure","Message content violating Telegram policies may be rejected","Network timeout from the proxy service on Render may cause intermittent failures"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to send Telegram messages without managing a Telegram bot account or API keys, and when pay-per-message micropayment billing via x402/USDC is acceptable or preferred. Ideal for autonomous agents that send infrequent notifications and want zero-setup messaging infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:39:12.374Z","isFirstParty":false}