Saltar al contenido principal

Slack

SlackEquipo y comunidad

Agregar tu agente a Slack es como darle a tu equipo un nuevo compañero servicial al que pueden escribirle en un canal. Las personas publican una pregunta y tu agente responde ahí mismo en la conversación. Esta página te muestra cómo crear una app de Slack y conectarla a tu agente de Nirvai.

Exportación del canal de Slack mostrando un workspace conectadoImage: Exportación del canal de Slack mostrando un workspace conectado

Antes de comenzar​

  • Un agente guardado en el Panel de Control de Agentes (al menos el paso de Perfil completado).
  • Un workspace de Slack: la cuenta de Slack de tu equipo, el espacio donde viven tus canales y tus personas.
  • Permiso para agregar una app a ese workspace (normalmente un administrador).
  • Un token del bot: un pase de acceso seguro de tu app de Slack que le permite a Nirvai enviar y recibir mensajes en su nombre. Lo crearás en el siguiente paso.

Paso a paso​

1. Crea una app de Slack​

  1. Inicia sesión en Slack desde la web y entra al directorio de apps de Slack para desarrolladores.
  2. Haz clic en Create New App y elige From scratch.
  3. Dale un nombre a la app (por ejemplo, "Mi Agente de Soporte") y elige el workspace donde vivirá.
  4. Abre la sección OAuth & Permissions dentro de la configuración de la app.
  5. En Bot Token Scopes, agrega los permisos básicos de mensajes (leer mensajes en los canales donde se invite al bot, publicar mensajes y leer archivos).
  6. Haz clic en Install to Workspace en la parte superior de la misma página y aprueba la app.
  7. Slack te muestra un Bot User OAuth Token: tu token del bot. Cópialo. Empieza con xoxb-.

Configuración de la app de Slack mostrando el token del botImage: Configuración de la app de Slack mostrando el token del bot

aviso

Mantén tu token del bot en privado. Cualquiera que lo tenga puede leer y publicar mensajes como tu app: trátalo como una contraseña.

2. Conecta la app a Nirvai​

  1. Abre tu agente en el Panel de Control de Agentes.
  2. Haz clic en el nodo Canales.
  3. Selecciona Slack en la sección de Equipo y comunidad.
  4. Pega tu token del bot en el campo.
  5. Elige el canal donde el agente debe responder.
  6. Haz clic en Conectar.

Pegando el token del bot de Slack en NirvaiImage: Pegando el token del bot de Slack en Nirvai

3. Invita al agente al canal​

En Slack, abre el canal que elegiste y escribe:

/invite @NombreDeTuApp

Listo: tu agente ya vive en ese canal.

Qué pasa después de conectarlo​

  • Cuando alguien publica en el canal conectado, Slack le pasa el mensaje a Nirvai, tu agente lo lee y la respuesta aparece en el mismo canal.
  • Tu agente solo responde en el canal que conectaste. Los demás canales del workspace no se ven afectados.
  • El agente termina la respuesta actual antes de empezar la siguiente: los mensajes adicionales se ponen en fila y se responden en orden.
  • Si un compañero adjunta una captura de pantalla o un documento, el agente simplemente responde: no hay un mensaje aparte de "subido".

Lo que tu agente puede hacer en Slack​

CapacidadCompatible
Responder mensajes del canal✓
Enviar mensajes de texto✓
Enviar imágenes✓
Enviar archivos✓

Gestionar tu conexión​

  • Eliminar desconecta Slack de tu agente. La app de Slack permanece en tu workspace, pero deja de responder hasta que la reconectes.
  • Para usar un canal distinto, elimina la conexión y vuelve a agregarla seleccionando el nuevo canal.

Solución de problemas​

ProblemaSolución
El agente no responde en el canalAsegúrate de haber invitado la app de Slack a ese canal. En Slack, escribe /invite @NombreDeTuApp.
"Token inválido" al conectarVerifica que el token empiece con xoxb- y se haya copiado sin espacios extra. Si hace falta, vuelve a instalar la app en tu workspace.
"Permiso denegado" al crear la appNecesitas permiso de administrador del workspace para instalar apps. Pídele a un administrador que haga este paso.
Quieres más de un agente en el mismo workspaceCada agente usa su propia app de Slack y su propio canal. Coloca cada uno en un canal diferente.
El agente responde pero se salta mensajesPuede haber una respuesta larga aún en curso: el siguiente mensaje se tomará en cuanto el agente termine.

Qué sigue​