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

# Telegram overview

> Connect a Telegram group to collect reviews and receive notifications.

The EthioReview **Telegram integration** lets businesses:

1. **Link a Telegram group** to their organization profile
2. **Collect reviews** by posting a touchpoint link (`/collect` in the group)
3. **Receive notifications** when new reviews are published

## How it works

| Step | Where                | What happens                                    |
| ---- | -------------------- | ----------------------------------------------- |
| 1    | Dashboard            | Generate a one-time link code                   |
| 2    | Telegram group       | Add the EthioReview bot and run `/connect CODE` |
| 3    | Dashboard            | Status shows **CONNECTED**                      |
| 4    | Telegram group       | Admin runs `/collect` to share a review link    |
| 5    | Dashboard (optional) | Enable notifications for new published reviews  |

```mermaid theme={null}
sequenceDiagram
  participant Admin as Org admin
  participant Dash as Dashboard
  participant Bot as EthioReview bot
  participant Group as Telegram group

  Admin->>Dash: Generate link code
  Admin->>Group: Add bot + /connect CODE
  Group->>Bot: /connect
  Note over Group,Bot: Group is linked
  Admin->>Group: /collect
  Bot->>Group: Review link buttons
```

## Bot commands

| Command           | Who          | Action                               |
| ----------------- | ------------ | ------------------------------------ |
| `/start`          | Anyone       | Help; auto-connect via deep link     |
| `/connect <code>` | Group member | Link group using dashboard code      |
| `/collect`        | Group admin  | Post customer review collection link |

[Connect a group →](/integrations/telegram/connect-group)
