Gateways permitem usar o Alter a partir de agentes de IA compatíveis com MCP, Discord e Telegram. O Alter executa ferramentas e actions no Mac e tem de continuar aberto para processar pedidos.
O que os Gateways fazem
Gateways permitem usar o Alter a partir de plataformas de chat e agentes de IA:- MCP Gateway — Ligue um agente de IA compatível para pesquisar reuniões, executar actions permitidas e conversar com o Alter. Consulte configuração Remote MCP ou o guia do plugin ChatGPT.
- Discord — Envie DM ao bot ou mencione-o num canal de servidor (quando configurado).
- Telegram — Envie mensagens ao bot num chat privado ou num grupo.
- Recebe-a através da ligação do bot da plataforma.
- Executa a Alter Action selecionada (por exemplo Ask Anything).
- Transmite a resposta de volta para o canal Discord ou chat Telegram.
- Pode transferir anexos recebidos e carregar ficheiros de saída de execuções de tools.
Abrir definições de Gateways
1
Abrir Settings
Prima ⌘, (Command + Vírgula), clique no ícone do Alter na barra de menus e escolha Definições…, ou abra Definições no menu ⋯ do notch.
2
Ir a Integrations → Gateways
Na barra lateral de definições, abra Integrations e selecione Gateways.
com.wearedevx.alter://settings?id=gateways
A página Gateways mostra todos os gateways configurados. Use Adicionar gateway para criar uma ligação MCP Gateway, Discord ou Telegram.
Guias de configuração
Servidor Remote MCP
Ligue um agente de IA compatível com o URL MCP privado do Alter.
Alter no ChatGPT
Ative o MCP Gateway, instale o plugin desktop e escolha o acesso permitido.
Discord gateway
Crie um bot Discord, ative intents, convide-o para o seu servidor e ligue-o no Alter.
Telegram gateway
Crie um bot com BotFather e cole o token no Alter.
Referência de definições de gateway
Todos os gateways partilham estes campos:
Campos de Ligação específicos da plataforma estão documentados nos guias de configuração:
Depois de guardar um gateway ativo, o Alter mostra uma linha de estado como Ligado como @username ou um erro com o qual pode agir.
Manter gateways online com a tampa fechada
Num MacBook, fechar a tampa normalmente coloca o Mac em repouso e desliga os bots gateway. O Alter pode manter gateways ativos disponíveis com a tampa fechada. No topo de Definições → Integrations → Gateways:Salvaguardas de bateria
O Alter pausa a disponibilidade com tampa fechada automaticamente para proteger a autonomia:- Pausar abaixo de — Enquanto o Mac está desligado da corrente e a descarregar, o Alter restaura o repouso normal neste nível ou abaixo (predefinição 20%, ajustável de 5% a 50% em passos de 5%). A disponibilidade com tampa fechada volta após carregar acima do limite.
- Pausar em Modo de baixo consumo — Sempre respeitado enquanto o Low Power Mode do macOS estiver ativo.
Que actions funcionam nos Gateways?
As actions optam por plataformas externas. No Action Editor, abra a secção Gateways e escolha Disponibilidade:
Em Definições → Integrations → Gateways, cada gateway mostra uma lista Ações disponíveis para a sua plataforma. Use-a para confirmar quais actions estão ativas e abrir Action Editor → Gateways para qualquer action listada.
No Discord e no Telegram, as pessoas podem mudar de action por conversa com
/new [action] ou o seletor Choose action, desde que a action seja permitida na plataforma.
Actions sem parâmetros vs. com parâmetros
Quando alguém escolhe uma action em Choose action (ou/actions):
- Actions sem parâmetros (sem campos de entrada no Action Editor) começam de imediato — o Alter executa a action com o prompt configurado, como um arranque com um clique no Hub.
- Actions com parâmetros (com campos de entrada) iniciam uma nova conversa e aguardam a mensagem seguinte para o utilizador fornecer esses inputs.## Comandos de chat e controlos
/help@YourBotName.
No Discord, o Alter também regista slash commands nativos (
/help, /new, /actions, /chats, /history, /stop, /status) quando o bot liga. Se definir Server ID, os comandos registam-se apenas nesse servidor; caso contrário, registam-se globalmente para a aplicação do bot.
Ambas as plataformas expõem botões para tarefas comuns — por exemplo New chat, Choose action e Past chats em /help. O Telegram usa teclados inline; o Discord usa componentes de mensagem. Quando uma action usa a tool Ask User, o Alter apresenta perguntas de escolha múltipla através desses mesmos controlos interativos (e aceita respostas escritas para respostas «Other»).
Qualquer mensagem que não seja um comando é tratada como turno de chat na conversa atual.
Utilização diária
- Mantenha o Alter a correr no Mac com o gateway Ativado. Num MacBook, ative Manter Gateways online com a tampa fechada se quiser que os bots permaneçam ligados com a tampa fechada.
- Envie mensagem ao bot no Discord ou Telegram (ou
@mentionno Discord quando Exigir menção em servidores estiver ativo). - O Alter mostra um placeholder Thinking… enquanto a action corre, depois atualiza com a resposta transmitida. Em DMs Telegram, o Alter pode transmitir através do rascunho nativo do Telegram quando suportado; em grupos edita uma mensagem normal.
- Anexe ficheiros no Discord ou Telegram — o Alter transfere-os para o turno e pode carregar ficheiros de saída de tools. Mensagens de voz e ficheiros de áudio são transcritos com o processador de voz selecionado (Definições → Voice) e enviados ao Alter como texto; áudio mais longo também é anexado como contexto de transcrição estilo reunião.
- Use
/stop, o botão Stop (grupos Telegram e Discord) ou aguarde o fim do turno antes de enviar outra mensagem no mesmo canal ou chat.
Uma resposta de cada vez
O Alter trata uma resposta em curso por canal ou chat. Se chegar uma segunda mensagem enquanto o Alter ainda responde, o bot indica que o Alter já está a responder nesse canal ou chat. Aguarde o fim do turno atual e envie de novo.Continuidade de conversa
Cada canal Discord ou chat Telegram pode ter uma conversa Alter ativa. Use/new para começar de novo, ou /chats e /use para retomar uma conversa Alter existente no Mac.
No Discord, ativar Iniciar discussões do servidor em threads dá a cada nova mensagem de topo do servidor o seu thread e chat Alter. Respostas dentro de um thread existente continuam esse chat em vez de iniciar outro.
Saída programada de actions em Gateways
Alter Actions programadas podem publicar a resposta inicial automática num gateway ligado em vez de ficarem apenas no Hub.1
Ativar a action num gateway
Abra a action em Action Editor → Gateways e defina Availability para a plataforma, ative os toggles de gateway necessários ou use All.
2
Ativar entrega programada via gateway
Ative Start scheduled conversations on a gateway, escolha um gateway Discord, Telegram ou Buzz (interno) ativado e depois um Destination (canal de servidor, chat Telegram ou stream/fórum/DM Buzz).
3
Guardar e testar
Guarde a action e execute ou aguarde o horário. O Alter entrega a resposta inicial ao destino selecionado com anexos de saída.
Privacidade e dados
- Token do bots são guardados no macOS Keychain, não em ficheiros de definições em texto simples.
- A configuração de gateway (nomes, listas de acesso, default actions) fica localmente nas preferências do Alter no Mac.
- O estado por canal (conversa selecionada, action pendente) fica na pasta Application Support do Alter.
- As ferramentas e actions são executadas no Alter no Mac. O MCP Gateway usa um relay do Alter para pedidos e resultados, incluindo texto de transcrições quando solicitado. Os agentes ligados recebem os dados cuja leitura foi permitida.
Resolução de problemas
Ligação e tokens
Utilização
Disponibilidade com tampa fechada
Notas de plataforma
- O Alter tem de estar a correr — fechar o Alter para os bots gateway até reabrir a app. Num MacBook, Manter Gateways online com a tampa fechada mantém o Mac acordado enquanto os gateways correm, mas o Alter ainda precisa de permanecer aberto.
- Mensagens de bots são ignoradas em ambas as plataformas.
- Discord adiciona 👀 enquanto processa a mensagem, depois ✅ ou ❌ quando o turno termina. Reações adicionadas por utilizadores não são tratadas como comandos ou entrada de chat.
- Telegram usa long polling para atualizações
messageecallback_query(toques em teclado inline). Após um turno, o Alter pode reagir com 👍 ou 👎 à sua mensagem. Chats de grupo mostram botão Stop durante turnos ativos.
Páginas relacionadas
- Configurar um Discord gateway
- Configurar um Telegram gateway
- Alter Actions — Disponibilidade em Gateways — configurar actions e disponibilidade em gateways
- Alter Settings
- Visão geral das integrações
- Guia do API Gateway — API compatível com OpenAI (separada dos Gateways de chat)