¡Hola a todos!
¡Bienvenidos a este tutorial sobre cómo configurar un flujo de trabajo de automatización con Integromat que te permitirá recibir automáticamente una notificación por correo electrónico cada vez que un nuevo usuario se registre en tu comunidad de Discourse.
Para conectar Discourse con Integromat, necesitas tener una cuenta de Integromat. Si aún no tienes una, puedes registrarte aquí.
Este método utiliza la función de webhooks que ofrece Discourse, por lo que necesitarás tener acceso de administrador en tu comunidad de Discourse antes de comenzar.
Una vez que tengas acceso de administrador, lo primero que debes hacer es crear una nueva solicitud de webhook. Para ello, haz clic en tu icono de perfil en la esquina superior derecha y, desde la pestaña de perfil, selecciona la opción Resumen.
Esto te llevará a tu página de perfil. Haz clic en el botón Administrador para navegar a la página de administración.
Haz clic en la opción API.
Selecciona la pestaña Webhooks y haz clic en el botón Nuevo webhook para generar una nueva solicitud de webhook.
La página de configuración debería verse así.
Para completar este formulario, necesitarás generar un nuevo webhook de Integromat que se utilizará para recibir los datos que Discourse envía cada vez que un nuevo usuario se registra en tu comunidad.
Para ello, inicia sesión en tu cuenta de Integromat y crea un nuevo escenario.
Primero, deberás configurar un módulo de disparador, o en otras palabras, el módulo que hará que tu escenario se ejecute. En este caso, será un módulo de webhook, por lo que puedes hacer clic en el icono de interrogación y buscar la aplicación Webhooks.
Haz clic en la aplicación Webhooks y selecciona el módulo Webhook personalizado.
A continuación, crea un nuevo webhook para que tu escenario pueda recibir los datos que Discourse le envía. Para ello, haz clic en la aplicación Webhooks para abrir su ventana de configuración y haz clic en el botón Agregar para configurar un nuevo webhook.
Asigna un nombre a tu webhook. Puede ser cualquier cosa que te guste, por ejemplo, Webhook de Discourse.
El siguiente paso será hacer clic en la opción Mostrar configuración avanzada y seleccionar la opción Obtener encabezados de solicitud. Una vez hecho esto, haz clic en Guardar para generar tu nuevo webhook.
Tu webhook ahora debería ser visible. Es la URL resaltada en azul. Haz clic en el botón Copiar dirección al portapapeles para copiar tu webhook y dirígete a la página de configuración de webhooks de Discourse.
Pega la URL de tu webhook de Integromat en el campo URL de la carga útil.
A continuación, selecciona la opción Evento de usuario de la lista y asegúrate de que todo lo demás esté deseleccionado. Esto garantizará que este webhook solo reciba datos basados en eventos específicos de usuario.
Finalmente, selecciona las casillas Verificar certificado TLS de la URL de la carga útil y Activo al final de la página y haz clic en el botón Crear para establecer esta conexión entre tu comunidad de Discourse y tu webhook de Integromat.
La nueva conexión ahora debería ser visible en la página de Webhooks de tu cuenta de Discourse.
El siguiente paso será asegurarse de que la conexión entre la comunidad de Discourse y tu webhook de Integromat se haya establecido. Para ello, haz clic en Inactivo.
Luego, se te presentará un pequeño menú que se ve así. Simplemente haz clic en Ping y dirígete a tu escenario de Integromat para ver si tu webhook ha detectado correctamente este evento.
Si es así, verás un mensaje que dice Determinado con éxito.
El siguiente paso es verificar si el webhook puede realmente recibir datos de tu comunidad de Discourse. Para ello, debes ejecutar el escenario una vez haciendo clic en el botón Ejecutar una vez.
Una vez que el módulo de webhook comience a girar, dirígete a tu comunidad de Discourse, cierra sesión y crea una nueva cuenta de usuario en tu comunidad. Una vez que el nuevo usuario se haya creado correctamente, el webhook debería recibir algunos datos y se verá así.
Esto te ayudará a asegurarte de que el webhook puede detectar eventos reales (no solo pings) y también te permitirá mapear los elementos de datos recibidos a la aplicación de correo electrónico más adelante en este tutorial. Si tu webhook de Integromat ha detectado correctamente el evento, el escenario se habría ejecutado con éxito y debería verse así.
Ahora que sabes que el módulo de webhook funciona como se espera y que tu escenario de Integromat se activa cada vez que se crea un nuevo usuario, es hora de ampliar el escenario y configurarlo para que te envíe automáticamente un correo electrónico con toda la información del usuario.
El primer paso será adjuntar un módulo Iterador al módulo de disparador de webhook. Puedes encontrarlo en el menú Herramientas del constructor de escenarios. Explicaremos el uso de este módulo más adelante.
Haz clic en el módulo Iterador para abrir su ventana de configuración.
Una vez que hagas clic en el campo Matriz, se abrirá un menú en el lado izquierdo con algunos elementos de datos recuperados del módulo de webhooks. Simplemente arrastra y suelta el elemento de datos llamado Encabezados al campo Matriz del módulo Iterador. Esto será una matriz con muchos valores.
El siguiente paso será adjuntar la aplicación de correo electrónico después de la aplicación Iterador. Haz clic en el icono de más y busca la aplicación de correo electrónico. Una vez que la encuentres, haz clic en ella para seleccionar el módulo que deseas utilizar.
Selecciona el módulo Enviar un correo electrónico de la lista para enviarte un correo electrónico cada vez que se cree un nuevo usuario en tu comunidad de Discourse.
Antes de configurar el módulo de correo electrónico, debes establecer un filtro entre las aplicaciones Iterador y Correo electrónico que asegure que solo recibas correos electrónicos para los usuarios que se registran en tu comunidad. Esto es necesario porque, por defecto, Discourse activará solicitudes de webhook para todo tipo de actividades de usuario.
En la ventana de configuración del filtro, primero deberás ingresar una etiqueta. Puede ser cualquier cosa que te guste, por ejemplo, Nuevo usuario.
Luego, deberás crear una condición que active este filtro. En el primer campo de la condición, simplemente mapea el elemento de datos Valor del módulo Iterador. Para el operador lógico, selecciona Igual a. Finalmente, en el campo inferior, ingresa el valor user_created.
El funcionamiento de esta condición es el siguiente:
Los datos del webhook que Integromat recibe de Discourse cada vez que un usuario realiza una acción contienen una matriz de Encabezados (una matriz es una colección de valores). La función del iterador es recuperar cada uno de estos valores individualmente para que puedan procesarse y aplicarse al filtro. En algún lugar de esta matriz de valores, hay un valor que especifica el tipo de evento que el usuario ha realizado. Dado que el evento que nos interesa se llama user_created (porque indica que la acción que el usuario ha realizado fue crear una nueva cuenta), necesitamos configurar un filtro para asegurarnos de que los valores de encabezado de los datos del webhook realmente contengan este valor. Si lo hacen, entonces procedemos con la ejecución de los módulos de escenario subsiguientes. Si no lo hacen, la ejecución del escenario termina poco después y no se envía ningún correo electrónico.
Una vez que tu filtro esté configurado, puedes hacer clic en el módulo de Correo electrónico para abrir su ventana de configuración.
Lo primero que debes hacer es conectar la cuenta de correo electrónico con la que deseas enviar correos electrónicos. Si estás conectando tu Gmail, asegúrate de seguir esta guía, que explica el proceso paso a paso.
Una vez que tu correo electrónico esté conectado, puedes continuar configurando las otras opciones del módulo de correo electrónico.
Para el campo Para, puedes hacer clic en Agregar un destinatario e ingresar el correo electrónico en el que deseas recibir estas actualizaciones.
Para Asunto, puedes ingresar cualquier cosa que te guste, y para Tipo de contenido, puedes seleccionar la opción Texto plano para construir el mensaje que deseas enviar cada vez que se ejecute este módulo.
El campo Contenido es donde puedes construir el mensaje del correo electrónico. Aquí, puedes escribir algún texto estático (es decir, texto que siempre permanece igual en cada ejecución), pero también puedes mapear elementos de datos dinámicos del módulo de webhook. El webhook contiene muchos datos sobre el usuario que puedes utilizar, incluido su nombre de usuario, nombre, correo electrónico, etc.
¡Y ahí lo tienes! Has logrado crear con éxito un escenario de Integromat que te notifica cada vez que un nuevo usuario se une a tu comunidad de Discourse.
¡Esperamos que este tutorial te haya sido útil! Si tienes alguna pregunta o recomendación sobre lo que te gustaría ver a continuación, no dudes en hacérnoslo saber en los comentarios, enviar un ticket al equipo de soporte de Integromat o consultar la comunidad de Facebook de Integromat con 10 mil miembros.
¡Feliz automatización!
ENLACES
Cómo conectar Discourse con cientos de aplicaciones usando Integromat