Configuring Telegram

Telegram is a cloud-based app providing messaging and social media features. It uses end-to-end encryption with an emphasis on security. Uptime.com has developed an integration allowing you to receive alerts in Telegram based on groups.

Table of Contents

• Integration Functionality
• Integration Setup
  • Assign Integration to Existing Contacts
  • Create New Contacts for the Integration
  • Assign Integration Contact to Check
  • Test Your Integration
• Final Thoughts

Integration Functionality

Return

• When an alert is created in Uptime.com, a Telegram message is sent from the user @UptimeDotComBot to the group you select when setting up the integration.
• When the check recovers, a corresponding UP alert is sent to the same group.

Integration Setup

Return

Create Telegram Group and Invite @UptimeDotComBot

In the Telegram app, create a new group. Device-based instructions for creating a group are as follows:

• iOS: Start a new message (tap the icon in the top right corner in Chats) > 'New Group'.
• Android: Tap the circular pencil icon in the chat list > 'New Group'.
• Telegram Desktop: Click the menu button in the top left corner > 'New Group'.

When creating the group, you can invite contacts by username. Search for the user @UptimeDotComBot and select it to add to the group:
 

Enter a name for the group and save. The group will appear in your list of messages.

Note: after adding the @UptimeDotComBot to the group, it will be necessary to complete the remaining steps and complete the integration within 48 hours. When using the Load Chats step defined below, if your bot was added more than 48 hours ago, those groups won’t appear in the "Select Group" dropdown. If this does occur, please follow these steps:

1. Remove the bot (@UptimeDotComBot) from your Telegram groups
2. Re-add the bot to the groups you want to integrate
3. Return to Uptime.com and click Load Chats within 48 hours of re-adding the bot.
    

Create the Integration Profile and Link to Created Group

Return

In Uptime, navigate to Notification > Integrations. Click New Profile in the upper right to create a new integration profile and select Telegram from the Provider Type drop-down list.

The Add Integration Profile window appears:

Enter your Telegram username in the appropriate field (enter only the username; do not include the preceding @ symbol). Click Load Chats and the created Group will appear in the Select Group drop-down:

Once the Group is selected, the Group ID and Group Title will be automatically populated. Click Save to create the integration profile.
 

Assign Integration to Existing Contacts

Return

To add your integration to an existing contact, click on or type the name of the contact into the Assign to Contacts field within the integration setup screen. 

Create New Contacts for the Integration

Return

Adding a dedicated or new contact cannot be done within the integrations screen. To do so, navigate to Notifications > Contacts. You can select New Contact, or add your integration to an existing contact. 

Select the integration profile’s name from the Integrations drop-down within the Add Contact screen:

Assign Integration Contact to a Check

Return

If you have created a new or dedicated contact for your integration, you will need to add it to specific checks. If you have assigned the integration to a contact that is already assigned to one (or more) checks, you may skip this step. 

Return to your Check’s Edit screen and assign this contact to the Contacts field to be notified of a downtime event. Alert data will appear in real time. 

Please note: Response time data is stored based on plan usage. Uptime.com stores hourly data for a maximum of 90 days, and daily check data for a period of up to 24 months. On initial setup, metric data may take up to 30 minutes to initially appear.

Test Your Integration

Return

Test your integration with one or more of the following methods:

1. Navigate to Notification > Integrations > Active then click More Actions > Test next to the integration name
2. Force the Check assigned to your Integration to fail by altering it (HTTPS checks can use a misspelling of the domain, for example)
3. Click Notification > Contacts, locate a contact that is associated with the integration, then click Test Contact to send a test notification to all methods associated with the Contact:

Final Thoughts

Telegram is a widely used secure messaging app. Adding a Telegram integration can provide helpful and immediate alerting on your mobile device without using SMS or call credits, helping with efficient usage of your subscription credits.