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.

​
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.
Apenas Buzz: Defina Default scheduled destination no gateway quando uma action deve recorrer a um destino sem o nomear de cada vez. Ver Buzz gateway (internal).
Se um destino guardado deixar de estar acessível, atualize destinos no Action Editor ou nas definições do gateway antes da próxima execução programada.

​
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