Ir al contenido
VirtuAIVirtuAI Docs

Slack

Tu agente responde como una app de Slack. Las personas le envían mensajes directos o lo mencionan en un canal al que se unió.

Antes de comenzar

Sección titulada «Antes de comenzar»
  • Un rol del espacio de trabajo que pueda editar Agents
  • Permiso para crear e instalar apps en tu espacio de trabajo de Slack

1. Crea la app de Slack

Sección titulada «1. Crea la app de Slack»

  1. Ve a api.slack.com/apps y crea una app nueva desde cero en tu espacio de trabajo de Slack.

  2. En OAuth & Permissions, agrega estos permisos (scopes) del token del bot:

    Permiso Para qué lo necesita el agente
    chat:write Publicar, actualizar y quitar sus mensajes
    app_mentions:read Recibir los mensajes que lo mencionan
    im:history Recibir mensajes directos
    users:read y users:read.email Asociar al remitente con un usuario de VirtuAI por correo electrónico
    files:write Compartir los archivos que crea el agente

  3. Instala la app en tu espacio de trabajo de Slack y copia el Bot User OAuth Token. Comienza con xoxb-.

  4. En Basic Information, copia el Signing Secret.

  5. En App Home, permite que las personas envíen mensajes a la app desde la pestaña Messages.

2. Conecta la app al agente

Sección titulada «2. Conecta la app al agente»

  1. Abre Agents y edita el agente.

  2. En Channels, activa Slack. Aparece una tarjeta Slack Configuration.

  3. Pega el Bot Token y el Signing Secret. Ambos son obligatorios. De manera opcional, cambia el Waiting Message. El valor predeterminado es ⏳ Working on your request...

    Ambos valores se cifran al guardarlos y nunca se vuelven a mostrar. Luego, los campos muestran Configured; déjalos en blanco para conservar los valores guardados.

  4. Guarda el agente y, luego, vuelve a editarlo. Ahora la tarjeta muestra sus Integration URLs.

3. Apunta Slack al agente

Sección titulada «3. Apunta Slack al agente»

La tarjeta muestra dos URLs, una para eventos y otra para comandos:

https://<your-virtuai-host>/slack/events/<agent-id>
https://<your-virtuai-host>/slack/commands/<agent-id>

  1. En tu app de Slack, abre Event Subscriptions y activa los eventos. Pega la URL de eventos como Request URL. Slack la verifica de inmediato y debería mostrarla como verificada. La verificación solo funciona cuando el agente ya está guardado con su Bot Token y su Signing Secret, así que completa primero el paso 2.

  2. En Subscribe to bot events, agrega app_mention y message.im y, luego, guarda.

  3. Abre Slash Commands y crea los comandos que quieras de la tabla que aparece más abajo. Usa la URL de comandos como Request URL para cada uno.

  4. Vuelve a instalar la app si Slack te lo pide.

Cada solicitud de Slack, incluida la verificación de la Request URL, se verifica con el Signing Secret. Las solicitudes que no pasan la verificación, y las dirigidas a un agente que no tiene una configuración de Slack guardada, se rechazan con 403.

Comandos

Sección titulada «Comandos»

VirtuAI lee el nombre del comando, así que crea cada uno exactamente con este nombre:

Comando Qué hace
/new [title] Inicia una conversación nueva, con un título opcional
/resume Muestra tus conversaciones recientes. /resume 2 cambia a la segunda.
/status Te indica si el agente está trabajando y desde hace cuánto
/cancel Le pide al agente que detenga la tarea actual
/help Muestra los comandos

Cómo se comportan los mensajes

Sección titulada «Cómo se comportan los mensajes»
  • Progreso. La app publica el mensaje de espera y lo actualiza mientras el agente trabaja. La respuesta lo reemplaza.
  • Una conversación por persona. Cada usuario de Slack tiene una conversación en curso con el agente, sin importar dónde le escriba. Usa /new para empezar de cero.
  • Dónde se publican las respuestas. La respuesta se publica en el canal o en el mensaje directo donde escribiste.
  • Hilos. Se procesan las respuestas en un hilo, pero el agente no ve el resto del hilo.
  • Agente ocupado. Si escribes mientras el agente está trabajando, tu mensaje queda en cola y se procesa a continuación.
  • Reintentos. Si Slack reenvía un evento porque VirtuAI tardó un momento en confirmarlo, el agente responde de todos modos una sola vez.
  • Solo texto. Los archivos y las imágenes que envías no se leen.
  • Tus cuentas. Si tu correo electrónico de Slack coincide con un miembro del espacio de trabajo de VirtuAI, el agente usa las cuentas conectadas de ese miembro, por ejemplo, su Gmail o Drive.
  • Presupuestos. Si el espacio de trabajo agotó su presupuesto, la app responde con el mensaje de presupuesto en lugar de una respuesta.

Solución de problemas

Sección titulada «Solución de problemas»

Slack no verifica la Request URL : Verifica que el agente esté guardado con su Bot Token y su Signing Secret: hasta entonces, VirtuAI rechaza la verificación de Slack con 403. Luego, verifica que hayas copiado la URL de eventos, no la de comandos, que el signing secret sea el de esta app de Slack y que tu dirección de VirtuAI sea accesible desde Internet.

Los eventos llegan, pero la app nunca responde : Verifica el Bot Token y el Signing Secret en el agente. Si el signing secret es incorrecto, VirtuAI rechaza todas las solicitudes.

La app no responde los mensajes directos : Verifica que message.im esté suscrito, que im:history esté otorgado y que los mensajes estén permitidos en App Home.

Un comando indica “Unknown command” : El nombre del comando en Slack no coincide con ninguno de la tabla.