> ## 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 > Converse com o agente do Macaly pelo Telegram A conexão do Macaly com o Telegram permite conversar com o agente do Macaly direto do celular. Envie uma mensagem no Telegram, receba a resposta e continue trabalhando nos seus projetos sem abrir o app web. ## O que você pode fazer O agente do Telegram trabalha nos mesmos projetos que você cria no app web. Tudo o que você normalmente pediria ao agente, você pode pedir pelo Telegram: * **Iniciar um novo projeto.** Descreva o que você quer criar e o agente começa a trabalhar, como no app web. * **Editar seus projetos existentes.** Peça alterações, correções ou novas seções. Se você tem vários projetos e não diz qual, o agente pergunta. * **Publicar e gerenciar.** Publique um projeto, altere o subdomínio dele ou confira o que está no ar. * **Tirar dúvidas rápidas.** Peça ajuda, ideias ou atualizações de status sem quebrar seu ritmo. Quando o agente faz alterações, ele envia um link de prévia para você conferir o resultado sem sair do Telegram. ## O que você pode enviar No momento, o agente trabalha com: * **Mensagens de texto.** Basta digitar e enviar. * **Mensagens de voz.** O Macaly as transcreve e responde. Útil quando digitar não é prático. * **Imagens.** Envie capturas de tela, mockups ou referências para o agente analisar. * **Arquivos.** PDFs e documentos que o agente pode ler e usar. Vídeos ainda não são compatíveis. As respostas chegam em texto simples, sem formatação e sem prévia de links. ## Como configurar No Macaly, acesse **Configurações → Conexões** e clique em **Conectar** no cartão do Telegram. Cartão do Telegram nas configurações de Conexões O Macaly mostra um QR code e um link de conexão. Escaneie o QR code com o celular ou clique em **Abrir Telegram** para abri-lo no computador ou no celular com o código de conexão já preenchido. O Telegram abre uma conversa com o bot do Macaly e a mensagem `/start [CODE]` já preenchida. Toque em **Iniciar** (ou envie a mensagem) para conectar. O Macaly confirma a conexão e mostra a conta à qual ela está vinculada. A partir de agora, você pode enviar mensagens ao agente pelo Telegram quando quiser. O código de conexão vale por 15 minutos. Se ele expirar, gere um novo nas configurações de Conexões. ## Comandos do bot Envie qualquer um destes na sua conversa do Telegram com o Macaly: | Comando | O que faz | | - | - | | `/new` | Inicia uma nova conversa com o agente. | | `/switch` | Troca para outro workspace conectado (aparece quando há mais de um vinculado). | | `/status` | Verifica o status da sua conexão e do chat atual. | | `/unlink` | Desconecta um workspace desta conversa. Se houver vários conectados, você escolhe qual. | | `/help` | Lista os comandos disponíveis. | ## Usando vários workspaces Você pode conectar a mesma conta do Telegram a mais de um workspace do Macaly, até 3 ao mesmo tempo. Isso é útil se você trabalha com vários workspaces e quer acessar todos eles a partir de uma única conversa. * **Conecte outro workspace.** Abra **Configurações → Conexões** no outro workspace e conecte-o pela mesma conta do Telegram. * **Troque o workspace ativo.** Envie `/switch` e escolha um workspace na lista. Sua próxima mensagem inicia uma conversa nova nele. * **Veja qual está ativo.** Envie `/status`. A resposta começa com o nome do workspace ativo. Só um workspace fica ativo por vez, então as mensagens vão para o último workspace que você selecionou. Se você desconectar o workspace ativo, o Macaly passa a conversa automaticamente para outro workspace conectado, para que tudo continue funcionando. ## Desconectando Para desconectar, envie `/unlink` pelo Telegram ou abra **Configurações → Conexões** no app e remova a conta conectada. Se a conversa estiver conectada a apenas um workspace, ela é desconectada na hora. Se houver vários conectados, o `/unlink` pergunta qual remover. Desconectar um workspace que você não está usando não altera sua conversa, e desconectar o ativo passa a conversa para outro workspace conectado. ## Bom saber * **Não é preciso configurar um bot.** Você não precisa criar seu próprio bot do Telegram nem obter uma chave de API. Basta conectar pelas Configurações e começar a conversar. * **Os créditos funcionam como no app web.** O trabalho do agente consome créditos na mesma taxa do app web, mais uma pequena quantia extra quando você envia mensagens de voz (pela transcrição). * **Até 3 workspaces por conta do Telegram.** Você pode vincular sua conta do Telegram a vários workspaces do Macaly (no máximo 3) e alternar entre eles com `/switch`. Cada membro do workspace também pode conectar a 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 serão enviadas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.