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

> Chatte mit dem Macaly-Agenten über Telegram

Mit der Telegram-Verbindung von Macaly kannst du mit dem Macaly-Agenten von deinem Telefon aus chatten. Sende eine Nachricht in Telegram, erhalte eine Antwort und arbeite an deinen Projekten weiter, ohne die Web-App zu öffnen.

## Was du tun kannst

Der Agent in Telegram arbeitet an denselben Projekten, die du in der Web-App erstellst. Alles, was du den Agenten normalerweise bitten würdest, kannst du auch von Telegram aus anfragen:

* **Ein neues Projekt starten.** Beschreibe, was du erstellen möchtest, und der Agent macht sich an die Arbeit, genau wie in der Web-App.
* **Deine bestehenden Projekte bearbeiten.** Bitte um Änderungen, Korrekturen oder neue Abschnitte. Wenn du mehrere Projekte hast und nicht angibst, welches gemeint ist, fragt dich der Agent nach.
* **Veröffentlichen und verwalten.** Veröffentliche ein Projekt, ändere seine Subdomain oder prüfe, was live ist.
* **Schnelle Fragen stellen.** Erhalte Hilfe, Ideen oder Status-Updates, ohne deinen Arbeitsfluss zu unterbrechen.

Wenn der Agent Änderungen vornimmt, sendet er dir einen Vorschau-Link, sodass du das Ergebnis prüfen kannst, ohne Telegram zu verlassen.

## Was du senden kannst

Der Agent arbeitet aktuell mit:

* **Textnachrichten.** Einfach tippen und senden.
* **Sprachnachrichten.** Macaly transkribiert sie und antwortet. Nützlich, wenn Tippen nicht praktikabel ist.
* **Bilder.** Sende Screenshots, Mockups oder Referenzen, die sich der Agent ansehen soll.
* **Dateien.** PDFs und Dokumente, die der Agent lesen und verwenden kann.

Videos werden noch nicht unterstützt. Antworten kommen als reiner Text ohne erweiterte Formatierung oder Link-Vorschauen zurück.

## So richtest du es ein

<Steps>
  <Step title="Öffne die Verbindungseinstellungen">
    Gehe in Macaly zu **Einstellungen → Verbindungen** und klicke auf **Verbinden** bei der Telegram-Karte.

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

  <Step title="Öffne Telegram">
    Macaly zeigt einen QR-Code und einen Verbindungslink an. Scanne den QR-Code mit deinem Telefon oder klicke auf **Telegram öffnen**, um es auf deinem Computer oder Telefon mit dem vorausgefüllten Verbindungscode zu starten.
  </Step>

  <Step title="Drücke Start">
    Telegram öffnet einen Chat mit dem Macaly-Bot und der vorausgefüllten Nachricht `/start [CODE]`. Drücke **Start** (oder sende die Nachricht), um dich zu verbinden.
  </Step>

  <Step title="Beginne zu chatten">
    Macaly bestätigt die Verbindung und zeigt das Konto an, mit dem sie verknüpft ist. Du kannst dem Agenten jetzt jederzeit über Telegram schreiben.
  </Step>
</Steps>

Der Verbindungscode ist 15 Minuten lang gültig. Wenn er abläuft, generiere einen neuen über die Verbindungseinstellungen.

## Bot-Befehle

Sende einen dieser Befehle in deinem Telegram-Chat mit Macaly:

| Befehl | Was er bewirkt |
| - | - |
| `/new` | Startet einen neuen Unterhaltungsthread mit dem Agenten. |
| `/switch` | Wechselt zu einem anderen verbundenen Workspace (wird angezeigt, wenn mehr als einer verbunden ist). |
| `/status` | Prüft den Status deiner Verbindung und des aktuellen Chats. |
| `/unlink` | Trennt einen Workspace von diesem Chat. Wenn mehrere verbunden sind, wählst du aus, welcher. |
| `/help` | Listet die verfügbaren Befehle auf. |

## Mehrere Workspaces nutzen

Du kannst dasselbe Telegram-Konto mit mehr als einem Macaly-Workspace verbinden, bis zu 3 gleichzeitig. Das ist praktisch, wenn du in mehreren Workspaces arbeitest und alle über einen einzigen Chat erreichen möchtest.

* **Einen weiteren Workspace verbinden.** Öffne **Einstellungen → Verbindungen** im anderen Workspace und verbinde ihn über dasselbe Telegram-Konto.
* **Den aktiven Workspace wechseln.** Sende `/switch` und wähle einen Workspace aus der Liste aus. Deine nächste Nachricht startet dort eine neue Unterhaltung.
* **Sehen, welcher aktiv ist.** Sende `/status` — die Antwort beginnt mit dem Namen des aktiven Workspace.

Es ist jeweils nur ein Workspace aktiv, sodass Nachrichten an den Workspace gehen, zu dem du zuletzt gewechselt hast. Wenn du den aktiven Workspace trennst, wechselt Macaly den Chat automatisch zu einem anderen verbundenen Workspace, damit er weiter funktioniert.

## Trennen

Um die Verbindung zu trennen, sende entweder `/unlink` von Telegram aus oder öffne **Einstellungen → Verbindungen** in der App und entferne das verbundene Konto.

Wenn der Chat nur mit einem Workspace verbunden ist, wird er sofort getrennt. Wenn mehrere verbunden sind, fragt `/unlink`, welcher entfernt werden soll — das Trennen eines Workspace, den du gerade nicht nutzt, lässt deine Unterhaltung unberührt, und das Trennen des aktiven Workspace wechselt den Chat zu einem anderen verbundenen Workspace.

## Gut zu wissen

* **Keine Bot-Einrichtung erforderlich.** Du musst keinen eigenen Telegram-Bot erstellen oder einen API-Schlüssel besorgen. Verbinde dich einfach über Einstellungen und beginne zu chatten.
* **Credits funktionieren genauso wie in der Web-App.** Die Arbeit des Agenten verbraucht Credits zum gleichen Satz wie in der Web-App, plus einen kleinen zusätzlichen Betrag, wenn du Sprachnachrichten sendest (für die Transkription).
* **Bis zu 3 Workspaces pro Telegram-Konto.** Du kannst dein Telegram-Konto mit mehreren Macaly-Workspaces verknüpfen (maximal 3) und mit `/switch` zwischen ihnen wechseln. Jedes Workspace-Mitglied kann auch sein eigenes Konto verbinden.
* **Größenlimit für Sprachnachrichten.** Sprachnachrichten können bis zu 10 MB groß sein. Längere Aufnahmen werden nicht übertragen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.