🚀 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 json { "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 json { "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 json { "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: json { "text": "*Bold text*\n_Italic text_\n`Code text`\n[Link](https://example.com)", "parseMode": "Markdown" } HTML: json { "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