Docs

Telegram Integration

Receive Heyo notifications on Telegram and reply to visitors on the go.

Connect Heyo to Telegram to receive instant notifications on your phone or desktop. Perfect for staying responsive when you're away from the dashboard.

Features

Instant notifications - Get messages and alerts pushed to Telegram
Reply on the go - Respond to visitors directly from Telegram
Rich messages - See visitor info, project name, and conversation context
Image support - Receive image messages from visitors
Alert notifications - Get notified when visitors trigger your custom alerts

Prerequisites

A Heyo account with Premium subscription
A Telegram account
The Telegram app (mobile or desktop)

Setup Instructions

Step 1: Open Integration Settings

Go to Project Settings
Scroll down to the Integrations section
Click on Telegram

Step 2: Start the Heyo Bot

In the Telegram settings modal, click Open Heyo Bot (or search for @HeyoChatBot in Telegram)
Click Start in Telegram to begin the conversation with the bot

Step 3: Get Your Verification Code

After starting the bot, it will send you a 6-digit verification code:

Your Heyo verification code is: 123456

This code will expire in 10 minutes.

Step 4: Enter the Code in Heyo

Return to the Heyo Telegram settings modal
Enter the 6-digit code
Click Verify

Step 5: Enable Notifications

Once verified, toggle Enable notifications to start receiving messages.

How Notifications Work

New Messages

When a visitor sends a message, you'll receive a Telegram notification:

[Project Name] 💬 New message from John Smith:

> Hi, I have a question about your product

The notification includes:

Project name (helpful if you have multiple projects)
Visitor name
Message content
Quick reply option

Replying to Visitors

To reply from Telegram:

Tap the Reply button on the notification
Type your message
Send it

Your reply will be delivered to the visitor in real-time via the Heyo widget.

Image Messages

When visitors send images, you'll see them directly in Telegram:

Alert Notifications

When a visitor triggers an alert:

[Project Name] 🚨 Alert: Viewed Pricing Page

Triggered by John Smith from United States.
[View Visitor]

Settings

Disabling Notifications

Toggle off Enable notifications to pause Telegram notifications without disconnecting. You can re-enable anytime.

Disconnecting Telegram

Go to Project Settings → Integrations → Telegram
Click Disconnect
Confirm the disconnection

This removes the Telegram connection from this project. You can reconnect anytime.

Multiple Projects

You can connect the same Telegram account to multiple Heyo projects. Each notification will include the project name so you know which project it's from:

[Project Alpha] 💬 New message from John...
[Project Beta] 🚨 Alert: New visitor...

Troubleshooting

Not receiving notifications

Check that the integration shows as Connected in Heyo settings
Verify Enable notifications is toggled on
Make sure Telegram notifications are enabled on your device
Check that you haven't muted the HeyoChatBot chat

Verification code expired

Codes expire after 10 minutes. Click Open Heyo Bot again to get a new code.

Can't find the bot

Search for @HeyoChatBot in Telegram. Make sure you're searching in the main Telegram search, not within a specific chat.

Replies not being sent

Make sure you're using the Reply feature (not just sending a new message)
Check your internet connection
Verify the conversation is still open in Heyo

Bot not responding

The bot only sends notifications—it doesn't respond to general messages. If you need help, contact Heyo support directly.

Security

Verification codes are single-use and expire after 10 minutes
Your Telegram chat ID is stored securely and only used for sending notifications
No message content is stored beyond what's in your normal Heyo conversation history
You can revoke access anytime by disconnecting in Heyo settings