Manage message templates
In the Message Templates area (under Communication Management) you configure the content and design of automated notifications. Here you combine content, layout and formatting with the dynamic data from tebio in order to generate the appropriate message - by email or letter - for every system event.
When do I need this function?
Section titled “When do I need this function?”This function completes the communication configuration. After you have determined when the system will communicate in the event selection, you specify here what content will be communicated. A template is required for each selected event.
In the left menu, navigate to Communication Management > Message Templates. You will find two tabs here: Emails and Letters.
1. Create email template
Section titled “1. Create email template”Switch to the Emails tab and click on Create email template.
Metadata and subject
Section titled “Metadata and subject”- Event: From the dropdown, select the system event for which this template will be used (e.g. “Invoice Available”).
- Name and language: Assign an internal name and specify the language.
- Subject: Write the subject line. (Tip: You can type the character
@to directly insert dynamic parameters, such as an invoice number, into the subject).
Editor and live preview
Section titled “Editor and live preview”In the Customize Template section you will find the editor on the left and a live preview on the right.
- You can switch between a comfortable Text mode (WYSIWYG editor for formatting such as bold, italics or tables) and HTML mode for individual layout adjustments.
- Variables (Go templates): The system uses a template language (Go). You can view available variables via template parameters. These variables are written in curly brackets (e.g.
{{ .productName }}) and are automatically filled with the customer or process data when sent. Logic queries like{{ - if .productName }}are also possible in HTML mode.[!TIP] You can find a comprehensive overview of all available variables for all events in our reference: Variable and placeholder reference.
- Live Preview: After making any changes, click anywhere in the preview window on the right to instantly visually check your design. To improve readability when editing, the system has stored an example text for each parameter, which is displayed in the preview instead of the technical variable.
2. Create a letter template
Section titled “2. Create a letter template”Creating letters is conceptually almost identical to email. Switch to the Letters tab and click on Create letter template.
[!NOTE] Print Settings: To specify whether the letter should be sent in color, both sides or as registered mail, you must go to the Communication Channels area. The delivery type (letter details) is defined globally for the channel and not for the individual template.
Special feature of the letter: The footer editor
Section titled “Special feature of the letter: The footer editor”In addition to the normal text window, the letter template below offers special settings for the standardized letterhead.
- The stationery has up to three footer columns at the bottom.
- If you click on one of these columns in the live preview, the corresponding editor opens on the left.
- You can define up to 5 lines of text per column (lines 0 to 4). Please note the character limits specified in the interface (maximum 25 or 27 characters per line) so that the text fits neatly into the standardized column of the E-POST.
Finally, save your templates using the Create or Save changes button.
Notes and typical errors
Section titled “Notes and typical errors”- Syntax errors in the code: When working in HTML mode, pay careful attention to the closing brackets of the Go templates. A forgotten
{{ end }}can mean that the message cannot be generated later by the system. - Wrong event selected: If you build a template but select the wrong “event” in the dropdown, the system will not send a message when the actual desired trigger arrives because it cannot find the association.
Your template is set up and ready to use for the selected event. Together with communication channels and event selection, tebio can now send appropriate messages to customers.
API Notes
Section titled “API Notes”You can manage templates for emails, letters and other messages via the API and, for example, make them available in tebio from a Git repository via the CI/CD pipeline.
- Search email templates: Search email templates
- Create email template: Create an email template
- Search letter templates: Search letter templates
- Manage message categories: Search messaging categories