Cómo construir un bot de Slack

Slack ha cambiado fundamentalmente la forma en que los empleados dentro de los equipos, oficinas y organizaciones enteras se comunican y colaboran entre sí. Hay miles de formas de personalizar el Slack de su empresa pero, más allá de usar los canales, los archivos GIF, las integraciones de aplicaciones y los emojis de reacción, la forma más dinámica de mejorar su experiencia en Slack es usar bots.

En parte interfaz de chatbot y en parte motor de acción automatizado, los bots de Slack tienen muchos usos potenciales. Dentro de un canal específico, los más de 100 bots actualmente disponibles en el Directorio de bots de Slack pueden evocar cualquier cosa, desde una encuesta, encuesta o formulario de seguimiento de tiempo hasta análisis de mensajes, pedidos de almuerzo y recomendaciones de restaurantes, todo con un mensaje directo (DM) rápido. o comando de barra oblicua.

Muchos proveedores de software empresarial, incluidos SurveyMonkey y Zenefits (visite el sitio en Zenefits) ya han creado bots que puede habilitar en Slack. Pero no tiene que esperar a que alguien más cree el bot de Slack que su organización necesita. Al usar los recursos para desarrolladores, la documentación y los tutoriales de Slack, puede dejar que la empresa lo guíe a través de la creación de su propio bot de Slack.

PCMag habló con Amir Shevat, jefe de relaciones con desarrolladores de Slack, y John Agan, gerente sénior de relaciones con desarrolladores de Slack (visite el sitio en Zenefits), sobre cómo crear un bot de Slack desde cero. El proceso requiere algunos conocimientos técnicos considerables de los desarrolladores en algunos puntos, pero Shevat y Agan nos guiaron a través de dos escenarios simples de creación de bots con los que todas las empresas pueden identificarse: crear un bot de soporte técnico básico y habilitar notificaciones en el canal. Siga leyendo para obtener instrucciones paso a paso sobre cómo crear su propio bot de Slack.

1. 1. Crear una nueva aplicación de Slack

Para comenzar, abra el menú de navegación de la izquierda desde su cliente de Slack y haga clic en "Aplicaciones e integraciones". En la parte superior derecha del Directorio de aplicaciones, haga clic en "Crear". Esto lo lleva a la interfaz de programación de aplicaciones (API) de Slack, donde hace clic en "Comenzar a construir" en el centro de la página. Asigne un nombre a su aplicación (en este caso, Helpdesk), elija el equipo en el que desea implementar la aplicación y haga clic en "Crear aplicación".

Esto lo lleva a la página Información básica de su aplicación. Para una personalización adicional, desplácese hacia abajo hasta el cuadro Mostrar información en el que puede agregar una descripción, cambiar el color de fondo y agregar un ícono para su futuro bot. Para el bot de Helpdesk, por ejemplo, Agan le dio al bot el emoji de robot como ícono.

2. 2. Escriba los mensajes de su bot

Ahora que ha creado su aplicación, la API de Slack le brinda una serie de opciones para comenzar a personalizar lo que puede hacer. Para nuestra aplicación Helpdesk, estamos creando un bot que facilita la presentación de un ticket de Helpdesk en su nombre. Primero, Agan de Slack dijo que debe escribir los mensajes que aparecerán cuando un usuario escriba un comando de barra oblicua.

En la sección Mensajes del menú API de Slack, elija la herramienta Generador de mensajes. Esto le brinda un código JSON preformateado, con un espacio para que escriba y luego obtenga una vista previa de su texto. Para este bot, Agan escribió: "¿Le gustaría presentar este ticket de soporte técnico?"

Cuando un usuario hace clic en "Crear" para presentar su ticket de soporte técnico, este es el mensaje de confirmación que aparecerá. Entonces, junto al texto, Agan agregó el comando para :white_check_mark: para darle al usuario de Slack un emoji de marca de verificación verde que confirma el envío de su ticket. Así de simple, ha escrito el código de mensaje automatizado de su bot. Ten esto a mano porque lo necesitarás en un momento.

3. 3. Agregar notificaciones

Agan y Shevat dieron demostraciones por separado, pero Shevat explicó que una de las integraciones de bots más comunes que Slack ha visto desde que abrió la capacidad es un bot que recibe notificaciones de servicios de terceros. Esto podría ser algo como un informe de ventas semanal de Salesforce (visite el sitio en Salesforce.com) o, en este caso, de la plataforma de soporte técnico para la que su bot está creando tickets.

4. 4. Activar webhooks entrantes

Para agregar notificaciones dentro de su bot de Helpdesk (Shevat demostró estos pasos con un ejemplo separado que denominó "ReportBot"), primero debe habilitar los Webhooks entrantes. Un Webhook es una devolución de llamada HTTP simple que publica un mensaje en una URL cuando se activa una acción específica.

Para ello, vuelve a la página Información básica de tu API de Slack. El primer cuadro dice "Agregar características y funcionalidad". Elija la opción "Webhooks entrantes". En la parte superior derecha de la página Activar webhooks entrantes hay un botón deslizante. Haga clic en él para cambiar el botón de desactivado a activado.

5. 5. Autorizar notificaciones de canales

Una vez que los webhooks estén activados, desplácese hacia abajo y haga clic en "Agregar nuevo webhook al equipo". Se le pedirá que elija el canal en el que desea que su bot publique notificaciones automáticas. En este ejemplo, Shevat eligió #general, pero en este caso, es posible que desee publicar esta notificación en su equipo de soporte técnico o en el canal del departamento de TI. Por lo tanto, no solo se creará un nuevo ticket en su plataforma de soporte técnico, sino que también se enviará una notificación automática al canal de Slack del departamento de TI para informarles sobre el ticket. Una vez que elijas tu canal, haz clic en "Autorizar".

6. 6. Personaliza tu Webhook

Una vez autorizado, verá una URL básica de Webhook en la página y un botón para copiarla. Arriba está su solicitud curl de muestra, que puede copiar a un editor de texto para decir lo que quiera. En este escenario, en lugar de "Hola, mundo", es posible que desee escribir "Nuevo ticket de soporte técnico enviado" o lo que describa con precisión las notificaciones que desea que envíe su bot. Desde aquí, puede tomar su código de solicitud de curl y la URL de Webhooks y ejecutarlos en cualquier secuencia de comandos. También necesitará este código en el siguiente paso.

7. 7. Construya su robot

Ahora que tiene el código de su mensaje escrito y su URL de Webhooks a mano, está listo para construir su bot. La mayoría de las integraciones de Slack requieren un servidor para responder e iniciar solicitudes, especialmente cuando se trata de comandos de barra y lógica de bot automatizados. Slack es compatible con varios proveedores, pero Agan creó el bot de la mesa de ayuda usando un servicio llamado Glitch.

Este paso requiere cierta experiencia en codificación. Agan creó un nuevo proyecto Glitch y luego comenzó a agregar código JavaScript de fuente abierta. Si no desea escribir todo el código usted mismo (o reinventar la rueda), puede elegir entre innumerables marcos y bibliotecas de bots para importar su lógica básica de bots.

Agan nombró a su proyecto "Index.js", agregó un paquete que él mismo creó llamado TinySpeck y luego pegó el código del Generador de mensajes que escribimos anteriormente. Con el código principal del bot ahora en su lugar, simplemente agregó un comando de devolución de llamada para activar un nuevo ticket y el mensaje de confirmación "Se ha creado un ticket de soporte técnico". Eso es. Si desea agregar su código de Webhooks para activar una notificación en el canal que ha designado, también puede pegarlo aquí. Glitch crea una URL única para su servidor bot, así que copie esa URL una vez que haya agregado todo su código y pasemos al siguiente paso.

8. 8. Habilitar mensajes interactivos

Ya ha creado su bot de Helpdesk, por lo que ahora todo lo que tiene que hacer es volver a la API. En lugar de elegir "Crear nueva aplicación", simplemente haga clic en "Administrar aplicaciones" y elija la aplicación Helpdesk. En la página Información básica, elija "Mensajes interactivos" en el cuadro Agregar características y funcionalidad. Una vez en esa página, haga clic en "Habilitar mensajes interactivos", pegue la URL de su servidor del paso anterior y guarde los cambios.

9. 9. Crear un comando de barra oblicua

Una vez hecho esto, regrese al cuadro Agregar funciones y funcionalidad y vaya a Comandos de barra. Haga clic en "Crear nuevo comando". Esto lo lleva a una página de formulario con algunos campos.

En el cuadro Comando, ingrese su comando de barra inclinada. En este caso, Agan escribió "/helpdesk". En el campo Solicitar URL, pegó la misma URL del servidor de Glitch. Luego, todo lo que debe hacer es ingresar una breve descripción para el comando ("Crear un ticket de soporte técnico"), una sugerencia de uso sobre cómo el usuario debe escribir su solicitud, verifique la vista previa debajo para asegurarse de que todo se vea bien y luego haga clic en Guardar. .

10. 10. Instala tu aplicación

El bot de Helpdesk ahora está listo para funcionar. De vuelta en la página principal de la API de su aplicación, vaya a la página de instalación de la aplicación que se encuentra en el menú de configuración del lado izquierdo. Haga clic en "Instalar aplicación en su equipo". Esto le pedirá que autorice la aplicación. Una vez que lo haga, su bot estará activo. Verás un mensaje verde "¡Éxito!" cinta de notificación en la parte superior de su pantalla que confirma que su bot está instalado.

11. 11. Da una vuelta con tu bot

De vuelta en el cliente de Slack de su equipo, diríjase al canal en el que ha designado para poner a trabajar su nuevo bot. Ingrese el comando de barra inclinada con una consulta, por ejemplo: "/helpdesk mi Wi-Fi está roto". A continuación, se le solicitará un botón para crear un ticket de soporte técnico. Felicidades; ¡Acabas de crear un bot de Slack que funciona!