Este artículo explica cómo crear una aplicación que envíe una notificación de Slack cada vez que su cuenta recibe un nuevo comentario. La configuración consta de tres partes: crear la app de Slack, subir un plugin a su cuenta de Yext y crear la app de Yext que conecta ambos.
Requisitos
- Un espacio de trabajo de Slack donde tenga permiso para crear aplicaciones o la aprobación de su administrador de Slack
- Una cuenta de Yext con acceso a las funciones de la cuenta y a la consola de desarrolladores
Paso 1: crear una aplicación de Slack
- Cree o seleccione el canal de Slack en el que quiere que aparezcan las notificaciones de comentarios.
- Vaya a api.slack.com/apps y haga clic en Crear nueva aplicación.
- Seleccione Desde cero, introduzca un nombre de aplicación y seleccione su espacio de trabajo.
- En Añadir características y funcionalidades, haga clic en Webhooks entrantes.
- Active la función.
- Haga clic en Solicitar añadir un nuevo Webhook e incluya un mensaje al administrador de Slack explicando qué hará el webhook.
- Después de que el administrador apruebe la solicitud, vuelva a api.slack.com/apps, seleccione su app y vuelva a Webhooks entrantes.
- Haga clic en Añadir nuevo webhook al espacio de trabajo, seleccione el canal para las notificaciones de comentario y haga clic en Permitir.
- Copie la URL del webhook que aparece al final de la página. La necesitará en el paso 2.
Paso 2: cargar el plugin del medio digital
- Navegue a Configuración de la cuenta > Funciones de la cuenta y habilite Verano '23: Activar funciones sin servidor en aplicaciones (acceso anticipado). Haga clic en Guardar.
- Vaya a este enlace para empezar a aplicar la función de Slack a su cuenta.
- Haga clic en Aplicar en la esquina superior derecha.
- Introduzca su ID de cuenta y haga clic en Continuar.
- Introduzca la URL del webhook que copió en el paso 1 y su ID de cuenta.
- Haga clic en Guardar, luego en Continuar y, finalmente, en Confirmar.
Para verificar que la carga fue correcta, vaya a Desarrollador > Consola de administradores y confirme que ve los archivos bajo la ruta: platform > plugin > slackReviewsPublisher.
Paso 3: crear una aplicación de Yext
- Vaya a Desarrollador > Consola de desarrolladores.
- Haga clic en Añadir una aplicación, introduzca un nombre, como «Medio digital de comentarios de Slack», y haga clic en Crear aplicación.
- En la pestaña Credenciales de la API, haga clic en Añadir un nuevo permiso de API. Seleccione API de gestión > Comentarios con permisos de solo lectura y haga clic en Guardar.
- En la pestaña Webhooks, haga clic enAñadir webhook.
- Seleccione Comentarios como tipo de webhook y haga clic en Siguiente.
- Introduzca un nombre para el webhook, como «Notificación de comentario de Slack».
- En URL, haga clic en Invocar una función. Seleccione slackReviewsPublisher y elija la función handleNotification.
- Haga clic en Finalizar y añadir.
Su canal de Slack recibirá ahora una notificación cada vez que su cuenta reciba un nuevo comentario.