El módulo SMTP personalizado agrega configuraciones básicas para permitirle enviar correos electrónicos directamente desde su aplicación.

Para que el formulario de envío de cartas aparezca en la aplicación, debe agregar las configuraciones que faltan y los elementos necesarios. El algoritmo de acciones será el siguiente:

  1. Agregue una página o ventana donde se ubicará el formulario de carta.
  2. Conecte el módulo, agregue los parámetros del servidor SMTP, así como su nombre de usuario y contraseña.
  3. Cree procesos de negocios, puntos finales y formularios relacionados con módulos.

Vamos a mostrar cómo hacer esto en una aplicación web usando el servicio de correo de Gmail como ejemplo.

Crear una pagina

Vaya al editor y cree una nueva página desde la que 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. La información básica sobre el módulo y un botón para eliminarlo de la aplicación se muestran a la izquierda. A la derecha están los campos que debe completar:

  1. En los campos "Iniciar sesión" y "Contraseña" introduzca los datos del buzón desde el que enviará los mensajes.
  2. 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.
  3. En el campo "De nombre", 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 .

Recuerde guardar sus cambios.

Creación de un proceso empresarial, un punto final y un formulario.

El proceso empresarial , el punto final y la forma son elementos interrelacionados que es importante configurar de forma coherente. Al interactuar entre ellos, completarán la configuración de su aplicación, y el formulario para enviar un mensaje aparecerá 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 empresarial 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 pueda 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 empresarial, 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 formulario de envío de mensajes futuros:

  • "Asunto": el asunto de la carta;
  • "Cuerpo": un campo con el texto de la letra;
  • "Para": la dirección del destinatario;
  • "Cc" - dirección para enviar una copia;
  • "Nombre del remitente": el nombre del remitente;
  • "Cco" 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 deslice el dedo hacia el campo "En" en el bloque "SMTP personalizado: Enviar correo electrónico": se forma una conexión entre los bloques.

2. Del mismo modo, cree un vínculo entre el campo "Salida" del bloque "SMTP personalizado: Enviar correo electrónico" y el campo "Finalizar" del bloque "Finalizar".

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. Imagina que no enviarás copias y copias ciegas, por lo que el bloque "Inicio" contendrá los siguientes campos:

  • "Remitente" (nombre del remitente): asociado con from_name;
  • "Dirección" (a quien 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 en tipo. El tipo de variable se puede ver haciendo clic en el bloque en el que está contenida y abriendo el menú de edición.


En los campos de los bloques, junto a 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 de tipo "String",
  • Para, cc y bcc son de tipo Matriz de correo electrónico.

Creando Variables

Para crear la primera variable en el bloque "Inicio", haga clic en ella; 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". Haga clic en "Crear".

De manera similar, agregue "dirección", "asunto" y "mensaje". Ahora la lista de variables en el bloque "Inicio" se ve así:

Vincúlelos a las variables correspondientes en el bloque SMTP personalizado: Enviar correo electrónico:

Así es como deberían verse al final las relaciones entre las variables. Guarde sus cambios y proceda a crear el punto final.

Punto final

Haga clic en "Crear punto final"; se encontrará en la configuración de la pestaña "Lógica empresarial", aquí debe especificar la siguiente configuración:

  • "Ruta del punto final": el nombre del punto final, mediante el cual comprenderá su función;
  • "Grupos de terminales": el nombre del grupo en el que se ubicará;
  • "Tipo de solicitud" - seleccione "POST";
  • "Proceso empresarial": seleccione el proceso empresarial 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 de negocio asociado). En otras palabras, especificará quién puede enviar correos electrónicos desde su aplicación. Para hacer esto, necesita 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 icono de rueda dentada junto a "Token Auth". En la ventana abierta, encienda 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.

Formulario

Para crear un formulario, regrese al editor de aplicaciones 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" l, 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. Utilice 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 "Destino", seleccione su formulario, en el campo "Acción", seleccione "Enviar formulario". Clic en Guardar".

Conservación, publicación y verificación

Guarde todos los cambios realizados, publíquelos, haga clic en ir al icono de la aplicación.

Ingrese 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 con las instrucciones, pero en lugar de confirmar sale un error o la carta termina en la carpeta "Spam", escribe a nuestro canal de telegramas de soporte técnico.