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

# Telegram

> Send alerts and messages to Telegram channels, groups or users.

<Frame>
  <img src="https://mintcdn.com/agevole/cM9eEPJE8FVhTNOb/images/integrazioni/telegram/shared/tile.svg?fit=max&auto=format&n=cM9eEPJE8FVhTNOb&q=85&s=95aec41e36a702bef607aa582d6c8065" alt="Telegram integration tile in Arya settings" width="1200" height="720" data-path="images/integrazioni/telegram/shared/tile.svg" />
</Frame>

## What it does

Send Arya notifications via Telegram Bot to team channels, groups or individual DMs. Useful for teams preferring Telegram over Slack.

## Prerequisites

<Note>
  * Active account with Telegram
  * **Admin** or **Manager** role on Arya to connect
  * OAuth authorisation (or API key, where applicable)
</Note>

## Connect Telegram

<Steps>
  <Step title="Go to Settings → Integrations">Find **Telegram** in the gallery and click **Connect**.</Step>
  <Step title="Authorise via OAuth">Opens Telegram login page. Grant requested permissions.</Step>
  <Step title="Confirm in Arya">Arya tests the connection. If OK, you see "Connected" in green.</Step>
  <Step title="Configure preferences (optional)">Sync frequency, filters, field mapping. From **Settings → Integrations → \[Telegram] → Configure**.</Step>
</Steps>

## What syncs

| Direction       | Entity                          |
| --------------- | ------------------------------- |
| Arya → Telegram | Workflow messages to target bot |

## Use in workflows

Once connected, Telegram appears as an action in the [workflow builder](/en/automations/workflow-builder). You can:

* Trigger workflows from Telegram events
* Use Telegram as an action (e.g. create record, send message)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorisation error">
    Expired or revoked token. Disconnect and reconnect.
  </Accordion>

  <Accordion title="Slow or failed sync">
    Check service API quota (rate limit). Reduce frequency if exceeding quota.
  </Accordion>

  <Accordion title="Data not synced">
    Verify field mapping and filters. Try manual sync from **⋯ → Sync now**.
  </Accordion>

  <Accordion title="Duplicate errors">
    Arya uses unique keys for matching. Configure key (email, external ID) in **Settings → Sync**.
  </Accordion>
</AccordionGroup>

## Disconnect

<Warning>
  Disconnection immediately stops synchronisation. Already-imported data stays in the workspace.
</Warning>

<Steps>
  <Step title="Go to Settings → Integrations">Find the Telegram card.</Step>
  <Step title="Click Disconnect">Confirm. Access token is revoked.</Step>
</Steps>