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

> Discutez avec l'agent Macaly via Telegram

La connexion Telegram de Macaly vous permet de discuter avec l'agent Macaly depuis votre téléphone. Envoyez un message dans Telegram, recevez une réponse et continuez à travailler sur vos projets sans ouvrir l'application web.

## Ce que vous pouvez faire

L'agent Telegram travaille sur les mêmes projets que ceux que vous créez dans l'application web. Tout ce que vous demanderiez normalement à l'agent, vous pouvez le demander depuis Telegram :

* **Démarrer un nouveau projet.** Décrivez ce que vous voulez créer et l'agent se met au travail, comme dans l'application web.
* **Modifier vos projets existants.** Demandez des changements, des corrections ou de nouvelles sections. Si vous avez plusieurs projets et que vous ne précisez pas lequel, l'agent vous le demande.
* **Publier et gérer.** Publiez un projet, changez son sous-domaine, ou vérifiez ce qui est en ligne.
* **Poser des questions rapides.** Obtenez de l'aide, des idées ou des informations sur l'état d'avancement sans interrompre votre flux de travail.

Lorsque l'agent effectue des changements, il vous envoie un lien d'aperçu pour que vous puissiez vérifier le résultat sans quitter Telegram.

## Ce que vous pouvez envoyer

L'agent gère actuellement :

* **Messages texte.** Tapez et envoyez.
* **Messages vocaux.** Macaly les transcrit et répond. Pratique quand taper n'est pas commode.
* **Images.** Envoyez des captures d'écran, des maquettes ou des références que l'agent doit examiner.
* **Fichiers.** PDF et documents que l'agent peut lire et utiliser.

Les vidéos ne sont pas encore prises en charge. Les réponses arrivent en texte brut, sans mise en forme ni aperçus enrichis.

## Comment configurer la connexion

<Steps>
  <Step title="Ouvrez les paramètres Connexions">
    Dans Macaly, allez dans **Paramètres → Connexions** et cliquez sur **Connecter** sur la carte 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="Ouvrez Telegram">
    Macaly affiche un QR code et un lien de connexion. Scannez le QR code avec votre téléphone, ou cliquez sur **Ouvrir Telegram** pour le lancer sur votre ordinateur ou téléphone avec le code de connexion pré-rempli.
  </Step>

  <Step title="Appuyez sur Start">
    Telegram ouvre une discussion avec le bot Macaly avec le message `/start [CODE]` pré-rempli. Appuyez sur **Start** (ou envoyez le message) pour vous connecter.
  </Step>

  <Step title="Commencez à discuter">
    Macaly confirme la connexion et affiche le compte auquel elle est liée. Vous pouvez désormais écrire à l'agent à tout moment depuis Telegram.
  </Step>
</Steps>

Le code de connexion est valable 15 minutes. S'il expire, générez-en un nouveau depuis les paramètres Connexions.

## Commandes du bot

Envoyez l'une de ces commandes dans votre chat Telegram avec Macaly :

| Commande | Ce qu'elle fait |
| - | - |
| `/new` | Démarre un nouveau fil de conversation avec l'agent. |
| `/switch` | Bascule vers un autre workspace connecté (affiché lorsque plusieurs sont liés). |
| `/status` | Affiche l'état de votre connexion et du chat en cours. |
| `/unlink` | Déconnecte un workspace de ce chat. Si plusieurs sont connectés, vous choisissez lequel. |
| `/help` | Liste les commandes disponibles. |

## Utiliser plusieurs workspaces

Vous pouvez connecter le même compte Telegram à plusieurs workspaces Macaly — jusqu'à 3 à la fois. Pratique si vous travaillez sur plusieurs workspaces et souhaitez tous les atteindre depuis un seul chat.

* **Connecter un autre workspace.** Ouvrez **Paramètres → Connexions** dans l'autre workspace et connectez-le depuis le même compte Telegram.
* **Changer de workspace actif.** Envoyez `/switch` et choisissez un workspace dans la liste. Votre prochain message y démarre une nouvelle conversation.
* **Voir lequel est actif.** Envoyez `/status` — il commence par le nom du workspace actif.

Un seul workspace est actif à la fois : vos messages vont vers celui vers lequel vous avez basculé en dernier. Si vous déconnectez le workspace actif, Macaly bascule automatiquement le chat vers un autre workspace connecté pour qu'il continue de fonctionner.

## Déconnexion

Pour vous déconnecter, envoyez `/unlink` depuis Telegram, ou ouvrez **Paramètres → Connexions** dans l'application et retirez le compte connecté.

Si le chat n'est connecté qu'à un seul workspace, il se déconnecte immédiatement. Si plusieurs sont connectés, `/unlink` demande lequel retirer — déconnecter un workspace que vous n'utilisez pas actuellement laisse votre conversation intacte, et déconnecter le workspace actif bascule le chat vers un autre workspace connecté.

## Bon à savoir

* **Aucune configuration de bot requise.** Vous n'avez pas besoin de créer votre propre bot Telegram ni d'obtenir de clé API. Connectez-vous simplement depuis Paramètres et commencez à discuter.
* **Les crédits fonctionnent comme dans l'application web.** Le travail de l'agent consomme des crédits au même taux que dans l'application web, plus un petit supplément lorsque vous envoyez des messages vocaux (pour la transcription).
* **Jusqu'à 3 workspaces par compte Telegram.** Vous pouvez lier votre compte Telegram à plusieurs workspaces Macaly (3 au maximum) et basculer entre eux avec `/switch`. Chaque membre du workspace peut aussi connecter son propre compte.
* **Limite de taille des messages vocaux.** Les messages vocaux peuvent atteindre 10 Mo. Les enregistrements plus longs ne passent pas.


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