Telegram Bot Integration

The M.O.N.K.Y Telegram Bot provides a seamless way to interact with your Solana wallet directly from Telegram. Our bot API allows developers to integrate wallet functionality, notifications, and user interactions.

Bot Information

Bot Username: @monky_os_bot
Bot API Endpoint: https://api.monkywallet.com/v1/telegram

Getting Started

1. Start the Bot

Begin by starting a conversation with our bot:

Start Chat

Click here to start chatting with M.O.N.K.Y Bot

2. Available Commands

/start - Initialize Bot

Initializes the bot and creates your user profileUsage: /startResponse: Welcome message with available commands

/wallet - Wallet Operations

Access wallet-related functionsUsage: /wallet [action]Actions:

balance - Check wallet balance
address - Get wallet address
new - Create new wallet

Example: /wallet balance

/send - Send Transaction

Send SOL or tokens to another addressUsage: /send [amount] [token] [address]Example: /send 0.1 SOL 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

/price - Token Prices

Get real-time token pricesUsage: /price [token]Example: /price SOL

/stake - Staking Operations

Manage SOL stakingUsage: /stake [action] [amount]Actions:

delegate [amount] - Stake SOL
undelegate [amount] - Unstake SOL
rewards - Check staking rewards

Example: /stake delegate 1

/notifications - Alert Settings

Configure transaction and price alertsUsage: /notifications [action]Actions:

on - Enable notifications
off - Disable notifications
settings - View current settings

/help - Get Help

Display help information and support optionsUsage: /help [topic]Topics:

commands - List all commands
security - Security best practices
api - API access information

Bot API Integration

Authentication

To integrate with the bot programmatically, you’ll need a bot token:

Request Bot Access

Send /api command to the bot to request developer access

Verify Identity

Complete identity verification process

Receive Token

Get your bot integration token via secure message

Send Message API

Send messages to users via the bot:

POST /v1/telegram/send-message
Content-Type: application/json
Authorization: Bearer YOUR_BOT_TOKEN

{
  "chat_id": "USER_TELEGRAM_ID",
  "message": "Your transaction has been confirmed!",
  "parse_mode": "Markdown"
}

Response:

{
  "success": true,
  "data": {
    "message_id": 12345,
    "sent_at": "2024-10-24T07:37:42Z"
  }
}

Execute Command API

Execute bot commands programmatically:

POST /v1/telegram/execute-command
Content-Type: application/json
Authorization: Bearer YOUR_BOT_TOKEN

{
  "chat_id": "USER_TELEGRAM_ID",
  "command": "/wallet balance",
  "silent": false
}

Response:

{
  "success": true,
  "data": {
    "command": "/wallet balance",
    "response": "💰 **Wallet Balance**\nSOL: 5.24\nUSDC: 1,250.00",
    "executed_at": "2024-10-24T07:37:42Z"
  }
}

User Registration API

Check if a user is registered with the bot:

GET /v1/telegram/user/{telegram_id}
Authorization: Bearer YOUR_BOT_TOKEN

Response:

{
  "success": true,
  "data": {
    "telegram_id": "123456789",
    "username": "@user123",
    "registered_at": "2024-10-20T10:30:00Z",
    "wallet_connected": true,
    "notifications_enabled": true
  }
}

Webhook Integration

Set up webhooks to receive bot events in real-time:

Configuration

POST /v1/telegram/webhook
Content-Type: application/json
Authorization: Bearer YOUR_BOT_TOKEN

{
  "url": "https://your-app.com/webhook/telegram",
  "events": [
    "message.received",
    "command.executed", 
    "user.registered",
    "wallet.connected"
  ],
  "secret": "your-webhook-secret"
}

Event Types

message.received

Triggered when a user sends a message to the bot

{
  "event": "message.received",
  "data": {
    "chat_id": "123456789",
    "username": "@user123",
    "message": "Hello bot!",
    "timestamp": "2024-10-24T07:37:42Z"
  }
}

command.executed

Triggered when a user executes a bot command

{
  "event": "command.executed",
  "data": {
    "chat_id": "123456789",
    "command": "/wallet balance",
    "success": true,
    "response": "Balance: 5.24 SOL",
    "timestamp": "2024-10-24T07:37:42Z"
  }
}

user.registered

Triggered when a new user starts using the bot

{
  "event": "user.registered",
  "data": {
    "chat_id": "123456789",
    "username": "@newuser",
    "first_name": "John",
    "registered_at": "2024-10-24T07:37:42Z"
  }
}

wallet.connected

Triggered when a user connects their wallet

{
  "event": "wallet.connected",
  "data": {
    "chat_id": "123456789",
    "wallet_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "connected_at": "2024-10-24T07:37:42Z"
  }
}

Bot Features

Security Features

🔐 Encrypted Storage

All sensitive data is encrypted before storage

🔑 Private Key Security

Private keys never leave your device

✅ Transaction Verification

All transactions require explicit confirmation

🚨 Fraud Detection

AI-powered fraud detection and alerts

Notification Types

The bot can send various types of notifications:

Transaction Alerts
Price Alerts
Staking Rewards

Incoming Transactions: Get notified when you receive tokens
Outgoing Confirmations: Confirmation when your transactions are processed
Failed Transactions: Alerts for failed or rejected transactions
Large Transactions: Special alerts for transactions above your threshold

Example Integration

Here’s a complete example of integrating the M.O.N.K.Y bot into your application:

class MonkyBotIntegration {
  constructor(botToken) {
    this.botToken = botToken;
    this.baseUrl = 'https://api.monkywallet.com/v1/telegram';
  }

  async sendWelcomeMessage(chatId, userName) {
    const response = await fetch(`${this.baseUrl}/send-message`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.botToken}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        chat_id: chatId,
        message: `🎉 Welcome to M.O.N.K.Y, ${userName}!\n\nYour Solana wallet is ready. Type /help to get started.`,
        parse_mode: 'Markdown'
      })
    });
    
    return response.json();
  }

  async checkUserWallet(chatId) {
    const response = await fetch(`${this.baseUrl}/execute-command`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${this.botToken}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        chat_id: chatId,
        command: '/wallet balance',
        silent: false
      })
    });
    
    return response.json();
  }

  async setupNotifications(chatId, events) {
    const response = await fetch(`${this.baseUrl}/user/${chatId}/notifications`, {
      method: 'PUT',
      headers: {
        'Authorization': `Bearer ${this.botToken}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        enabled: true,
        events: events
      })
    });
    
    return response.json();
  }
}

// Usage
const bot = new MonkyBotIntegration('your-bot-token');

// Send welcome message to new user
await bot.sendWelcomeMessage('123456789', '@newuser');

// Check wallet balance
const balance = await bot.checkUserWallet('123456789');

// Enable notifications
await bot.setupNotifications('123456789', [
  'transaction.received',
  'price.alert',
  'stake.reward'
]);

Rate Limits

Bot API calls are subject to rate limiting:

Free Tier: 50 requests/hour per bot token
Pro Tier: 500 requests/hour per bot token
Message Sending: 30 messages/minute per user

Support

Need help with bot integration?

Bot Support

Chat with our bot for technical support

Developer Email

Email our technical team

Documentation

Check our comprehensive FAQ

Security Note: Never share your bot token publicly. Keep it secure and rotate it regularly.

Documentation Index

​Telegram Bot Integration

​Bot Information

​Getting Started

​1. Start the Bot

Start Chat

​2. Available Commands

​Bot API Integration

​Authentication

​Send Message API

​Execute Command API

​User Registration API

​Webhook Integration

​Configuration

​Event Types

​Bot Features

​Security Features

🔐 Encrypted Storage

🔑 Private Key Security

✅ Transaction Verification

🚨 Fraud Detection

​Notification Types

​Example Integration

​Rate Limits

​Support

Bot Support

Developer Email

Documentation

Telegram Bot Integration

Bot Information

Getting Started

1. Start the Bot

2. Available Commands

Bot API Integration

Authentication

Send Message API

Execute Command API

User Registration API

Webhook Integration

Configuration

Event Types

Bot Features

Security Features

Notification Types

Example Integration

Rate Limits

Support