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

# Telegram Alerts

> Get instant Telegram notifications for account issues, lead updates, and AI handovers

Stay informed about your accounts without constantly checking the app. Clianta sends Telegram alerts for important events that need your attention.

## What you'll receive

| Alert                 | When it fires                                                                                             |
| --------------------- | --------------------------------------------------------------------------------------------------------- |
| **Human handover**    | AI auto-reply flags a conversation that needs your personal attention (meeting request, complex question) |
| **Account suspended** | Instagram suspends one of your accounts — automation stops immediately                                    |
| **Login required**    | An account's session expired or Instagram is asking for verification                                      |
| **Leads exhausted**   | An account has processed all its leads — add more to continue outreach                                    |

All alerts include the account name and group so you can act quickly.

## Setup

<Steps>
  <Step title="Find your Telegram chat ID">
    Open Telegram and message **@userinfobot**. It will reply with your numeric chat ID (a long number like `6531183520`). Copy this number.
  </Step>

  <Step title="Open notification settings in Clianta">
    In the desktop app, go to the **Integrations** tab in the sidebar and find the **Telegram Alerts** card.

    <Note>
      Telegram configuration is currently available in the desktop app only. Cloud dashboard support is coming soon. Settings sync automatically between desktop and cloud, so you only need to set it up once.
    </Note>
  </Step>

  <Step title="Enter your chat ID">
    Paste the numeric chat ID from step 1 into the **Telegram Chat ID** field. Optionally add your Telegram username.
  </Step>

  <Step title="Send a test alert">
    Click **Send Test Telegram Alert**. You should receive a message from **@CliantaBot** within a few seconds. If it works, you're all set.
  </Step>

  <Step title="Turn it on">
    Toggle the Telegram alerts switch to **on**. You'll now receive alerts for all your accounts.
  </Step>
</Steps>

<Tip>
  You don't need to create your own Telegram bot. Clianta uses **@CliantaBot** to send all alerts — just make sure you've messaged the bot at least once so it can reach you.
</Tip>

## Group-level overrides

If you manage multiple groups, you can set different Telegram destinations per group:

1. Open any group's **Settings** tab
2. Scroll to the **Notifications** section
3. Enable **Telegram Alerts** and enter a chat ID for that group

Group-level settings override the global setting. This is useful if different team members manage different groups and each wants alerts sent to their own Telegram.

## Troubleshooting

<AccordionGroup>
  <Accordion title="I'm not receiving any alerts">
    * Make sure the toggle is **on** (Integrations → Telegram Alerts)
    * Verify your chat ID is correct — message @userinfobot again to double-check
    * Send a test alert to confirm the connection works
    * Check that you haven't blocked @CliantaBot on Telegram
  </Accordion>

  <Accordion title="Test alert works but real alerts don't arrive">
    * Real alerts fire only when specific events happen (suspension, handover, etc.). If nothing has triggered yet, that's expected.
    * If you set up Telegram on the desktop app, wait a moment for settings to sync to the cloud server where automation runs.
    * Lead exhaustion alerts only fire when an account has truly zero pending leads remaining.
  </Accordion>

  <Accordion title="I get duplicate alerts">
    Alerts are deduplicated — you should only receive one per event per account. If you're getting duplicates, check whether you have Telegram configured at both the global level (Integrations) and the group level (Group Settings) with the same chat ID.
  </Accordion>
</AccordionGroup>