Integración · Canales
Conectar Slack a Igniten
Instale a Igniten como una aplicación de Slack para que su equipo pueda preguntarle desde los canales, en el mismo lugar donde ya trabaja. La aplicación se crea pegando un manifiesto que ya trae los permisos puestos, así que no hay que elegirlos de a uno, y se puede revisar la lista completa antes de instalarla en el espacio de trabajo.
Qué lee Igniten, y qué no
Lee
- Lo que se escribe en los canales públicos donde esté la aplicación
- Las reacciones 👍 y 👎 a las respuestas, para aprender de ellas
- Las notas de voz que se manden en esos canales, para transcribirlas
No lee
- Los canales privados y los mensajes directos: el permiso está identificado y sin pedir, así que una nota de voz por mensaje directo no llega
- Los archivos que no sean audio
Cómo se conecta
5 pasos · ≈ 6 min
-
Crear la app desde el manifiesto
From an app manifest: se pega un bloque y la app queda creada con los permisos puestos.
- Elija «From an app manifest»: pega un bloque y la aplicación queda creada con los permisos ya puestos.
- El bloque para pegar se lo damos armado, con la dirección de su instalación adentro.
- El «App ID» aparece en «Basic Information» una vez creada.
Salió bien si La aplicación aparece en su lista de apps de Slack con el nombre Igniten.
-
Revisar los permisos antes de instalar
Bot Token Scopes. Son los mismos del manifiesto; mirarlos es lo que evita otorgar de más.
- Están en «OAuth & Permissions → Bot Token Scopes».
- Son los mismos que trajo el manifiesto: mirarlos es lo que evita otorgar de más.
- La ficha de esta integración explica para qué sirve cada uno.
Salió bien si La lista muestra exactamente los alcances de la ficha, ni más ni menos.
-
Instalar la app en el workspace
Install to Workspace. Recién acá Slack otorga los permisos y aparece el token.
- Botón «Install to Workspace», arriba de la misma pantalla de permisos.
- Recién acá Slack otorga los permisos y aparece el token del bot.
- Si ya estaba instalada y cambió permisos, hay que reinstalarla para que apliquen.
Salió bien si Slack devuelve a la pantalla de la app y aparece el «Bot User OAuth Token».
-
Cargar el token y el secreto de firma
Se cargan acá y no vuelven a salir. Después sólo se ven los últimos cuatro caracteres.
- El token del bot está en «OAuth & Permissions» y empieza con «xoxb-».
- El secreto de firma está en «Basic Information → App Credentials», en «Signing Secret».
- Los dos se guardan cifrados y no se vuelven a mostrar.
Salió bien si El panel confirma la carga y muestra sólo los últimos cuatro caracteres de cada uno.
-
Probar que anda
Preguntamos qué permisos quedaron otorgados y le decimos cuál falta. No guardamos nada.
- Le preguntamos a Slack qué alcances quedaron otorgados de verdad.
- Slack devuelve la lista completa, así que también avisamos si hay alguno de más.
- No se guarda nada de lo que devuelva la prueba.
Salió bien si La prueba dice «anduvo» y no nombra ningún alcance faltante.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
chat:write | Contestar en Slack | Siempre |
channels:history | Recibir lo que se pregunta en los canales públicos | el asistente contesta en canales publicos |
reactions:read | Aprender de los 👍 y 👎 que deja su gente | el circuito de 👍/👎 |
files:read | Entender las notas de voz que mandan por Slack | entender las notas de voz que mandan por Slack |
channels:read | Elegir a qué canal de Slack mandan sus resultados las rutinas | elegir a qué canal de Slack manda sus resultados una rutina |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- Igniten no entiende las notas de voz y no dice por qué
-
Por qué Falta el permiso de archivos. Slack no devuelve un error: devuelve la pantalla de inicio de sesión como si fuera el audio.
Qué hacer Agregue el alcance de lectura de archivos y reinstale la aplicación.
- Cambié los permisos y sigue faltando alguno
-
Por qué Slack aplica los alcances nuevos recién cuando la aplicación se reinstala.
Qué hacer Vuelva a instalar la aplicación en el espacio de trabajo.
- Los mensajes dejaron de llegar de golpe
-
Por qué Se rotó la clave de firma de la aplicación y la que tenemos quedó vieja.
Qué hacer Cargue la clave nueva desde el instructivo; no hace falta rehacer la app.
Los límites, dichos
- Slack limita cuántos mensajes por minuto puede enviar una aplicación.
Preguntas frecuentes
¿Lee mis mensajes directos?
No. Hoy sólo lee los canales públicos donde esté la aplicación. El permiso para mensajes directos ni siquiera se pide, así que no hay forma de que los lea sin que alguien cambie la aplicación y la reinstale.
¿Puedo revisar los permisos antes de instalar?
Sí, y es el paso 2 del instructivo a propósito. El manifiesto deja la lista escrita en la pantalla de la aplicación y puede leerla entera antes de apretar instalar.
¿Para qué necesita leer las reacciones?
Para aprender. Un 👍 sobre una respuesta la marca como buena y se usa como referencia para preguntas parecidas; un 👎 la deja fuera del índice para que no se repita.