Vizlib Home
Welcome
Login

Vizlib Teamwork Guides - Email Template

When you set up a Vizlib Teamwork integration, you can choose between using Email, Slack or Microsoft Teams to notify users of events or changes e.g. when a user is mentioned in a thread. 


TABLE OF CONTENTS


Email Integrations - v2.2.0 Update


Email Integrations are managed in the Vizlib Management Console (VMC) and settings include a template to manage the notification email layout and content. Until v2.2.0 of Teamwork the template generated an email similar to Figure 1


Figure 1: Email Notification before Version 2.2.0


In Release v2.2.0 of Vizlib Teamwork we've updated and improved the email template to help you create and manage email notifications. This article outlines the features for the updated email template. 

Note: To access the VMC and work with email integration settings, you need to have installed Vizlib Server. If you'd like to know more about Vizlib Server, please see our introduction here


Back to Contents


Getting Started


Email Template Settings are found in the VMC under Server > Integrations, which will displays a list of available integrations. If you click the integration name you'll open the Update Integration screen (Figure 2), or if you need to set up a new integration click Add Integration to open the Add Integration screen and select email from the Type dropdown.


Figure 2: Update Integration


There are 4 tabs in the screen - SMTP server settings, Template Editor, Mentions Template Editor and Templates Preview. The open tab displayed in the edit screen will be underlined in blue. 


Back to Contents


Email Template Tags


It's now much easier to build a template in the editor by using tags to add elements of Teamwork content (Figure 3). You can use tooltip to identify a tag element, then click the icon to add it to the code. With tags, you can quickly and easily start to build a completely new email template.


Figure 3: Tags


If you see a green tick beside a tag, it's already been added to the code. On the far right of the editor, clicking Restore default template reloads your original code, in case you need to start again. You can use tags in both the Template editor and Mentions template editor


Back to Contents


Template Editor


The Template editor tab (Figure 4) holds the layout settings used in Teamwork email notifications. If you've already been using an email integration for Teamwork, your existing email template will have been populated in Template Editor for v2.2.0. 


Figure 4: Template Editor


In the updated Template editor screen, you can edit the code manually, and also add tags. As a result, you can adapt the look and feel of your email template to reflect your own branding requirements. The scrollable sidebar on the right lets you keep track of your location. When you're finished editing, click on Update Integration to save the template.


Back to Contents


Mentions Template Editor


The Mentions template editor (Figure 5) holds the template used in Teamwork notifications where the recipient has been mentioned by another user. The template uses the latest Vizlib branding, but it can be edited to accommodate your own branding, and lets you adapt a distinct look and feel for mentions notifications. The scrollable sidebar on the right lets you keep track of your location. When you're finished editing, click on Update Integration


Figure 5: Mentions Template Editor


If you want to read more about mentions in Teamwork, please see our article here


Back to Contents


Templates Preview


The Templates preview screen (Figure 6) displays a preview of an email notification. You can use the toggle to move between the different templates, and check the content of the email (e.g. whether to add an image). When you've finished, click on Update Integration


Figure 6: Templates Preview

Back to Contents 


Template Output - Notification Email


The template editor will now generate an email in the updated format (Figure 7).


Figure 7: Email Notification Format


Back to Contents


K
Kenneth is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.