Telegram Integration - Bot Messenger avatar

Telegram Integration - Bot Messenger

Pricing

from $0.01 / 1,000 results

Go to Apify Store
Telegram Integration - Bot Messenger

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

The Howlers

Maintained by Community

Actor stats

0

Bookmarked

74

Total users

4

Monthly active users

4 days ago

Last modified

Features

Limited permissions

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

ParameterTypeDefaultRequiredDescription
botTokenstring-YesYour Telegram Bot API token from @BotFather
chatIdstring-NoTelegram chat/group/channel ID to send messages to. Use @username for public channels.
messagestring-NoThe message to send. Supports Markdown formatting.
parseModestring"Markdown"NoMessage formatting mode
disableNotificationbooleanfalseNoSend the message silently (no notification sound)
disableWebPagePreviewbooleanfalseNoDisable link previews in the message
replyToMessageIdinteger-NoOptional: Message ID to reply to
imageUrlstring-NoOptional: URL of an image to send with the message
documentUrlstring-NoOptional: URL of a document/file to send
webhookDataobject-NoOptional: Data from Apify webhook to format into a notification
webhookUrlstring-NoURL to send results to (Zapier, Make, n8n, etc.) for automation workflows
demoModebooleanfalseNoRun 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:

EventWhen it is chargedPrice
Actor startOnce 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 SentPer message sent$0.02
ResultEach 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