El módulo SMTP personalizado agrega configuraciones básicas para permitirle enviar correos electrónicos directamente desde su aplicación.
Para que el formulario para enviar cartas aparezca en la aplicación, debe agregar la configuración que falta y los elementos necesarios. El algoritmo de acciones será el siguiente:
- Agregue una página o ventana donde se ubicará el formulario de carta.
- Conecte el módulo, agréguele los parámetros del servidor SMTP, así como su nombre de usuario y contraseña.
- Cree un proceso de negocio, punto final y formulario relacionados con el módulo.
Vamos a mostrar cómo hacer esto en una aplicación web utilizando el servicio de correo de Gmail como ejemplo.
Crear una pagina
Vaya al editor y cree una nueva página desde la cual publicará. Indique el nombre de su página ("Título"), su dirección ("URL de la página") y los grupos de usuarios que pueden enviar mensajes ("Mostrar para grupos"). Clic en Guardar".
Guarde sus cambios y vaya al bloque de módulos.
Agregar y configurar un módulo
Busque el módulo SMTP personalizado en la pestaña Marketplace y haga clic en el botón Instalar para agregarlo a la aplicación.
Vaya a la pestaña "Instalado", donde se encuentran todos los módulos instalados en su aplicación, y haga clic en el cuadro "SMTP personalizado" para abrir su configuración. A la izquierda se muestra información básica sobre el módulo y un botón para eliminarlo de la aplicación. A la derecha están los campos que debe completar:
- En los campos "Iniciar sesión" y "Contraseña" ingrese los datos del buzón desde el cual enviará mensajes.
- Especifique la configuración de la conexión SMTP; son diferentes para cada servicio de correo electrónico. De forma predeterminada, la configuración de Gmail se agrega al módulo.
- En el campo "Nombre del remitente", ingrese el nombre que se mostrará a los destinatarios de sus cartas.
¡Importante! Para enviar mensajes a través de Gmail, debe habilitar aplicaciones de terceros en su cuenta de Google.
Para obtener más información sobre qué son los módulos, cómo actualizarlos y personalizarlos, consulte nuestra documentación .
Recuerda guardar tus cambios.
Creación de un proceso de negocio, un punto final y un formulario
El proceso comercial , el punto final y el formulario son elementos interrelacionados que es importante configurar de manera coherente. Al interactuar entre sí, completarán la configuración de su aplicación y aparecerá el formulario para enviar un mensaje en la página.
Puede leer más sobre estos elementos en nuestra documentación .
Procesos de negocio
Vaya a la pestaña "Lógica empresarial" y haga clic en el botón para crear un nuevo proceso empresarial.
Ingrese el nombre del proceso (obligatorio), su descripción (opcional) y haga clic en el botón "Crear".
Cada proceso comercial en el editor se divide visualmente en bloques: partes constituyentes responsables de diferentes funciones. Cuando se crea un nuevo proceso, "Inicio" y "Fin" aparecen automáticamente en él. Todos los demás bloques que puede agregar se mostrarán a la izquierda.
Después de la instalación, el módulo "SMTP personalizado" agregó "SMTP personalizado: Enviar correo electrónico" a esta lista. Para incluir este bloque en un proceso comercial, arrástrelo al campo del editor con el puntero del mouse. Aparecerá la ventana "SMTP personalizado: Enviar correo electrónico", cuyos campos contienen las variables de las que depende el contenido de su futuro formulario de envío de mensajes:
- "Asunto" - el asunto de la carta;
- "Cuerpo" - un campo con el texto de la carta;
- "Para" - la dirección del destinatario;
- "Cc" - dirección para enviar una copia;
- "De nombre" - el nombre del remitente;
- "Bcc" es la dirección para enviar la copia oculta.
Ahora debe vincular "Inicio", "SMTP personalizado: enviar correo electrónico" y "Finalizar", para mostrar que constituyen un único proceso comercial:
1. Mueva el puntero del mouse sobre el campo "Inicio" en el bloque "Inicio", mantenga presionado el botón izquierdo del mouse y deslícese hasta el campo "Entrada" en el bloque "SMTP personalizado: Enviar correo electrónico": se forma una conexión entre los bloques
2. Del mismo modo, cree un enlace entre el campo "Salida" del bloque "SMTP personalizado: Enviar correo electrónico" y el campo "Fin" del bloque "Fin".
Ahora, en el bloque "Inicio", debe crear nuevos campos (variables) y asociarlos con variables en el bloque "SMTP personalizado: Enviar correo electrónico". Los campos que agregue al bloque "Inicio" aparecerán en su formulario de envío de mensajes. Imagine que no enviará copias y copias ocultas, por lo que el bloque "Inicio" contendrá los siguientes campos:
- “Remitente” (nombre del remitente) - asociado con from_name;
- "Dirección" (a quién se envió) - asociado con "a";
- "Asunto" (tema); - asociado con "sujeto" (los nombres de las variables en diferentes bloques pueden ser los mismos);
- "Mensaje" (texto de la carta) - asociado con "cuerpo".
Para vincular variables, deben coincidir entre sí en tipo. El tipo de una variable se puede ver haciendo clic en el bloque que la contiene y abriendo el menú de edición.
En los campos de los bloques, al lado de cada variable hay un icono, cuyo color y forma depende de su tipo, para facilitar la navegación en ellos. En nuestro ejemplo, hay dos tipos de variables:
- "Asunto", "cuerpo" y "from_name" son del tipo "String",
- Para, cc y bcc son del tipo Matriz de correo electrónico.
Creación de variables
Para crear la primera variable en el bloque "Inicio", haga clic en él; se mostrará una lista (mientras esté vacía). Haga clic en "+".
En la ventana abierta, ingrese el nombre de la variable: nombre "remitente", escriba "Cadena". Haz clic en "Crear".
Del mismo modo, agregue "dirección", "asunto" y "mensaje". Ahora la lista de variables en el bloque "Inicio" se ve así:
Enlácelos a las variables correspondientes en el SMTP personalizado: bloque Enviar correo electrónico:
Así es como deberían verse las relaciones entre las variables al final. Guarde sus cambios y proceda a crear el punto final.
punto final
Haga clic en "Crear punto final": se encontrará en la configuración en la pestaña "Lógica empresarial", aquí debe especificar la siguiente configuración:
- "Ruta de punto final": el nombre del punto final, por el cual comprenderá su función;
- "Grupos de puntos finales": el nombre del grupo en el que se ubicará;
- "Tipo de solicitud" - seleccione "POST";
- "Proceso comercial": seleccione el proceso comercial send_email que creó.
Luego vaya a la pestaña "Middleware".
En la pestaña "Middleware", debe configurar los derechos para realizar acciones con este punto final (y, por lo tanto, para iniciar el proceso comercial asociado). En otras palabras, especificará quién puede enviar correos electrónicos desde su aplicación. Para hacer esto, debe cambiar la configuración del token de autorización "Token Auth".
¡Atención! Si esta configuración no se cambia, ¡todos los usuarios tendrán derecho a enviar correos electrónicos!
Haga clic en el ícono de ajustes al lado de "Token Auth". En la ventana abierta, active el selector, en el campo "Grupos permitidos", seleccione el grupo "Administradores" (o cualquier otro al que desee dar acceso). Clic en Guardar"
Ahora guarde el punto final haciendo clic en "Crear".
Los procesos de envío de mensajes están configurados. Ahora puede crear una representación visual del formulario de envío de mensajes.
Forma
Para crear un formulario, regrese al editor de la aplicación web, a la pestaña que creó anteriormente. Arrastre un elemento de formulario al lienzo de la página.
En la ventana abierta, haga clic en "Crear registro", la lista de puntos finales disponibles se mostrará en el campo "Guardar registro en"; seleccione el que acaba de crear. Haga clic en "Asignar".
La forma que creó aparece en el lienzo. Haga clic en la imagen del engranaje para ir a su configuración.
En la pestaña "Look & Fee", ingrese un título para el formulario en el campo "Título". Aquí también puede cambiar su apariencia y ver el nombre con el que está registrado en la configuración.
En la pestaña "Datos": información sobre el modo del formulario y el punto final. También aquí puede cambiar la ubicación de los campos moviéndolos entre sí.
Organice los campos en un orden lógico: Remitente, Dirección, Asunto, Mensaje. Para cambiar la configuración detallada de cada campo (por ejemplo, su nombre), haga clic en el ícono de ajustes al lado. Haga clic en "Guardar" para guardar sus cambios.
Agregar un botón para un formulario
Para que el formulario funcione, debe agregar un botón de confirmación de envío. Use el elemento "Botón": arrástrelo con el puntero del mouse al área debajo del formulario.
Abra la configuración del botón haciendo clic en él. En la pestaña "Look & Feel", cambie la "Etiqueta" (el nombre del botón que será visible en la aplicación) y "Nombre" (el nombre que se mostrará en la configuración).
En la pestaña "Activadores", agregue una acción al activador onClick: en el campo "Objetivo", seleccione su formulario, en el campo "Acción", seleccione "Enviar formulario". Clic en Guardar".
Preservación, publicación y verificación
Guarde todos los cambios realizados, publíquelos, haga clic en el icono Ir a la aplicación.
Introduce los datos para enviar el mensaje. Si deja el campo del remitente vacío, el nombre que ingresó en la configuración del módulo se agregará automáticamente. Envíe un mensaje de prueba a cualquier dirección de correo electrónico a la que tenga acceso.
Después del envío, debería aparecer un mensaje de confirmación y aparecerá una carta con los datos especificados en el destinatario en la carpeta Bandeja de entrada.
Si hiciste todo de acuerdo a las instrucciones, pero en lugar de confirmar te sale un error o la carta termina en la carpeta de "Correo no deseado", escribe a nuestro canal de telegram de soporte técnico.
