Pasos para la integración SMTP en Aldeamo

//Pasos para la integración SMTP en Aldeamo

6. Pasos para la integración SMTP en Aldeamo

Existe una serie de paquetes de software comerciales y de código abierto que admiten el envío de correo electrónico a través de SMTP. Estos son algunos ejemplos:

•Plataformas de blog.
• Agregadores RSS.
• Software de administración de listas.
• Sistemas de flujo de trabajo.
• Sistemas de gestión de requerimientos.
• CRM.

Puede configurar cualquier software habilitado para SMTP de este tipo para enviar correo electrónico a través de la interfaz de SMTP de Aldeamo. Para obtener instrucciones sobre cómo configurar SMTP para un determinado paquete de software, consulte la documentación de dicho software.

El siguiente procedimiento muestra cómo configurar el envío de correo electrónico automático con Aldeamo en JIRA, una conocida solución de seguimiento de Requerimientos. Con esta configuración, JIRA puede notificar a los usuarios por correo electrónico cuando haya un cambio en el estado de un problema de software.

Para configurar JIRA para enviar correo electrónico utilizando Aldeamo SMTP:

  1. JIRA solicita a su ejecutivo de cuenta en Aldeamo la creación de un usuario en la
    interfaz de envío de correo electrónico.
  2. JIRA solicita a su ejecutivo de cuenta en Aldeamo los parámetros necesarios para la
    integración SMTP.
    Importante: Las credenciales de uso del Protocolo SMTP son únicas para cada usuario. Si su organización necesita tener varios usuarios debe informarlo a su ejecutivo de cuenta en Aldeamo para la creación específica.
  3. En la ventana del navegador, elija Administration.
  4. En el menú System, elija Mail.
  5. En la página Mail administration, elija Mail Servers.
  6. Elija Configure new SMTP mail server.
  7. En el formulario Add SMTP Mail Server, rellene los campos siguientes:
    a. Name: Deberá dar un nombre descriptivo para este servidor.
    b. From address: “Usuario”: Credenciales de la dirección desde la que se enviará el correo electrónico.
    c. Email prefix: Una cadena que JIRA añade a cada línea de asunto antes del envío.
    d. Protocol: Elija SMTP.
    Nota: Si no puede conectar a Aldeamo utilizando esta configuración, pruebe SECURE_SMTP. e. Host Name: “Servidor SMTP”: Dirección del servidor de salida de correo electrónico.
    Ejemplo: email-smtp-2.aldeamo.com
    f. SMTP Port: “Puerto”: Puerto del servidor de salida de correo electrónico.
    Ejemplo: 2589
    g. TLS: Seleccione esta casilla de verificación.
    h. Username: Su nombre de usuario de SMTP.
    i. Password: Su contraseña de SMTP.
  1.  Elija Test Connection: Si el correo electrónico de prueba que envía JIRA a través de Aldeamo llega correctamente, su configuración está completa.
Ejemplo de la petición con Body HTML Puedes enviar cualquiera de tus plantillas creadas a través del servicio SMTP, para esto se debe modificar el asunto y el correo del mensaje. En el asunto, se debe añadir al comienzo la etiqueta *|tid:TEMPLATE_ID|* donde se debe reemplazar TEMPLATE_ID por el ID de la plantilla que se encuentra debajo del nombre en el listado de plantillas. Esta etiqueta será eliminada de forma automática del mensaje, luego de esta etiqueta se puede poner el asunto del mensaje, incluso se puede usar variables en el texto del asunto, por ejemplo:
*|tid:42eqy7oaigql|* Este es un mensaje para {nombre} {apellido}

IMPORTANTE: Si el mensaje no contiene variables, la versión HTML y PLAIN-TEXT deben tener solamente la palabra “null”.

¿Cómo usar variables en el correo SMTP?

Si la plantilla tiene texto variable, se puede enviar en el cuerpo del mensaje el valor de las variables y estas serán reemplazadas de forma automática en el correo enviado.
Para usar variables en la plantilla, se debe usar sintaxis {NOMBRE_VARIABLE} reemplazar por NOMBRE_VARIABLE por el nombre de la variable que se quiere reemplazar de forma automática.

No se debe usar caracteres especiales en el nombre de las variables (ñ,&;, signos especiales, caracteres con tilde, etc.) ya que estas pueden no ser reemplazadas debido a la codificación del código HTML del mensaje.

Para usar variable en el mensaje, el cuerpo del correo debe tener la siguiente sintaxis:

 

{"nombre_variable":"valor variable"}

Por ejemplo:

{
"var1":"Random variable 1",
"var2":"Random variable 2",
"var 3":"Random variable",
"var ñ 4":"Esta variable puede no ser reeemplazada debido a que contiene caracteres
especiales",
"var-5-5":"Random variable 5",
"var&":"Esta variable puede no ser reeemplazada debido a que contiene caracteres
especiales"
}

Este formato es conocido como Json, por lo cual es muy importante el uso correcto de las comillas y los corchetes para que el servicio funciona correctamente.

En los siguientes links se pueden ver ejemplos de código listos para usar:
Node Js (Usando modemailer)
PHP (Usando PhpMailer)

2021-06-24T12:46:38-05:00