> ## 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

> Chat met de Macaly-agent via Telegram

Met de Telegram-verbinding van Macaly chat u vanaf uw telefoon met de Macaly-agent. Stuur een bericht in Telegram, ontvang een antwoord en blijf aan uw projecten werken zonder de webapp te openen.

## Wat u kunt doen

De Telegram-agent werkt op dezelfde projecten die u in de webapp bouwt. Alles wat u normaal aan de agent zou vragen, kunt u ook vanuit Telegram vragen:

* **Een nieuw project starten.** Beschrijf wat u wilt bouwen en de agent gaat aan de slag, net als in de webapp.
* **Bestaande projecten bewerken.** Vraag om wijzigingen, fixes of nieuwe secties. Heeft u meerdere projecten en zegt u niet welke, dan vraagt de agent ernaar.
* **Publiceren en beheren.** Publiceer een project, wijzig het subdomein of controleer wat er live staat.
* **Snelle vragen stellen.** Krijg hulp, ideeën of statusupdates zonder uw flow te onderbreken.

Wanneer de agent wijzigingen aanbrengt, stuurt hij een voorvertoningslink, zodat u het resultaat kunt bekijken zonder Telegram te verlaten.

## Wat u kunt sturen

De agent verwerkt op dit moment:

* **Tekstberichten.** Typ en verstuur.
* **Spraakberichten.** Macaly transcribeert ze en antwoordt. Handig wanneer typen niet praktisch is.
* **Afbeeldingen.** Stuur screenshots, mockups of referenties waar de agent naar moet kijken.
* **Bestanden.** PDF's en documenten die de agent kan lezen en gebruiken.

Video's worden nog niet ondersteund. Antwoorden komen terug als platte tekst, zonder opmaak of rijke voorvertoningen.

## Hoe u het instelt

<Steps>
  <Step title="Open de Verbindingen-instellingen">
    Ga in Macaly naar **Instellingen → Verbindingen** en klik op **Verbinden** op de Telegram-kaart.

    <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="Open Telegram">
    Macaly toont een QR-code en een verbindingslink. Scan de QR-code met uw telefoon, of klik op **Telegram openen** om het op uw computer of telefoon te starten met de verbindingscode al ingevuld.
  </Step>

  <Step title="Druk op Start">
    Telegram opent een chat met de Macaly-bot met het bericht `/start [CODE]` al ingevuld. Druk op **Start** (of verstuur het bericht) om te verbinden.
  </Step>

  <Step title="Begin met chatten">
    Macaly bevestigt de verbinding en toont het account waaraan deze gekoppeld is. U kunt de agent nu op elk moment vanuit Telegram een bericht sturen.
  </Step>
</Steps>

De verbindingscode is 15 minuten geldig. Als hij verloopt, genereert u een nieuwe in de Verbindingen-instellingen.

## Botcommando's

Stuur een van deze in uw Telegram-chat met Macaly:

| Commando  | Wat het doet                                                                                 |
| --------- | -------------------------------------------------------------------------------------------- |
| `/new`    | Start een nieuw gesprek met de agent.                                                        |
| `/switch` | Schakelt naar een andere gekoppelde workspace (verschijnt als er meer dan één is gekoppeld). |
| `/status` | Toont de status van uw verbinding en de huidige chat.                                        |
| `/unlink` | Koppelt een workspace los van deze chat. Als er meerdere zijn gekoppeld, kiest u welke.      |
| `/help`   | Toont de beschikbare commando's.                                                             |

## Meerdere workspaces gebruiken

U kunt hetzelfde Telegram-account aan meer dan één Macaly-workspace koppelen — maximaal 3 tegelijk. Handig als u in meerdere workspaces werkt en ze allemaal vanuit één chat wilt bereiken.

* **Nog een workspace koppelen.** Open **Instellingen → Verbindingen** in de andere workspace en koppel die vanaf hetzelfde Telegram-account.
* **De actieve workspace wisselen.** Stuur `/switch` en kies een workspace uit de lijst. Uw volgende bericht start daar een nieuw gesprek.
* **Zien welke actief is.** Stuur `/status` — dit begint met de naam van de actieve workspace.

Er is steeds maar één workspace actief, dus berichten gaan naar de workspace waarnaar u het laatst overschakelde. Als u de actieve workspace loskoppelt, schakelt Macaly de chat automatisch naar een andere gekoppelde workspace zodat die blijft werken.

## Verbinding verbreken

Om de verbinding te verbreken stuurt u `/unlink` vanuit Telegram, of opent u **Instellingen → Verbindingen** in de app en verwijdert u het gekoppelde account.

Als de chat aan slechts één workspace is gekoppeld, wordt die meteen losgekoppeld. Als er meerdere zijn gekoppeld, vraagt `/unlink` welke u wilt verwijderen — een workspace loskoppelen die u momenteel niet gebruikt laat uw gesprek ongemoeid, en de actieve loskoppelen schakelt de chat naar een andere gekoppelde workspace.

## Goed om te weten

* **Geen bot-setup nodig.** U hoeft geen eigen Telegram-bot te maken of een API-sleutel te verkrijgen. Verbind gewoon via Instellingen en begin met chatten.
* **Credits werken hetzelfde als in de webapp.** Het werk van de agent verbruikt credits aan hetzelfde tarief als in de webapp, plus een kleine extra hoeveelheid bij het versturen van spraakberichten (voor de transcriptie).
* **Tot 3 workspaces per Telegram-account.** U kunt uw Telegram-account aan meerdere Macaly-workspaces koppelen (maximaal 3) en er met `/switch` tussen wisselen. Elk workspacelid kan daarnaast zijn eigen account verbinden.
* **Maximale grootte van spraakberichten.** Spraakberichten kunnen tot 10 MB groot zijn. Langere opnames komen niet door.
