Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Auth type: API
For general setup steps, permissions, and troubleshooting, start with: App Integrations.

Connect Telegram

  1. Go to Settings → Apps in Hyper
  2. Select Telegram → Connect New
  3. Provide your Telegram Bot token

Common capabilities

  • Send and receive messages via Telegram bots
  • Automate bot interactions and group management
  • Trigger workflows from Telegram messages

Use in Chat

Enable Telegram in the tool selector. Ask your agent to send messages or manage bot interactions.

Use in Agents

Add Telegram to an agent’s toolkits and select the connection. Mark sensitive actions as “requires approval.”

Use in Flows

Automate messaging, notifications, and bot workflows using Telegram action nodes.

Troubleshooting

  • Bot not responding: verify the bot token and that the bot is added to the target group
  • Permission errors: check bot permissions in the Telegram group settings

Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to Enabled, Requires Approval, or Disabled in your agent’s toolkit settings. Actions can be set to one of three control states:
StateBehavior
EnabledAgent runs the action automatically
Requires ApprovalAgent pauses and waits for your confirmation before proceeding
DisabledAction is blocked and cannot be used
Configure these in the agent’s toolkit settings or in workspace defaults.
ActionDescription
Delete WebhookRemove webhook integration
Get Webhook InfoGet current webhook status
Send DocumentSend a document to a Telegram chat
Send MessageSend a text message to a Telegram chat
Send PhotoSend a photo to a Telegram chat
Send VideoSend a video to a Telegram chat
Send VoiceSend a voice message to a Telegram chat
Set WebhookSet webhook for the bot