How to Set Up Telegram Alerts for Every Crypto Payment You Receive

Why Telegram?

Telegram bots deliver messages instantly to your phone or team chat. Unlike email, Telegram notifications arrive in seconds and don't end up in spam. For payment monitoring, it's the most reliable real-time channel available.

Creating a Telegram Bot

1. Open Telegram and search for @BotFather
2. Send /newbot and follow the prompts
3. Copy the bot token (format: 123456789:AAFxxxxxxx)
4. Start a chat with your new bot to get your Chat ID

To get your Chat ID, send any message to your bot then call:

curl https://api.telegram.org/bot<TOKEN>/getUpdates

The chat.id field in the response is your Chat ID.

Configuring Paychainly

Go to the admin panel → Infrastructure → Notifications. Enter your bot token and chat ID. Click "Test Notification" to verify the connection.

What Triggers Alerts

• Large payments: any deposit over your configured USDT threshold (default 500 USDT)
• Service startup and shutdown
• Uncaught errors and crashes
• Gas wallet balance low
• Block pipeline queue overflow (> 500 jobs waiting)

Custom Payment Alerts in Your App

Your webhook endpoint can forward notifications to any Telegram chat:

async function notifyTelegram(txHash, amount, userId) {
  await fetch(`https://api.telegram.org/bot${BOT_TOKEN}/sendMessage`, {
    method: 'POST',
    body: JSON.stringify({
      chat_id: CHAT_ID,
      text: `💰 New payment!\nAmount: ${amount} USDT\nUser: ${userId}\nTx: ${txHash}`,
      parse_mode: 'HTML',
    }),
  });
}