← All docs

Telegram Bot — 2 Minute Setup

Get instant alerts in Telegram for every invoice, payment and webhook.

You'll get notifications for
  • ✅ Invoice paid
  • 🧾 Invoice created
  • ⌛ Invoice expired
  • 🚫 Invoice cancelled
  • ⚠️ Webhook delivery failed
  • 🛑 System errors
1

Create your bot

Open @BotFather in Telegram and send this command:

/newbot

BotFather will ask for:

  • A name — anything, e.g. "My Shop Alerts"
  • A username — must end with bot, e.g. myshop_alerts_bot

When done, BotFather sends you a bot token that looks like this:

123456789:ABCdefGhIJKlmNoPQRstuVWXyz1234567

📋 Copy it and keep it safe — you'll paste it in Step 3.

2

Get your Chat ID

Open @userinfobot in Telegram and press Start.

It will reply with your account info. Copy the Id number (a long number like):

6728122351

⚡ Important: After getting your Chat ID, open your new bot (search its username from Step 1) and send it any message — even just hi. Telegram blocks bots from messaging you until you message them first.

3

Paste them in Settings

Go to your dashboard Settings → Telegram notifications and paste:

  • Bot token — from Step 1
  • Chat ID — from Step 2

Toggle Enabled on, hit Save, then click Send test.

If you see a test message land in your Telegram — you're done. 🎉

Open Settings

Troubleshooting

Test fails with "chat not found" or "Forbidden"
You haven't messaged your bot yet. Open your bot's chat (the one you made in Step 1, not @BotFather) and send it any message. Then click Send test again.
"Unauthorized" or "401" error
Your bot token is wrong. Go back to @BotFather, send /mybots, pick your bot, choose API Token and copy it fresh.
I want notifications in a group chat instead

1. Add your bot to the group as a member.

2. Send any message in the group mentioning the bot.

3. Open this URL in your browser (replace YOUR_TOKEN):

https://api.telegram.org/botYOUR_TOKEN/getUpdates

4. Look for "chat":{"id": -100123... — that negative number is your group Chat ID. Use it in Step 3.

Nothing arrives even though test works
Make sure Enabled is on in Settings. If you only want certain events (e.g. just payments), you can change that in the same panel.
← Back to API docsOpen Settings →