🚀 Telegram Message Sender PRO

Send automated messages to Telegram chats and channels. Perfect for notifications, alerts, marketing messages, and automated communication workflows. Supports text messages, custom formatting, and advanced delivery options.

📥 Input Parameters

Parameter	Type	Required	Description
botToken	String	✅	Your Telegram bot token (get it from @BotFather)
messages	Array	✅	List of messages to send to Telegram
delayBetweenMessages	Number	❌	Delay in seconds between messages (default: 1)

Message Object Properties

Property	Type	Required	Description
chatId	String	✅	Chat ID or username (@channel_name) where to send the message
text	String	✅	Message text content (max 4096 characters)
parseMode	String	❌	Message formatting: "Markdown", "MarkdownV2", "HTML", or "" (none)
disableWebPagePreview	Boolean	❌	Disable link previews (default: false)
disableNotification	Boolean	❌	Send message silently (default: false)

Example Input

{
    "botToken": "1234567890:ABCDefGhIJKlMnOpQrStUvWxYz",
    "messages": [
        {
            "chatId": "@my_channel",
            "text": "🚀 **Hello World!**\n\nThis is a test message from Apify.",
            "parseMode": "Markdown",
            "disableWebPagePreview": false,
            "disableNotification": false
        },
        {
            "chatId": "-1001234567890",
            "text": "Alert: System status update",
            "disableNotification": true
        }
    ],
    "delayBetweenMessages": 2
}

📤 Output Data

Each sent message produces a detailed result with delivery information and status:

Successful Message Result

{
    "success": true,
    "messageId": 123,
    "chatId": "@my_channel",
    "text": "🚀 **Hello World!**\n\nThis is a test message from Apify.",
    "parseMode": "Markdown",
    "sentAt": "2024-01-01T12:00:00.000Z",
    "botUsername": "my_bot",
    "disableWebPagePreview": false,
    "disableNotification": false,
    "retryAttempt": 0
}

Failed Message Result

{
    "success": false,
    "chatId": "@invalid_channel",
    "text": "This message failed to send",
    "sentAt": "2024-01-01T12:00:00.000Z",
    "error": "Bad Request: chat not found",
    "errorCode": "400",
    "disableWebPagePreview": false,
    "disableNotification": false,
    "retryAttempt": 0
}

🤖 Getting Started

1. Create a Telegram Bot

1. Open Telegram and search for @BotFather
2. Send /newbot command
3. Choose a name and username for your bot
4. Copy the bot token (format: 123456789:ABCDefGhIJKlMnOpQrStUvWxYz)

2. Get Chat IDs

For Channels:

• Create a public channel: use @channel_username
• For private channels: use the numeric chat ID (starts with -100)

For Groups:

• Add your bot to the group
• Use the numeric group ID (negative number)

For Private Chats:

• Use the user's numeric ID (positive number)

3. Configure and Run

1. Set Bot Token: Enter your bot token from @BotFather
2. Add Messages: Configure your messages with target chats and content
3. Run Actor: Execute and monitor message delivery in real-time
4. View Results: Check delivery status and message IDs in the dataset

📊 Key Features

• ✅ Multiple Message Types: Send to channels, groups, and private chats
• ✅ Rich Formatting: Support for Markdown, HTML, and plain text
• ✅ Delivery Control: Silent messages, link preview control, and rate limiting
• ✅ Robust Error Handling: Comprehensive error logging and detailed failure reasons
• ✅ Batch Processing: Send multiple messages with configurable delays
• ✅ Real-time Monitoring: Live delivery status and message tracking
• ✅ Structured Output: Detailed results with timestamps and metadata
• ✅ Token Validation: Automatic bot token verification and authentication

🔧 Advanced Usage

Message Formatting Examples

Markdown:

{
    "text": "*Bold text*\n_Italic text_\n`Code text`\n[Link](https://example.com)",
    "parseMode": "Markdown"
}

HTML:

{
    "text": "<b>Bold text</b>\n<i>Italic text</i>\n<code>Code text</code>\n<a href=\"https://example.com\">Link</a>",
    "parseMode": "HTML"
}

Rate Limiting

To avoid Telegram rate limits:

• Set delayBetweenMessages to 1-3 seconds for bulk sends
• Monitor error responses for rate limit warnings
• Consider splitting large batches across multiple runs

Error Handling

Common error scenarios:

• Bot not added to channel: Add bot as admin to target channels
• Invalid chat ID: Verify chat IDs and permissions
• Message too long: Keep messages under 4096 characters
• Rate limiting: Increase delay between messages

🚨 Important Notes

• Bot Permissions: Ensure your bot has permission to send messages to target chats
• Character Limits: Telegram messages are limited to 4096 characters
• Rate Limits: Respect Telegram's rate limits (30 messages/second to different chats)
• Security: Keep your bot token secure and never share it publicly

📞 Support

For issues with:

• Bot Creation: Contact @BotFather on Telegram
• Rate Limits: Check Telegram Bot documentation
• Actor Issues: Review the error messages in the dataset output

---

Built with ❤️ by XTech