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

# Telegram

> Chatujte s agentem Macaly přes Telegram

Propojení s Telegramem vám umožní komunikovat s agentem Macaly přímo z telefonu. Pošlete zprávu přes Telegram, dostanete odpověď a pokračujete v práci na projektech, aniž byste museli otevírat webovou aplikaci.

## Co můžete pomocí Telegramu dělat

Agent v Telegramu pracuje na stejných projektech, které vytváříte ve webové aplikaci. Cokoli byste normálně zadali agentovi, můžete zadat z Telegramu:

* **Založit nový projekt.** Popište, co chcete vytvořit, a agent se pustí do práce – stejně jako ve webové aplikaci.
* **Upravit existující projekty.** Požádejte o změny, opravy nebo nové sekce. Pokud máte víc projektů a neupřesníte který, agent se zeptá.
* **Publikovat a spravovat projekty.** Publikujte projekt, změňte jeho subdoménu nebo zkontrolujte, co je právě živé.
* **Zeptat se na stav projektu.** Získejte pomoc, nápady nebo informace o stavu, aniž byste přerušili svůj flow.

Když agent provede změny, pošle vám odkaz na náhled, abyste si výsledek mohli zkontrolovat přímo v Telegramu.

## Co můžete posílat

Agent aktuálně zvládá:

* **Textové zprávy.** Prostě napište a odešlete.
* **Hlasové zprávy.** Macaly je přepíše a odpoví. Hodí se, když se vám zrovna nechce psát.
* **Obrázky.** Posílejte screenshoty, návrhy nebo reference, na které se má agent podívat.
* **Soubory.** PDF a dokumenty, které agent může přečíst a využít.

Videa zatím nejsou podporovaná. Odpovědi přicházejí jako prostý text bez formátování nebo náhledů odkazů.

## Jak propojení nastavit

<Steps>
  <Step title="Otevřete nastavení Propojení">
    V Macaly přejděte do **Nastavení → Propojení** a klikněte na **Připojit** na kartě Telegram.

    <img src="https://mintcdn.com/macaly-41b1d3e9/dOzNT7eRKWZWpaZK/images/integrations_telegram_01.png?fit=max&auto=format&n=dOzNT7eRKWZWpaZK&q=85&s=33014b19133bc9434e1335a8af1d97c4" alt="Settings Connections Telegram card" width="2400" height="1600" data-path="images/integrations_telegram_01.png" />
  </Step>

  <Step title="Otevřete Telegram">
    Macaly zobrazí QR kód a odkaz pro propojení. Naskenujte QR kód telefonem, nebo klikněte na **Otevřít Telegram** a spusťte ho na počítači nebo telefonu s předvyplněným propojovacím kódem.
  </Step>

  <Step title="Stiskněte Start">
    Telegram otevře chat s botem Macaly a předvyplní zprávu `/start [KÓD]`. Stiskněte **Start** (nebo zprávu odešlete) a propojení dokončíte.
  </Step>

  <Step title="Začněte chatovat">
    Macaly potvrdí propojení a zobrazí účet, ke kterému je připojeno. Od teď můžete agentovi kdykoli napsat přes Telegram.
  </Step>
</Steps>

Propojovací kód platí 15 minut. Pokud vyprší, vygenerujte nový v nastavení Propojení.

## Příkazy

V Telegram chatu s Macaly můžete poslat tyto příkazy:

| Příkaz    | Co dělá                                                                           |
| --------- | --------------------------------------------------------------------------------- |
| `/new`    | Zahájí nové konverzační vlákno s agentem.                                         |
| `/switch` | Přepne na jiný připojený workspace (zobrazí se, když je propojený víc než jeden). |
| `/status` | Zobrazí stav propojení a aktuálního chatu.                                        |
| `/unlink` | Odpojí workspace od tohoto chatu. Když je jich připojeno víc, vyberete který.     |
| `/help`   | Vypíše dostupné příkazy.                                                          |

## Práce s více workspaci

Stejný účet Telegram můžete propojit s víc než jedním workspace Macaly – až se 3 najednou. To se hodí, když pracujete napříč víc workspaci a chcete je všechny obsluhovat z jednoho chatu.

* **Připojení dalšího workspace.** Otevřete **Nastavení → Propojení** v druhém workspace a připojte ho ze stejného účtu Telegram.
* **Přepnutí aktivního workspace.** Pošlete `/switch` a vyberte workspace ze seznamu. Vaše další zpráva tam zahájí novou konverzaci.
* **Zjištění, který je aktivní.** Pošlete `/status` – začíná názvem aktivního workspace.

Aktivní je vždy jen jeden workspace, takže zprávy míří do toho, na který jste naposledy přepnuli. Když aktivní workspace odpojíte, Macaly chat automaticky přepne na jiný připojený workspace, aby dál fungoval.

## Odpojení

Odpojit se můžete buď příkazem `/unlink` v Telegramu, nebo v aplikaci přes **Nastavení → Propojení** odebráním připojeného účtu.

Pokud je chat připojený jen k jednomu workspace, odpojí se hned. Když je jich připojeno víc, `/unlink` se zeptá, který odebrat – odpojení workspace, který zrovna nepoužíváte, vaši konverzaci nechá být, a odpojení aktivního přepne chat na jiný připojený workspace.

## Dobré vědět

* **Žádné nastavení bota není potřeba.** Nepotřebujete si vytvářet vlastního Telegram bota ani získávat API klíč. Stačí se připojit z Nastavení a začít chatovat.
* **Kredity fungují stejně jako ve webové aplikaci.** Práce agenta čerpá kredity stejným tempem jako ve webové aplikaci, plus malé množství navíc při posílání hlasových zpráv (za přepis).
* **Až 3 workspace na účet Telegram.** Účet Telegram můžete propojit s několika workspaci Macaly (nejvýš se 3) a přepínat mezi nimi příkazem `/switch`. Každý člen workspace si zároveň může připojit vlastní účet.
* **Limit velikosti hlasových zpráv.** Hlasové zprávy mohou mít maximálně 10 MB. Delší nahrávky nepůjdou poslat.