tashfeenahmed/scallopbot/telegram-send

Telegram Send Skill

Send messages to Telegram users or chats. Uses the bot's active Telegram connection to deliver messages with markdown formatting support.

When to Use

Use this skill when you need to:

• Send notifications: Alert users about completed tasks or important updates
• Respond to users: Send messages to specific chat IDs
• Proactive messaging: Deliver scheduled reminders or status updates

Input Format

The skill accepts JSON arguments via the SKILL_ARGS environment variable:

{
  "chat_id": "123456789",
  "message": "Hello! This is a test message."
}

Parameters

Output Format

The skill returns JSON to stdout:

{
  "success": true,
  "output": "Message sent to 123456789",
  "exitCode": 0
}

Response Fields

Examples

Send a simple message

{
  "chat_id": "123456789",
  "message": "Task completed successfully!"
}

Send a formatted message

{
  "chat_id": "123456789",
  "message": "**Status Update**\n\nYour file has been processed.\n- Records: 1,250\n- Errors: 0"
}

Prerequisites

• Telegram bot must be running (via Gateway)
• The chat_id must be a valid Telegram user or group chat ID
• The bot must have permission to send messages to the target chat