API Documentation

Getting Started

Start a chat with our Telegram bot
Send /start to register and get your API token
Use the token to send messages via HTTP API

Send Message

POST GET https://buzzgram.uyloal.com/send/{token}

Headers (POST only)

Content-Type: application/json

Request Body (POST)

{
  "message": "Hello World!",
  "parse_mode": "Markdown",  // Optional: "Markdown", "MarkdownV2", "HTML"
  "buttons": [               // Optional: Inline keyboard buttons
    [
      { "text": "Open URL", "url": "https://example.com" },
      { "text": "Button 2", "callback_data": "action_2" }
    ]
  ],
  "image_url": "https://example.com/image.jpg"  // Optional
}

Query Parameters (GET)

message      - Required: The message text
parse_mode   - Optional: "Markdown", "MarkdownV2", "HTML"
image_url    - Optional: HTTPS URL of image to send
buttons      - Optional: JSON string of button array

Response

{
  "success": true,
  "message_id": 12345
}

Examples

Simple GET Request

curl "https://buzzgram.uyloal.com/send/YOUR_TOKEN?message=Hello%20World"

Simple POST Request

curl -X POST "https://buzzgram.uyloal.com/send/YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from my app!"}'

Markdown Message

curl -X POST "https://buzzgram.uyloal.com/send/YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "*Bold* and _italic_ text\n`code` and [link](https://example.com)",
    "parse_mode": "Markdown"
  }'

Message with Buttons

curl -X POST "https://buzzgram.uyloal.com/send/YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "New deployment completed!",
    "buttons": [[
      {"text": "View Details", "url": "https://example.com/deploy/123"}
    ]]
  }'

Message with Image

curl -X POST "https://buzzgram.uyloal.com/send/YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Here is your chart",
    "image_url": "https://example.com/chart.png"
  }'

Bot Commands

/startRegister and get your API token

/tokenView your current token

/resetGenerate a new token (requires confirmation)

/helpShow help message

Rate Limiting

To ensure fair usage, the API enforces rate limits per token:

30 requests per minute per token

When the limit is exceeded, the API returns a 429 status with a retryAfter value indicating how long to wait.

Error Codes

400Invalid request body or missing message

403Account banned

404Token not found or inactive

429Rate limit exceeded (max 30 requests/minute per token)

500Failed to send message