Telegram Integration - Bot Messenger
Pricing
from $0.01 / 1,000 results
Telegram Integration - Bot Messenger
Send automated messages, alerts & reports via Telegram. Support for groups, channels & direct messages. Perfect for monitoring alerts & team notifications.
Pricing
from $0.01 / 1,000 results
Rating
0.0
(0)
Developer
The Howlers
Maintained by CommunityActor stats
0
Bookmarked
74
Total users
4
Monthly active users
4 days ago
Last modified
Categories
Features
Share
Telegram Integration
Send Telegram notifications from Apify actors. Notify when runs complete, send data summaries, alerts, and custom messages via Telegram Bot API. Perfect for workflow automation and real-time notifications.
BYOK (Bring Your Own Key) -- you provide your own API credentials.
Before You Start
This actor requires your own API credentials to fetch real data.
Where to get your key: Your Telegram Bot API token from @BotFather
Demo Mode is off by default, so runs fetch real data. botToken is a required input. Set demoMode to true to get free sample data that shows the output format without sending a message.
Quick Start
Test with Demo Mode (free, no message is sent)
{"demoMode": true,"botToken": "YOUR_BOT_TOKEN","imageUrl": "https://example.com","documentUrl": "https://example.com"}
Run with real data
{"demoMode": false,"botToken": "YOUR_API_KEY_HERE","parseMode": "Markdown","disableNotification": false,"disableWebPagePreview": false,"imageUrl": "https://example.com","documentUrl": "https://example.com"}
Input Parameters
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
botToken | string | - | Yes | Your Telegram Bot API token from @BotFather |
chatId | string | - | No | Telegram chat/group/channel ID to send messages to. Use @username for public channels. |
message | string | - | No | The message to send. Supports Markdown formatting. |
parseMode | string | "Markdown" | No | Message formatting mode |
disableNotification | boolean | false | No | Send the message silently (no notification sound) |
disableWebPagePreview | boolean | false | No | Disable link previews in the message |
replyToMessageId | integer | - | No | Optional: Message ID to reply to |
imageUrl | string | - | No | Optional: URL of an image to send with the message |
documentUrl | string | - | No | Optional: URL of a document/file to send |
webhookData | object | - | No | Optional: Data from Apify webhook to format into a notification |
webhookUrl | string | - | No | URL to send results to (Zapier, Make, n8n, etc.) for automation workflows |
demoMode | boolean | false | No | Run in demo mode with sample data (no actual Telegram messages sent). Set to false when using your own bot token. |
*Required when Demo Mode is off.
Pricing
This actor uses pay-per-event billing:
| Event | When it is charged | Price |
|---|---|---|
| Actor start | Once when the run starts, one event per GB of memory (minimum one). At the default 4 GB of memory a run starts at $0.40 | $0.10 per GB |
| Message Sent | Per message sent | $0.02 |
| Result | Each item written to the default dataset | $0.00001 |
Demo mode is free -- no charges for sample data.
Troubleshooting
"API key is required"
The bot token is missing. Add your Telegram Bot API token (botToken) from @BotFather in the input.
"API error 403" or "Unauthorized"
Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.
"API error 429" or "Rate limit"
Too many requests. Wait a minute and try again, or reduce the number of items per run.
No results or empty dataset
Check the run log for error messages. Common causes:
- Invalid input format (check the examples above)
- API key without proper permissions
- The target data doesn't exist or is too small to track
How do I test without an API key?
Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.
Built by John Rippy | Actor Arsenal