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
Actor stats
0
Bookmarked
50
Total users
14
Monthly active users
2 months ago
Last modified
Categories
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
You can test with Demo Mode first (free, no key needed) to see the output format before committing.
Quick Start
Test with Demo Mode (free, no API key needed)
Run with real data
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 | true | 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 | Description | Price |
|---|---|---|
| Message Sent | Each Telegram message sent | $0.01 |
Demo mode is free -- no charges for sample data.
Troubleshooting
"API key is required"
You have Demo Mode turned off but didn't provide an API key. Either:
- Turn Demo Mode on to test with sample data
- Add your API key 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
