¿Cómo configurar la integración de Slack con Athento? – Athento

Athento ofrece integración con Slack para enviar mensajes automatizados relacionados con documentos.

En este artículo se explica cómo integrar ambas aplicaciones.

Obtención del token del bot de Slack

Para la obtención del token de autenticación del bot de slack para poder conectarlo con Athento, se deben seguir los siguientes pasos:

1. Crear un bot si no estaba ya creado de antes. Para ello deberás dirigirte a https://api.slack.com/apps y darle al botón "Create New App". Deberás seleccionar la opción "From scratch" y rellenar el nombre y workspace a donde pertenecerá el bot.

2. Deberás ir a la sección "OAuth & Permissions" y allí darle permisos de escritura al bot, en la parte de Scopes > Bot Token Scopes (el permiso se llama chat:write)

3. Por último, en la parte "OAuth Tokens for Your Workspace" deberás darle al botón "Install to Workspace" y en el siguiente paso darle a permitir. Una vez instalado, aparecerá el "Bot User OAuth Token" el cual debes copiar y guardarlo.

Configurar la aplicación Slack en Athento

Desde la pestaña Aplicaciones del Equipo, ve a la aplicación Slack. Haz clic en Añadir y, a continuación, pega el token generado en el paso anterior. Puedes utilizar el botón "Comprobar conexión" para asegurarte de que Athento está correctamente conectado con el bot:

Invitar la aplicación al canal de Slack en la que se quiere usar

Desde el canal en el que quieres que se envíen los mensajes, escribe @ y empieza a escribir el nombre del bot que creaste en Slack. Selecciona el bot de la lista de opciones que te sugiere Slack.

Configurar operación para enviar mensajes a Slack

Debes instalar la operación op_send_to_slack_v2 .

Las opciones de configuración son:

Channel: aquí debes poner el nombre del canal en el que quieres que se envíen los mensajes.
Message: este es el mensaje que se va a enviar en el canal.

Usar información del documento en el mensaje

Podrás hacer uso en los mensajes de información del documento desde el que se ejecuta la operación, por ejemplo: el nombre del documento, el link, valores de campos, etc.

Incluir el enlace al documento

{{ fil.get_url_file_view() }}

Incluir el valor de un campo en el mensaje

{{ fil.gmv('metadata.AQUI-VA-EL-NOMBRE-DE-TU-CAMPO') }}

Otras etiquetas que puedes usar

{{ fil.filename }} --> nombre del documento

{{ fil.creation_date }} --> fecha de creación del documento

{{ fil.state }} --> estado del documento

Ejemplo de mensaje:

Nueva reclamación creada a fecha {{fil.creation_date}} 
con título {{fil.filename}} y estado {{fil.state}}.
Email del interesado: {{fil.gmv('metadata.formulario_1_email_interesado')}}.
Link al documento: {{fil.get_url_file_view()}}

Y al lanzar la operación, el bot enviará un mensaje por slack tal que así:

Formato en los mensajes

Puedes utilizar elementos de formato básicos soportados por Slack en sus mensajes https://api.slack.com/reference/surfaces/formatting