Page History

Create new template

Pressing the button a modal window opens, allowing the creation of a new template.

The modal screen consists of two tabs: detail and preview. 

• Detail: Tab where the template is configured, with the following data Template type, identifier, content and variables (system and user).
• Preview: Tab where the user checks if the configuration is correct, before sending the template for approval. It is necessary to save the template data before going to the preview tab.

• Template Type : This selection field allows the user to select the type of template, this type informs about the use that will be given to the email generated with the template. The types of templates that a user can select are the following:
  
  • SignatureRequest (SignatureRequest): For signature request emails sent to EviSign signers.
  • Final Notification (FInalNotification): For final notification emails sent to signatories of an EviSign.
  • Progress (Progress): For email communications that inform the signer and sender about the progress of an EviSign (Rejections, Signatures, Expirations).
  • SignatureReminder (SignatureReminder): For signature reminder emails.
  • Notification Template (NotificationTemplate): To customize EviNotice notification e-mails
• Template identifier: This field allows the user to set an identifier to the template, this identifier is necessary to inform to make use of the template, for a site there cannot be two equal identifiers.
• Template content: This field is where the user will create the communication template, this template will be defined with HTML, and may include Liquid programming language content.
• Variables: The content of templates can contain variables, which during output can be reported by assigning them a value. There are two types of variables
  
  • Environment variables: These are variables that are currently used by the environment to compose a template, these variables contain specific data of the issued evidence. See more details of this type of variables in the section "Template variables".
  • User variables: These variables are created by the user when creating the template. They are used within the template content to report data that system variables can report. 

Once the user has selected the type of template, entered an identifier, configured the content of the template with the appropriate variables, the result can be previewed by pressing the save button. .

In the preview screen, a Grid will appear, with the mandatory system variables for that type of template and the user variables that have been previously configured. Next to these variables a text box allows you to edit values to see how the result would look like when rendering the template. 

To view the template, the user must click on the preview button. . At this point the system will render the HTML of the content, replace the variables with the test values and display it on the screen.

At this point the user can decide whether to make any further modifications to the template or "Request Approval".  Pressing the button a validation process starts in which there will be an automatic validation and a manual validation.

• Automatic validation: The system checks that the content of the template is correctly configured, that the mandatory system variables have been used for that type of template, and that no non-allowed components are being used (see restricted components).
• Manual validation: Our support staff checks in an exhaustive way, supported by documentation, that the content of the template is in accordance with the type of template selected. Once the template has been checked and found to be correct, the support staff approves the template and it becomes active.

Best practice guide for creating a template

To create a new template and have it approved, the following aspects should be taken into account:

• Avoid excessive images:  Excessive use of images can affect the ability of the template to load in the email, which in turn can decrease the open rate. Therefore, it is recommended to have a limited number of images and keep their size under control. As for the request to convert images to "inline" in base64, this helps to reduce the overall size of the email, which makes it easier to load and render the email.

  • Convert 'inline' (base64) images to reduce rendering overhead.

    Code Block
    language xml title Ejemplo imagen base 64 inline
    <html> <body> <h1>Bienvenido</h1> <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIA..." alt="imagen"> <p>This is an example of an e-mail with an image.</p> </body> </html>

    
    

  • Templates must not contain more than 3 images larger than 48x48 pixels.
  • templates must not contain more than 8 images smaller than 48x48 pixels (usually used for social network icons). 
  • The sum of images and content must not exceed a file size of 1MB.
• Restricted components: The following content cannot be used in templates to prevent mail managers from blocking emails on suspicion.
  
  • javascript
  • animated gifs (whenever possible)
  • <iframe>
  • embedded audio
  • embedded video
  • forms.

• Suspicious links: Suspicious links should not be used in the template.

• Appropriate text for the type of notification of the template:  It is important that the template text is clear, concise and appropriate for the type of template being created.  It should be easy to understand and not confusing to the recipient. Below are the different types of templates separated by product:
  • EviSign 
    • Signature Request/Signature Reminder:
      • The text should refer to the issuer's request for a signature.
      • It must contain the mandatory variables for this type of template. 
    • Final Notification: The text must be clear that it is a final notification of the signing process, where the guidelines for obtaining the Affidavits are given..
      • Text indicating that it is a final notification.
      • Steps for accessing generated evidence
      • Link to the evidence generated.
      • It must contain the mandatory variables for this type of template. 
    • Progress: Using Liquid programming code, this type of template can be used to communicate the following statuses (Rejected, Signed, and Expired)
      
      • Rejected: The text must be clear informing that there has been a rejection of the main document by one of the signatories. It must contain the mandatory variables for this type of template. 
      • Signed: The text must be clear informing that there has been an acceptance of the main document by one of the signatories. It must contain the mandatory variables for this type of template. 
      • Expired: The text must be clear informing that a signature process has expired without being signed. It must contain the mandatory variables for this type of template.
  • EviNotice
    • Notification Template:
      • Text stating that a notification has been sent and that the recipient can access it from a button or link.
      • It must contain the mandatory variables for this type of template. 

• Text that avoids being labeled as spam or suspected of phishing: To avoid being labeled as spam, it is important to use clear and simple language in the content of emails, and avoid excessive use of suspicious or sensationalist words. In addition, it is important not to use words that may trick recipients into opening the email, as this may be considered phishing or deceptive practices.

• The signature button (read document) must be visible to the signer: In the case of EviSign and the signature request template type, the signature process access button must be clearly visible to the recipient, so that they can easily identify how to proceed with the signature. The button must have a link that is set with system variables.

• The link to the signature process should appear: In the case of EviSign and the signature request template type, in addition to the signature button it is also mandatory that the access link to the signature process appears. This link is established by using system variables.

• GDPR policy text must appear:  This text should mention that Evicertia will act as Data Controller in direct communications to Notifyes and/or Signatories. The text should be something similar to the following:

  Code Block
  language xml title GDPR
  Evicertia is a service of EVICERTIA S.L. (NIF ESB86021839) that as a certification service provider, assumes the role of trusted third party, according to the requirements of the European and Latin American regulations in force regarding electronic commerce and signature. Evicertia is managed by certified auditors and experts in computer security, who protect it as independent witnesses of the communications and declarations of will that are made through it. Evicertia has been recognized as legally valid evidence by the Supreme Court of Spain (cassation order of 21/03/2013 no. 855/2010 of the 1st Chamber). EVICERTIA S.L. informs you that your personal data have been obtained through the issuer of this electronic communication/notification and will be processed for the sole purpose of making available to you the documents issued by the issuer for signature or notification, obtaining evidence of the process and keeping them for the contractual and legally established term. The recipient may exercise his rights by writing to support@evicertia.com, indicating in the reference "Data Protection". Additional information about your rights or the processing of your data is available at https://www.evicertia.com/en/privacy-policy. You can also contact the national authority if you consider that your rights have been violated. You can also obtain more information about the service on the website: www.evicertia.com. This message is addressed exclusively to the addressee and may contain confidential information and/or information subject to professional secrecy, the disclosure of which is not permitted by law. If you have received this message in error, or have any questions about the security of the process, please notify us immediately by email to our attention at support.evicertia.com or by email to support@evicertia.com.

  This text can be composed with the help of environment variables for links and e-mail addresses.

Variables in templates

The variables are divided into environment and user variables.

Environment variables:

These are variables that the application has configured and that obtain their value from sent evidence data or from global data that are shared by all the sites of the platform.

User variables:

User variables:

They are variables that the user declares during the creation of the template. These variables can be used in the content of the template you are creating and They are variables that the user declares during the creation of the template. These variables can be used in the content of the template you are creating and when using the template via web service the variables and their value are reported.

These variables can only be created at template design time, when the template is in draft state. In the detail tab at the bottom there is initially a table of variables. Pressing the button  a row is added to the Grid allowing you to enter a user variable, to define a user variable you must configure:

• Variable : Variable name, to be used in the content and in the call to the Web Service.
• Value: A default value should be set, so that the site administrator user and the support team person can preview the result.Requerido: Este check indica si la variable debe ser informada siempre. 
  
  • True: Must be reported in each request
  • False: It is not mandatory to report on every request.

To delete a variable entered by mistake or for any other reason, click on the icon  that appears in the Grid line corresponding to the variable to be deleted.

 Once the variables have been declared, they can be used in the HTML content of the template. In order to distinguish user variables from system variables, the variable name must contain the preface variables and be between keys {{}}, e.g:

• We declare the variables PostalAddress, PostalCode and we want to make reference to them in the content, for this in the part of the content that interests to introduce the postal code we would write {{variables.PostalCode}}  and in the part where you want to enter the postal address type  {{variables.PostalAddress}}.

The following is a small example using system and user variables.

<html>
<head>
</head>
<p>Request for signature of <b>{{Issuer}}</b> , about <b>{{Subject}} </b></p>
<table><tr><td>Signer name: </td><td>{{Signer}}</td></tr></table>
<table><tr><td>Signer Address: </td><td><b>{{variables.PostalAddress}}</b> CP: {{variables.PostalCode}} </td></tr></table>
<a href="{{DeliveryURL}}" class="buttonread">Sign documentation</a>
</html>