> ## 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 > Conversa com o agente Macaly através do Telegram A ligação Telegram do Macaly permite-te conversar com o agente Macaly a partir do teu telemóvel. Envia uma mensagem no Telegram, recebe uma resposta e continua a trabalhar nos teus projetos sem abrires a app web. ## O que podes fazer O agente no Telegram trabalha nos mesmos projetos que crias na app web. Tudo o que normalmente pedirias ao agente, podes pedir a partir do Telegram: * **Iniciar um novo projeto.** Descreve o que queres criar e o agente põe-se a trabalhar, tal como na app web. * **Editar os teus projetos existentes.** Pede alterações, correções ou novas secções. Se tiveres vários projetos e não disseres qual, o agente pergunta. * **Publicar e gerir.** Publica um projeto, muda o seu subdomínio ou verifica o que está em produção. * **Fazer perguntas rápidas.** Recebe ajuda, ideias ou atualizações de estado sem interromperes o teu fluxo de trabalho. Quando o agente faz alterações, envia-te um link de pré-visualização para verificares o resultado sem saíres do Telegram. ## O que podes enviar Atualmente, o agente funciona com: * **Mensagens de texto.** Basta escrever e enviar. * **Mensagens de voz.** O Macaly transcreve-as e responde. Útil quando escrever não é prático. * **Imagens.** Envia capturas de ecrã, mockups ou referências que o agente deve analisar. * **Ficheiros.** PDFs e documentos que o agente pode ler e usar. Vídeos ainda não são suportados. As respostas chegam como texto simples, sem formatação avançada nem pré-visualizações de links. ## Como configurar No Macaly, vai a **Definições → Ligações** e clica em **Ligar** no cartão do Telegram. Cartão do Telegram nas definições de Ligações O Macaly mostra um código QR e um link de ligação. Digitaliza o código QR com o teu telemóvel, ou clica em **Abrir Telegram** para o abrires no teu computador ou telemóvel com o código de ligação já preenchido. O Telegram abre um chat com o bot do Macaly e a mensagem `/start [CODE]` já preenchida. Prime **Iniciar** (ou envia a mensagem) para ligares. O Macaly confirma a ligação e mostra a conta a que está associada. Podes agora enviar mensagens ao agente a qualquer momento a partir do Telegram. O código de ligação é válido durante 15 minutos. Se expirar, gera um novo a partir das definições de Ligações. ## Comandos do bot Envia qualquer um destes comandos no teu chat do Telegram com o Macaly: | Comando | O que faz | | - | - | | `/new` | Inicia uma nova conversa com o agente. | | `/switch` | Muda para outro espaço de trabalho ligado (aparece quando há mais de um associado). | | `/status` | Verifica o estado da tua ligação e do chat atual. | | `/unlink` | Desliga um espaço de trabalho deste chat. Se houver vários ligados, escolhes qual. | | `/help` | Lista os comandos disponíveis. | ## Usar vários espaços de trabalho Podes ligar a mesma conta Telegram a mais do que um espaço de trabalho Macaly, até 3 em simultâneo. É útil se trabalhas em vários espaços de trabalho e queres alcançá-los todos a partir de um único chat. * **Ligar outro espaço de trabalho.** Abre **Definições → Ligações** no outro espaço de trabalho e liga-o a partir da mesma conta Telegram. * **Mudar o espaço de trabalho ativo.** Envia `/switch` e escolhe um espaço de trabalho na lista. A tua próxima mensagem inicia uma nova conversa aí. * **Ver qual está ativo.** Envia `/status`, a resposta começa com o nome do espaço de trabalho ativo. Apenas um espaço de trabalho está ativo de cada vez, por isso as mensagens vão para aquele para o qual mudaste pela última vez. Se desligares o espaço de trabalho ativo, o Macaly muda automaticamente o chat para outro espaço de trabalho ligado, para que continue a funcionar. ## Desligar Para desligar, envia `/unlink` a partir do Telegram, ou abre **Definições → Ligações** na app e remove a conta ligada. Se o chat estiver ligado a apenas um espaço de trabalho, é desligado de imediato. Se houver vários ligados, o `/unlink` pergunta qual remover: desligar um espaço de trabalho que não estás a usar atualmente deixa a tua conversa intacta, e desligar o ativo muda o chat para outro espaço de trabalho ligado. ## Bom saber * **Sem configuração de bot necessária.** Não precisas de criar o teu próprio bot do Telegram nem obter uma chave API. Basta ligares a partir de Definições e começares a conversar. * **Os créditos funcionam da mesma forma que na app web.** O trabalho do agente consome créditos à mesma taxa que na app web, mais uma pequena quantia extra quando envias mensagens de voz (para transcrição). * **Até 3 espaços de trabalho por conta Telegram.** Podes associar a tua conta Telegram a vários espaços de trabalho Macaly (no máximo 3) e alternar entre eles com `/switch`. Cada membro do espaço de trabalho também pode ligar a sua própria conta. * **Limite de tamanho das mensagens de voz.** As mensagens de voz podem ter até 10 MB. Gravações mais longas não são enviadas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.