Telegram

The Telegram integration delivers real-time alerts about Apphud subscription events directly to your Telegram channel, chat, or @ApphudBot — so your team sees trial conversions, renewals, cancellations, and billing issues the moment they happen, without logging into Apphud.

About Integration

Apphud's integration with Telegram lets you receive real-time alerts about subscription events and other in-app activity directly in your Telegram channel. This is especially useful for keeping your team informed about important changes — trial conversions, renewals, cancellations, billing issues — without logging into Apphud.

Available Telegram integration settings give you the flexibility to:

• Set up multiple Telegram integrations using the same platform (iOS, Android, or Web) as the source, each with unique rules and filters.
• Route different types of events to different Telegram topics within the same channel — e.g., split Production and Sandbox events, or monitor billing errors and trials separately.
• Create separate notification streams for different team needs by setting up granular filters on various parameter groups, such as monitoring events only for the latest app version.

📘

Telegram rate limits

Telegram's API enforces rate limits that can result in message delivery failures during high-frequency events, such as promotional campaigns generating numerous events in a short period for a single channel. In such cases, only a portion of events may reach Telegram — others will be dropped due to Telegram API throttling (error 429: Too Many Requests).

Before a planned campaign with large volumes of zero-price purchases or similar bursts, consider temporarily disabling those specific event notifications (by applying a product filter, for instance) to maintain stability for other alerts sent to the same channel.

Before You Begin

If you'd like to receive notifications in a dedicated place rather than in a bot, make sure you have:

• A Telegram channel or chat.
• If needed, one or more Topics (a.k.a. threads) created within the channel, so notifications can be separated by logic you define (e.g., billing errors vs. trial starts).

Once they are in place, you'll be ready to create flexible, multi-stream alerting systems for your app directly in Telegram.

How to Add Integration?

Step 1 - Choose the source

In Apphud, open the Connections menu, navigate to the Integrations tab, and add Telegram.

In the Source pop-up, choose a platform. Then specify a connection Name on the integration settings page.

Step 2 - Specify the channel

To get notifications directly in ApphudBot

Find @ApphudBot in the Telegram app.

In Telegram, prompt the bot to start. The bot will reply with the Chat ID you need to use:

"Please follow the documentation if you want to add a Telegram integration to your app in Apphud. Use XXXXXXXXXX value as the Chat ID."

To get notifications in your dedicated Channel or Chat

Alternatively, add the Apphud bot to a chat, group, or channel (with or without topics) to receive notifications there. Call the /start@Apphudbot command in the channel.

If you start the bot in a channel topic, the message will be:

"Please follow the documentation if you want to add a Telegram integration to your app in Apphud. Use XXXXXXXXXX value as the Chat ID. If you want to receive messages in this specific topic, use XXXXX value as Topic ID. If Topic ID is not provided, messages will be sent to the general topic."

Copy the Chat ID (and Topic ID, if needed) from the bot's message into the Telegram integration settings in Apphud.

Step 3 - Configure Environments

Specify whether you want to receive notifications about Production and Sandbox events by enabling the respective checkboxes.

You can set up the same or different channels (topics) for Production and Sandbox events.

Step 4 - Apply Filters (optional)

You can add filters to the integration connection to tailor delivery of events.
Navigate to Filters tab and use this guide for settings.

Step 5 - Choose Events

Open the Events tab. Review the events list and toggle to include or exclude individual events. Check all event groups across the different tabs.

See Events below for the full list.

Step 6 - Save the connection

Once all settings are configured, click Save in the upper-right corner. The integration will appear alongside other configured ones in the Connections list.

Step 7 - Test the connection (optional)

Once the integration is saved, we recommend testing it before enabling. See Send Test Event below.

Step 8 - Enable the connection

Use the Enable connection toggle to activate or deactivate a Telegram integration from either its settings page or the Connections list.

Events

All possible events sent to Telegram:

📘

Note

You can get more details regarding events here.

Send Test Event

To test the integration:

1. Click the Test button in the upper-right corner of the integration's settings page.
2. Enter an Event ID or Transaction ID (to find these in the Events list, adjust the table layout to include those columns).
3. Click Send now and analyze the results shown.