NexusBlendAcceder a Nexus
Nexus Blend/Documentación/Canales
Guía de configuración

Canales conversacionales

Conectá un chat externo a la inteligencia y datos de Nexus.

Cada plataforma entrega mensajes a un webhook firmado. Nexus identifica al usuario por su código de vínculo, aplica su Account y responde usando OpenAI y las fuentes autorizadas.

Base pública de webhooksBackend de producción
https://back.nexusblend.com.ar
Las credenciales del bot viven en Railway: no se guardan en el navegador ni se exponen a un Account cliente.
01

Modelo operativo

Primero se conecta el bot; después, cada persona vincula su identidad.

  1. 1
    Plataforma Nexus

    Un SUPER_ADMIN registra las credenciales globales del bot en Railway y activa el canal.

  2. 2
    Webhook firmado

    Slack, Telegram o Discord verifican que el endpoint de Nexus recibe eventos válidos.

  3. 3
    Vínculo de usuario

    Un ADMIN o MANAGER genera un código en Canales y el usuario lo envía al bot.

  4. 4
    Consulta con contexto

    La identidad queda asociada a un usuario, su Account y sus fuentes de datos.

02

Canales disponibles

Configuración por plataforma.

TGListo para configurar

Telegram

  1. Creá un bot con @BotFather y guardá su token.
  2. Generá un secreto aleatorio y configurá Railway: NEXUS_TELEGRAM_ENABLED=true, NEXUS_TELEGRAM_BOT_TOKEN y NEXUS_TELEGRAM_WEBHOOK_SECRET.
  3. Registrá el endpoint con setWebhook, enviando ese mismo valor como secret_token.
  4. En Nexus, generá el código de vínculo y enviá VINCULAR + código al bot dentro de 15 minutos.
Es el canal más simple para el primer piloto: cada usuario vincula su identidad de Telegram a su usuario de Nexus.
SLListo para configurar

Slack

  1. Creá una Slack App, instalala en el workspace y guardá el Signing Secret y el Bot User OAuth Token.
  2. En Event Subscriptions activá eventos y pegá la URL del webhook de Nexus; Slack validará la URL automáticamente.
  3. Suscribí el evento message.channels y agregá los scopes necesarios, como chat:write y el scope de lectura de mensajes correspondiente.
  4. Configurá en Railway NEXUS_SLACK_ENABLED=true, NEXUS_SLACK_SIGNING_SECRET y NEXUS_SLACK_BOT_TOKEN. Luego generá y enviá VINCULAR + código al bot.
El bot ignora sus propios mensajes, procesa consultas de usuarios vinculados y responde en el mismo canal.
DCListo para configurar

Discord

  1. Creá una Application en Discord Developer Portal y copiá su Public Key.
  2. En General Information configurá Interactions Endpoint URL con la URL de Nexus.
  3. Creá un slash command, por ejemplo /nexus consulta:<texto>, e instalá la aplicación en tu servidor.
  4. Configurá en Railway NEXUS_DISCORD_ENABLED=true y NEXUS_DISCORD_PUBLIC_KEY. Generá el código de vínculo y ejecutá VINCULAR + código desde Discord.
Nexus responde a interacciones/slash commands. No usa mensajes comunes de Discord como entrada.
03

Microsoft Teams

Endpoint experimental: no lo uses todavía como integración estándar.

Estado actual. Nexus expone https://back.nexusblend.com.ar/api/channels/teams/webhook y valida una firma HMAC propia. Microsoft Teams estándar usa el Bot Framework con validación OAuth/JWT, por lo que aún falta el adaptador oficial de Teams y el flujo de registro de bot. No marques Teams como canal disponible para clientes hasta completar esa pieza.
04

Vínculo

Cómo termina de conectarse una persona.

Desde el panel Nexus

Entrá a Canales, abrí el canal activo y presioná “Generar código de vínculo”. El código dura 15 minutos y pertenece al usuario que lo creó.

VINCULAR ABCD2345
Importante. El código identifica a una persona, no a toda la empresa. Para dar acceso a más integrantes, cada usuario debe iniciar sesión en Nexus y vincular su propia identidad del chat.