Send Telegram Notifications via API

Why Use an API for Telegram Notifications?

Telegram has become one of the most popular platforms for receiving real-time alerts. With over 800 million active users, it offers instant delivery, rich formatting, and a bot ecosystem that makes it ideal for automated notifications. Developers use Telegram to monitor servers, track sales, receive form submissions, and stay on top of anything that matters.

The problem is that working directly with the Telegram Bot API requires managing bot tokens, handling chat IDs, constructing HTTP requests with specific payload formats, and dealing with rate limits. When you also need to send notifications through Email, Slack, or Discord, you end up maintaining multiple integrations with different authentication methods and payload structures.

One-Ping removes that complexity. You configure your Telegram bot once in the dashboard, and then every notification is a single API call that works the same way across all your channels.

How One-Ping Simplifies Telegram Notifications

Instead of dealing with the Telegram Bot API directly, One-Ping gives you a unified endpoint that handles all the heavy lifting. Here is what you get out of the box:

Code Examples

Sending a Telegram notification through One-Ping takes just a few lines of code. Below are examples in cURL, JavaScript, and Python that show how straightforward the process is.

cURL

# Send a notification to Telegram
curl -X POST https://api.one-ping.com/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "CHAT_ID_OR_USERNAME",
    "message": "New order received: #1042 - $149.00",
    "channels": ["telegram"]
  }'

JavaScript (Node.js / Browser)

// Send a Telegram notification with One-Ping
const response = await fetch('https://api.one-ping.com/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: 'CHAT_ID_OR_USERNAME',
    message: 'New order received: #1042 - $149.00',
    channels: ['telegram']
  })
});

const data = await response.json();
console.log(data);
// { "success": true, "id": "msg_abc123", "channels": { "telegram": "delivered" } }

Python

import requests

response = requests.post(
    'https://api.one-ping.com/send',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'to': 'CHAT_ID_OR_USERNAME',
        'message': 'New order received: #1042 - $149.00',
        'channels': ['telegram']
    }
)

print(response.json())

Want to send to multiple channels at once? Just add more entries to the channels array. For instance, ["telegram", "email", "slack"] delivers the same message to all three with a single request. Learn more in our multi-channel notifications guide.

Setup Steps

Getting Telegram notifications working with One-Ping takes less than five minutes. Follow these steps to configure everything from scratch.

Common Use Cases for Telegram Notifications

Telegram is exceptionally well-suited for notifications that need to be seen immediately. Here are the most popular ways developers use One-Ping with Telegram:

• E-commerce order alerts: Get a Telegram ping every time someone places an order. Include the order number, amount, and customer name so you can stay on top of sales without constantly checking your store dashboard. Explore more in our e-commerce use case guide.
• Server and uptime monitoring: Connect your monitoring tools to One-Ping and receive Telegram alerts when a server goes down, CPU usage spikes, or disk space runs low. Pair it with Slack notifications for team-wide visibility.
• Form submission alerts: Receive a Telegram message every time someone fills out a contact form, survey, or lead generation form on your website.
• CI/CD pipeline results: Get notified when your builds pass or fail. One-Ping integrates with tools like n8n to automate the entire workflow without writing code.
• Financial and stock alerts: Monitor price changes, trading signals, or payment confirmations and send them straight to your Telegram chat.
• Security alerts: Receive instant notifications about failed login attempts, new device logins, or suspicious activity on your applications.

One-Ping vs. Direct Telegram Bot API

You can absolutely send Telegram messages directly through the Bot API. But when you are building a product that needs notifications across multiple channels, managing each API separately becomes a maintenance burden. Here is how the two approaches compare:

If Telegram is your only channel and you need nothing else, the Bot API works fine. But the moment you add Email or Slack to the mix, One-Ping saves you significant development and maintenance time. Check our comparison with Twilio to see how we stack up against other providers.

Frequently Asked Questions

Do I need to run my own Telegram bot server?

No. One-Ping handles the communication with Telegram's servers. You just need to create a bot through BotFather and provide us the token. There is no need to set up webhooks or run a polling server.

Can I send to Telegram groups and channels?

Yes. Any chat ID that your bot has access to will work, whether it is a private chat, a group chat, or a public channel. Just make sure your bot is a member of the group or has admin rights in the channel.

Is there a limit on message length?

Telegram supports messages up to 4,096 characters. One-Ping will pass your message through as-is. If your message exceeds that limit, the Telegram API will reject it, and One-Ping will report the error in your delivery logs.

Can I format messages with Markdown or HTML?

Yes. One-Ping supports Telegram's Markdown and HTML formatting modes. You can include bold text, links, code blocks, and more. Specify the parse mode in your request payload to enable formatting.

What happens if Telegram is down?

One-Ping retries delivery up to 3 times with exponential backoff. If the message still cannot be delivered, it is marked as failed in your logs, and you can configure a webhook callback to be notified of delivery failures.

How fast are messages delivered?

One-Ping processes your request in under 200ms. Telegram delivery is nearly instant after that, so most messages arrive within 1-2 seconds of your API call.