Telegram Integration

Connect Dunmore to Telegram to receive payment notifications via a Telegram bot.

Setup

1. Create a Telegram bot via @BotFather and get your bot token
2. Add the bot to your group chat or start a DM with it
3. Get the chat ID (use https://api.telegram.org/bot<token>/getUpdates after sending a message)
4. Add a Telegram connector in the Dunmore console

Supported Events

Event	Message
payment.settled	Payment amount, currency, endpoint, payer wallet
payment.failed	Amount, failure stage, error code
customer.first_payment	New customer wallet and first payment amount
customer.milestone	Customer wallet, milestone reached, total spend

Messages use Markdown formatting for readability.

Configuration

{
  "type": "telegram",
  "config": {
    "botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v...",
    "chatId": "-1001234567890"
  },
  "eventTypes": ["payment.settled", "payment.failed"]
}

API Example

curl -X POST https://api.dunmore.xyz/api/projects/{projectId}/connectors \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "telegram",
    "config": {
      "botToken": "YOUR_BOT_TOKEN",
      "chatId": "YOUR_CHAT_ID"
    },
    "eventTypes": ["payment.settled", "payment.failed", "customer.first_payment"]
  }'