> ## Documentation Index
> Fetch the complete documentation index at: https://klipy.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I connect Telegram to Klipy?

> Connect Telegram to Klipy with phone-number authentication. Customer messages appear in Unibox so you can track and reply without leaving your CRM.

Connecting Telegram brings your customer and prospect **direct messages** into **Unibox** alongside email, WhatsApp, and LinkedIn. Klipy captures individual conversations—not group chats or channels.

Telegram connects via **phone number authentication through Unipile**, the same infrastructure used for WhatsApp and LinkedIn.

## Before you start

* You must have an active Telegram account.
* Have your phone nearby—Telegram sends a verification code via SMS or the Telegram app.
* Use the Telegram account where you have customer and prospect conversations.

## Connect Telegram

<Steps>
  <Step title="Open Telegram settings">
    In the Klipy app, go to **Settings → Channels → Telegram**.
  </Step>

  <Step title="Enter your phone number">
    Follow the prompts to start the Telegram connection via Unipile. Enter the phone number tied to your Telegram account.

    <Frame caption="Screenshot coming soon: Settings → Channels → Telegram, phone-number entry">
      <div style={{padding:'2.5rem 1rem',textAlign:'center',border:'1px dashed currentColor',borderRadius:'12px',opacity:0.55}}>Screenshot coming soon</div>
    </Frame>
  </Step>

  <Step title="Verify with the code">
    Telegram sends a verification code—either as an SMS to your phone or as a message in the Telegram app (if you're already logged in elsewhere). Enter the code when prompted.

    <Frame caption="Screenshot coming soon: verification-code entry screen">
      <div style={{padding:'2.5rem 1rem',textAlign:'center',border:'1px dashed currentColor',borderRadius:'12px',opacity:0.55}}>Screenshot coming soon</div>
    </Frame>
  </Step>

  <Step title="Confirm messages in Unibox">
    Conversations appear in **Unibox** within a few minutes. Allow time for initial sync.
  </Step>
</Steps>

<Note>
  If you have **Two-Step Verification** (a second password) enabled in Telegram, you'll need to enter that as well during the Unipile flow.
</Note>

## After connecting

<Frame caption="Screenshot coming soon: Unibox feed with a Telegram thread">
  <div style={{padding:'2.5rem 1rem',textAlign:'center',border:'1px dashed currentColor',borderRadius:'12px',opacity:0.55}}>Screenshot coming soon</div>
</Frame>

* New Telegram messages appear in **Unibox** in real time.
* You can reply to conversations from inside Klipy.
* Conversations link to contact records where Klipy can match the Telegram user.

To see how Telegram messages are captured, see [What Klipy captures](/docs/guides/capture).

## Disconnect Telegram

Go to **Settings → Channels → Telegram** and click **Disconnect**. You can also terminate the session directly in the Telegram app under **Settings → Privacy and Security → Active Sessions**.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does Klipy capture Telegram group chats or channels?">
    No. Klipy captures **direct (private) messages** only. Group chats, channels, and bots are not processed.
  </Accordion>

  <Accordion title="Do I need a Telegram Business or API account?">
    No. Klipy connects to your regular Telegram account via phone number authentication—the same account you use for personal and business DMs. A separate API account is not required.
  </Accordion>

  <Accordion title="Is Telegram a common channel for B2B sales?">
    In some regions and industries (Southeast Asia, Eastern Europe, parts of the Middle East and Latin America), Telegram is a primary business communication channel. If your prospects or customers use Telegram, connecting it ensures those conversations are tracked in your CRM alongside email and other channels.
  </Accordion>

  <Accordion title="Why does Klipy use Unipile for Telegram?">
    Unipile is an aggregation layer for messaging channels. Klipy uses Unipile so that Telegram, WhatsApp, and LinkedIn conversations all surface in the same Unibox interface with a consistent experience.
  </Accordion>

  <Accordion title="How far back does Klipy import Telegram history?">
    Recent conversation history is synced on first connection. The exact backfill window depends on Telegram's API; typically the most recent conversations are available immediately.
  </Accordion>

  <Accordion title="Does connecting Telegram affect my Telegram account?">
    Connecting Klipy creates an active session similar to Telegram Web. It does not send messages, join groups, or take visible actions on your behalf.
  </Accordion>

  <Accordion title="What if my Telegram session expires?">
    If the session becomes inactive (for example, due to long inactivity or Telegram terminating sessions), you'll need to reconnect by going back to **Settings → Channels → Telegram** and re-authenticating.
  </Accordion>

  <Accordion title="Can multiple team members connect their own Telegram?">
    Yes. Each Klipy user connects their own Telegram account independently—your messages are not shared with teammates unless you're viewing the same contact record.
  </Accordion>

  <Accordion title="Does Klipy work with Telegram bots?">
    No. Klipy is designed for human-to-human conversation tracking. Messages from Telegram bots are not captured or tracked.
  </Accordion>
</AccordionGroup>