Skip to main content
Gateways ligam o Alter a bots do Discord e do Telegram para conversar com o Alter a partir dessas apps. Cada gateway corre localmente no seu Mac — o Alter tem de estar aberto e a correr para as mensagens serem processadas.
Gateways (bots Discord/Telegram) são diferentes do API Gateway em Definições → Router, que expõe um endpoint compatível com OpenAI para apps de terceiros. Consulte o Guia do API Gateway para essa funcionalidade.

​
O que os Gateways fazem

Gateways permitem usar o Alter a partir de plataformas de chat que já tem abertas:
  • 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.
Cada instância de gateway tem o seu nome, Ação predefinida, controlos de acesso e definições de ligação. As conversas são guardadas no Alter no seu Mac da mesma forma que os chats do Hub — os gateways são outra forma de iniciar e continuar essas conversas. Quando alguém envia uma mensagem, o Alter:
  1. Recebe-a através da ligação do bot da plataforma.
  2. Executa a Alter Action selecionada (por exemplo Ask Anything).
  3. Transmite a resposta de volta para o canal Discord ou chat Telegram.
  4. 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.
Também pode usar a ligação direta: com.wearedevx.alter://settings?id=gateways A página Gateways mostra todos os gateways configurados. Use Adicionar gateway para criar uma ligação Discord ou Telegram.

​
Guias de configuração

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.
Desligar o interruptor principal mantém a permissão de administrador instalada, para poder ativá-la de novo sem novo pedido. Use Remover permissão de administrador… em Opções… quando quiser revogá-la por completo.
A disponibilidade com tampa fechada altera uma definição protegida de repouso do macOS. O Alter também executa um monitor de segurança que restaura o repouso normal se a app parar inesperadamente. Os Gateways ainda exigem que o Alter esteja a correr — esta funcionalidade mantém o Mac acordado, não o Alter fechado.

​
Que actions funcionam nos Gateways?

As actions optam por plataformas externas. No Action Editor, abra a secção Gateways e escolha Disponibilidade:
A action incluída Ask Anything tem Todos por predefinição — é a Ação predefinida habitual para novos gateways. Defina Nenhum no Ask Anything se quiser apenas local. Actions personalizadas começam em Nenhum até ativar uma plataforma ou Todos.
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. As pessoas ainda podem mudar de action por conversa com /new [action] ou o seletor Choose action, desde que essa 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
Discord e Telegram suportam os mesmos comandos de texto (escreva-os como mensagens normais). No Telegram, os comandos também funcionam com sufixo de bot como /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

  1. 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.
  2. Envie mensagem ao bot no Discord ou Telegram (ou @mention no Discord quando Exigir menção em servidores estiver ativo).
  3. 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.
  4. 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.
  5. 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.

​
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.
  • O processamento de mensagens usa a mesma stack local do Alter que o Hub — não há retransmissão na cloud separada para tráfego de gateway.
Consulte também Dados locais e privacidade.

​
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 message e callback_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.
Para problemas mais amplos de tools e permissões, use Definições → Doctor ou Tools not working. O Doctor inclui uma secção Gateways com connection status por gateway (connected, reconnecting, failed) e avisos de access quando nenhuma allowlist está configurada num gateway ativo. O Doctor inclui uma secção Gateways com connection status por gateway (connected, reconnecting, failed) e avisos de access quando nenhuma allowlist está configurada num gateway ativo.

​
Páginas relacionadas