> For the complete documentation index, see [llms.txt](https://docs.usepylon.com/pylon-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.usepylon.com/pylon-docs/integrations/chat/telegram.md).

# Telegram

View, respond to, and track customer requests coming from Telegram.

## Setup

Click into the App Directory from your Pylon dashboard and then click on the Telegram integration to view setup instructions. See the [Telegram setup guide](https://support.usepylon.com/articles/7047547549-how-do-i-integrate-telegram-with-pylon).

One org-level connection must be made, and each user must then connect their personal Telegram account.

### Connect your personal account

Under **Connected account** on the Telegram integration page, choose either:

* **Connect with Phone Number**: enter your phone number and the login code from Telegram.
* **Connect with QR Code**: open Telegram on your phone, go to **Settings > Devices > Add Device**, and scan the code. The code refreshes automatically.

If your Telegram account has two-step verification enabled, enter its password when prompted. If a login attempt expires, start another attempt. An expired connected session can be reconnected from the same page.

### Channel visibility

Enable **Show only personal channels** to let each user see only the Telegram channels from their own connected account.

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2FYs4KtyRCnm10LRd1Mbtg%2FScreenshot%202025-12-28%20at%208.35.07%E2%80%AFAM.png?alt=media&amp;token=38f79b44-9558-49c7-a085-a8b0c273a462" alt=""><figcaption></figcaption></figure>

## Usage

1. Connect your personal Telegram account on the Telegram Integrations page.
2. Link Telegram chats to existing accounts via the Add Account button on the Accounts page, or create new accounts from Telegram chats.

New messages in linked Telegram chats will automatically create issues in Pylon with complete bidirectional syncing, including messages, files, and reactions. All Pylon features can then be used to manage these issues.

Telegram issues can be identified by setting the Issue Source filter or visually by the Telegram logo on issues.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.usepylon.com/pylon-docs/integrations/chat/telegram.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.