How to Send Telegram Notifications from Your App

Why Use Telegram for App Notifications?

Telegram is one of the most popular messaging platforms for developers and technical teams. With over 800 million active users, it offers instant delivery, rich formatting support, and a powerful Bot API that makes it ideal for application notifications. Unlike email, Telegram messages are read almost immediately, with open rates exceeding 80%.

Whether you need to monitor server health, track new user signups, receive payment confirmations, or alert your team about errors, Telegram notifications provide a fast and reliable channel. And with One-Ping, you can set it up in minutes without dealing with the Telegram Bot API directly.

Step-by-Step Setup

Code Examples

Here are complete, copy-paste-ready examples for sending Telegram notifications through One-Ping. Replace YOUR_API_KEY with your actual API key and adjust the chat ID as needed.

cURL

# Send a Telegram notification with One-Ping
curl -X POST https://api.one-ping.com/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "New order received: #1234 - $49.99",
    "channels": ["telegram"],
    "recipient": "CHAT_ID"
  }'

JavaScript (Node.js / Browser)

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({
    message: 'New order received: #1234 - $49.99',
    channels: ['telegram'],
    recipient: 'CHAT_ID'
  })
});

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

Python

import requests

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

print(response.json())
# {'success': True, 'messageId': 'msg_abc123'}

Sending to Groups and Channels

One-Ping supports sending Telegram notifications to individual users, groups, and public channels. For groups, use the group chat ID (starts with a negative number) as the recipient. For public channels, you can use the channel username prefixed with @ (e.g., @mychannel). Make sure your bot is added as an administrator in the group or channel with permission to send messages.

Formatting Your Messages

Telegram supports rich text formatting through HTML and Markdown. When sending through One-Ping, you can include basic HTML tags in your message body for formatted notifications:

• <b>bold</b> for bold text
• <i>italic</i> for italic text
• <code>inline code</code> for inline code
• <pre>code block</pre> for code blocks
• <a href="url">link text</a> for hyperlinks

This makes Telegram particularly useful for technical alerts where you want to include server names, error codes, or clickable links to your dashboard. For example, an error alert could read: <b>Error Alert</b>\nServer: <code>prod-web-01</code>\nStatus: 503\n<a href="https://dashboard.example.com">View details</a>.

Common Use Cases

Developers and teams use Telegram notifications with One-Ping for a wide range of purposes. Here are some of the most popular use cases:

• E-commerce alerts: Receive instant notifications when a new order comes in, a payment fails, or a product goes out of stock.
• Server monitoring: Get alerted when your server goes down, CPU usage spikes, or disk space runs low.
• Error tracking: Send application errors and exceptions directly to a Telegram group where your dev team can see them.
• Form submissions: Know the moment someone fills out your contact form or signup form.
• CI/CD pipelines: Notify your team when builds pass or fail, or when deployments complete.
• Security alerts: Get notified about suspicious login attempts, API abuse, or unusual activity patterns.

Troubleshooting

Bot not sending messages?

The most common issue is that the user has not started a conversation with the bot. In Telegram, a bot cannot initiate a conversation; the user must send the first message. Ask your recipients to open a chat with the bot and press "Start" before you send notifications.

Wrong chat ID?

Double-check that you are using the correct chat ID. Individual user IDs are positive numbers, while group IDs are negative. If you recently migrated a group to a supergroup, the chat ID will have changed. Use the getUpdates endpoint to fetch the latest chat ID.

Rate limits?

Telegram has built-in rate limits: roughly 30 messages per second to different chats, and 1 message per second to the same chat. One-Ping automatically handles rate limiting and queuing for you, so you do not need to worry about this for most use cases.