Gateways

​

Qué hacen los Gateways

Los Gateways te permiten usar Alter desde plataformas de chat que ya tienes abiertas:

• Discord — Envía un DM al bot o menciónalo en un canal del servidor (cuando esté configurado).
• Telegram — Envía mensajes al bot en un chat privado o en un grupo.

Cada instancia de gateway tiene su propio nombre, Acción predeterminada, controles de acceso y ajustes de conexión. Las conversaciones se guardan en Alter en tu Mac igual que los chats del Hub — los gateways son otra forma de iniciar y continuar esas conversaciones. Cuando alguien envía un mensaje, Alter:

1. Lo recibe a través de la conexión del bot de la plataforma.
2. Ejecuta la Alter Action seleccionada (por ejemplo Ask Anything).
3. Transmite la respuesta de vuelta al canal de Discord o al chat de Telegram.
4. Puede descargar archivos adjuntos entrantes y subir archivos de salida de las ejecuciones de tools.

​

Abrir ajustes de Gateways

También puedes usar el enlace directo: com.wearedevx.alter://settings?id=gateways La página Gateways muestra todos los gateways configurados. Usa Añadir gateway para crear una conexión Discord o Telegram.

​

Guías de configuración

​

Referencia de ajustes de gateway

Todos los gateways comparten estos campos: Los campos Conexión específicos de la plataforma están documentados en las guías de configuración:

• Campos de conexión Discord
• Campos de conexión Telegram

Después de guardar un gateway activado, Alter muestra una línea de estado como Conectado como @username o un error con el que puedes actuar.

​

Mantener Gateways en línea con la tapa cerrada

En un MacBook, cerrar la tapa normalmente pone el Mac en suspensión y desconecta los bots gateway. Alter puede mantener los gateways activos disponibles con la tapa cerrada. En la parte superior de Configuración → Integraciones → Gateways:

​

Protecciones de batería

Alter pausa la disponibilidad con tapa cerrada automáticamente para proteger la autonomía:

• Pausar por debajo de — Mientras el Mac está desenchufado y descargando, Alter restaura la suspensión normal en o por debajo de este nivel (predeterminado 20%, ajustable de 5% a 50% en pasos de 5 %). La disponibilidad con tapa cerrada vuelve tras cargar por encima del límite.
• Pausar en Modo de bajo consumo — Siempre respetado mientras el Low Power Mode de macOS esté activo.

Desactivar el interruptor principal mantiene el permiso de administrador instalado, para poder activarlo de nuevo sin otra solicitud. Usa Eliminar permiso de administrador… en Opciones… cuando quieras revocarlo por completo.

​

Qué acciones funcionan en Gateways

Las actions optan por plataformas externas. En el Action Editor, abre la sección Gateways y elige Disponibilidad: En Configuración → Integrations → Gateways, cada gateway muestra una lista Acciones disponibles para su plataforma. Úsala para confirmar qué actions están activas y abrir Action Editor → Gateways para cualquier action listada. Las personas aún pueden cambiar de action por conversación con /new [action] o el selector Choose action, siempre que esa action esté permitida en la plataforma.

​

Actions sin parámetros vs. parametrizadas

Cuando alguien elige una action desde Choose action (o /actions):

• Las actions sin parámetros (sin campos de entrada en el Action Editor) arrancan de inmediato — Alter ejecuta la action con su prompt configurado, igual que un lanzamiento con un clic en el Hub.
• Las actions parametrizadas (con campos de entrada) inician una nueva conversación y esperan el siguiente mensaje para que el usuario proporcione esos inputs.## Comandos y controles de chat

Discord y Telegram admiten los mismos comandos de texto (escríbelos como mensajes normales). En Telegram, los comandos también funcionan con un sufijo de bot como /help@YourBotName. En Discord, Alter también registra slash commands nativos (/help, /new, /actions, /chats, /history, /stop, /status) cuando el bot se conecta. Si defines un Server ID, los comandos se registran solo para ese servidor; de lo contrario, se registran globalmente para la aplicación del bot. Ambas plataformas también exponen botones para tareas comunes — por ejemplo New chat, Choose action y Past chats en /help. Telegram usa teclados inline; Discord usa componentes de mensaje. Cuando una action usa la tool Ask User, Alter presenta preguntas de opción múltiple a través de esos mismos controles interactivos (y acepta respuestas escritas para respuestas «Other»). Cualquier mensaje que no sea un comando se trata como un turno de chat en la conversación actual.

​

Uso diario

1. Mantén Alter en ejecución en tu Mac con el gateway Activado. En un MacBook, activa Mantener Gateways en línea con la tapa cerrada si quieres que los bots permanezcan conectados con la tapa cerrada.
2. Envía un mensaje al bot en Discord o Telegram (o @mention en servidores Discord cuando Requerir mención en servidores esté activo).
3. Alter muestra un placeholder Thinking… mientras la action se ejecuta, luego se actualiza con la respuesta transmitida. En DM de Telegram, Alter puede transmitir a través de la vista previa de borrador nativa de Telegram cuando esté soportado; en grupos edita un mensaje normal.
4. Adjunta archivos en Discord o Telegram — Alter los descarga para el turno y puede subir archivos de salida de tools. Los voice messages y audio files se transcriben con el procesador de voz seleccionado (Configuración → Voice) y se envían a Alter como texto; el audio más largo también se adjunta como contexto de transcripción tipo reunión.
5. Usa /stop, el botón Stop (grupos Telegram y Discord), o espera a que termine el turno antes de enviar otro mensaje en el mismo canal o chat.

​

Una respuesta a la vez

Alter gestiona una respuesta en curso por canal o chat. Si llega un segundo mensaje mientras Alter aún responde, el bot indica que Alter ya está respondiendo en ese canal o chat. Espera a que termine el turno actual y envía de nuevo.

​

Continuidad de conversación

Cada canal Discord o chat Telegram puede tener una conversación Alter activa. Usa /new para empezar de nuevo, o /chats y /use para retomar una conversación Alter existente en tu Mac. En Discord, activar Iniciar discusiones del servidor en hilos da a cada mensaje nuevo de nivel superior del servidor su propio hilo y chat Alter. Las respuestas dentro de un hilo existente continúan ese chat en lugar de iniciar otro.

​

Privacidad y datos

• Los bot tokens se guardan en el macOS Keychain, no en archivos de ajustes en texto plano.
• La configuración de gateway (nombres, listas de acceso, default actions) se guarda localmente en las preferencias de Alter en tu Mac.
• El estado por canal (conversación seleccionada, action pendiente) se guarda en la carpeta Application Support de Alter.
• El procesamiento de mensajes usa la misma pila local de Alter que el Hub — no hay retransmisión en la nube separada para tráfico gateway.

Consulta también Datos locales y privacidad.

​

Solución de problemas

​

Conexión y tokens

​

Uso

​

Disponibilidad con tapa cerrada

​

Notas de plataforma

• Alter debe estar en ejecución — cerrar Alter detiene los bots gateway hasta que vuelvas a abrir la app. En un MacBook, Mantener Gateways en línea con la tapa cerrada mantiene el Mac despierto mientras los gateways están en ejecución, pero Alter debe permanecer abierto.
• Los mensajes de bots se ignoran en ambas plataformas.
• Discord añade 👀 mientras procesa tu mensaje, luego ✅ o ❌ cuando termina el turno. Las reacciones añadidas por usuarios no se tratan como comandos ni entrada de chat.
• Telegram usa long polling para actualizaciones message y callback_query (toques en teclado inline). Tras un turno, Alter puede reaccionar con 👍 o 👎 a tu mensaje. Los chats de grupo muestran un botón Stop durante turnos activos.

Para problemas más amplios de tools y permisos, usa Configuración → Doctor o Tools not working.

​

Páginas relacionadas

• Configurar un Discord gateway
• Configurar un Telegram gateway
• Alter Actions — Disponibilidad en Gateways
• Alter Settings
• Resumen de integraciones
• Guía de API Gateway — API compatible con OpenAI (separada de los Gateways de chat)