Envío de emails
Los metadatos email_* que rellenan la vista previa del correo, cuándo el documento viaja como PDF adjunto y desde qué remitente sale.
Los metadatos email_* que fija un documento dinámico con F.MetaData_Set rellenan la vista previa de Enviar por email en el visor de Play: remitente, destinatario, copias, asunto, cuerpo y nombre del adjunto.
Todos son opcionales: lo que falte lo escribe quien envía. Los metadatos rellenan el correo, no lo envían.
Cuerpo o adjunto
Lo decide email_body:
email_body | Cuerpo del correo | Adjunto |
|---|---|---|
| Sin fijar | El documento renderizado | Ninguno |
| Con texto | Ese texto, en HTML | El documento convertido a PDF |
| Con el ID de otro documento dinámico | El HTML de ese documento, ejecutado con las mismas respuestas | El documento convertido a PDF |
El PDF sale como en Cómo convierte Dinaup a PDF. En DemoUp, Factura - Moderna se imprime y apunta por su ID a Factura - Plantilla de Email, que es el cuerpo:
F.MetaData_Set('email_body', S.DynamicDocuments.Correos.FacturaPlantilladeEmail.ID)Metadatos
| Clave | Qué rellena |
|---|---|
email_subject | Asunto. |
email_body | Cuerpo al adjuntar: HTML o el ID de otro documento dinámico. |
email_to | Dirección del destinatario. Hasta 100. |
email_to_name | Nombre del destinatario. Con varias direcciones, va con la primera. |
email_from | Dirección del remitente. Exige dominio verificado. |
email_from_name | Nombre visible del remitente. |
email_cc | Direcciones en copia, CC. |
email_bcc | Direcciones en copia oculta, CCO. |
email_replyto | La dirección de Responder a. En el SDK es Email_ReplyTo. |
email_attachment_name | Nombre del PDF adjunto. Sin él se usa el metadato titulo. |
email_to, email_cc, email_bcc y email_replyto admiten varias direcciones separadas por comas y se pueden fijar varias veces: F.MetaData_Set numera la clave repetida (email_bcc1, email_bcc2), también vale numerarla a mano (email_bcc_1) y Play las reúne.
F.MetaData_Set('email_cc', '[email protected]')
F.MetaData_Set('email_bcc', '[email protected]')
F.MetaData_Set('email_bcc', '[email protected]')
F.MetaData_Set('email_replyto', '[email protected]')Con varias direcciones en email_to, cada una recibe su propio correo y solo ve la suya en Para. La primera lo recibe con el CC y el CCO; las demás, sin CC. Con un solo destinatario, email_to_name pone su nombre en Para; el saludo del cuerpo lo escribe la plantilla.
Remitente
La vista previa usa el primero que valga:
email_fromyemail_from_namedel documento.- El remitente predeterminado de la empresa, configurado en Play.
[email protected]con nombre Dinaup.
Una dirección propia solo vale si su dominio está verificado en la licencia. Si no, la vista previa pasa a la siguiente y avisa: No se puede enviar desde X porque su dominio todavía no está verificado. Desde una dirección propia, el remitente recibe copia oculta.
La vista previa
Deja corregir el Email destinatario, el Nombre destinatario, el Asunto y el cuerpo, y abre CC, CCO y Responder a si la plantilla trae alguno. Enviar correo exige dirección y asunto, y no envía con una dirección mal escrita, más de 100 destinatarios, más de 48 en CC ni más de 500 en CCO.
Un correo por destinatario
Con la marca {{email_to}} en el asunto o el cuerpo, cada dirección de Para, CC y CCO recibe su propio correo con su dirección en el sitio de la marca. Dentro de un enlace, usa {{email_to_urlencode}}, la misma dirección codificada para URL.
<a href="https://miweb.com/alta?email={{email_to_urlencode}}">Darme de alta</a>{{email_destinatario}} equivale a {{email_to}}. Play cambia la marca al enviar: en el documento y en la vista previa se ve tal cual.
Ejemplo
F.MetaData_Set('email_subject', F.Concat('Factura ', D.EmpresaActual.TextoPrincipal, ' nº ', v.Factura.NumeroDeFacturaCompleto, ' - ', v.Factura.DenominacionRazonSocialCliente))
F.MetaData_Set('email_body', 'Hola,<br>te envío la factura para que la revises.<br>Un saludo.')
F.MetaData_Set('email_to', v.Factura.ReferenciaCliente.CuentaDeCorreoPrincipal)
F.MetaData_Set('email_to_name', v.Factura.DenominacionRazonSocialCliente)
F.MetaData_Set('email_attachment_name', F.Concat('Factura ', v.Factura.NumeroDeFacturaCompleto, '.pdf'))