Knowledge base
1000 FAQs, 500 tutorials and explanatory videos. Here, there are only solutions!
This guide explains how to add tags (codes and variables) into the body of your text to personalize your emails with Infomaniak Newsletter.
Manage Custom Fields
To add a variable (such as name, surname, etc.) into your text from a field present on your subscriber list, you simply need to, in a wysiwyg theme, click on the button titled CUSTOM FIELDS to insert the desired field.
With a pure HTML template, insert the name of the variable in uppercase surrounded by asterisks and separator dashes: *|VARIABLE-NAME|*
For the names/surnames of your subscribers, the tags are:
*|FIRSTNAME|**|LASTNAME|*
This variable can also be integrated into an HREF link, for example https://domain.xyz?name=*|LASTNAME|*
To place an unsubscribe link ("unsubscribe") at the desired location, insert *|UNSUBSCRIBED|* but without any action on your part, this link is automatically inserted at the bottom of your Newsletter.
To manually add a link to an online version of your newsletter, insert *|ARCHIVE|* but without any action on your part, this link is automatically inserted at the top of your Newsletter.
This guide shows how to create / import / manage contacts within Infomaniak's Newsletter.
Prerequisites
- have explicit consent from your recipients via the double opt-in model (sending spam and using purchased/rented address lists are prohibited)
Building a Subscriber List
- duplicates will be automatically removed
- importing does not send any message to the added contacts (so read and accept the prerequisite above)
To access the subscriber management of the Newsletter :
- log in to the Infomaniak Manager (manager.infomaniak.com) from a web browser like Brave or Firefox
- click on the icon at the top right of the interface (or navigate using the left sidebar menu, for example)
- choose Newsletter (universe Events & Marketing)
- if necessary, click on the name of the relevant domain in the displayed table
- click on Subscribers in the left sidebar menu
- click on the blue button Add contacts
- read and accept the Terms of Service
- choose from the different ways to build a subscriber list:
A: Import a .csv or .txt file (predefined format)
The format must be respected (a template is available for download on the page). Maximum size: 300 MB
Once the spreadsheet document type is prepared, export it to .csv which will create a kind of text document with separators between each piece of information present in the different cells:
Select the .csv file from the import interface and then click on the blue button Import:
The desired field must be assigned to the desired information (the information is grouped according to the original columns). It is possible to create fields that do not yet exist (e.g., birthday date), as well as groups in which to place the imported contacts:
That's it, whether under Groups or Subscribers, your import is visible:
B: Copy/paste the equivalent of a .csv or .txt file (predefined format)
The format must be respected, for example:
anna.a@domain.xyz,Anna,Alpha,1985-08-20
alfred.a@domain.xyz,Alfred,Alpha
contact@domain.xyz,Support
mail@domain.xyz
Once this information is pasted into the dedicated field, click on the blue button Continue. The rest is identical to point A above.
C: Filling out an individual contact form
Import contacts one by one using the provided form. Add free fields and groups, which will all be available for subsequent additions (except in the example animation below, as it loops on a first single addition):
D: Automatic import from other Infomaniak tools
Import contacts from your Infomaniak address books and from the Infomaniak ticketing tool if available (with the option to only import users who have specified wanting to receive a Newsletter).
Deleting Subscribers
To remove subscribers from the Newsletter :
- log in to the Infomaniak Manager (manager.infomaniak.com) from a web browser like Brave or Firefox
- click on the icon at the top right of the interface (or navigate using the left sidebar menu, for example)
- choose Newsletter (universe Events & Marketing)
- if necessary, click on the name of the relevant domain in the displayed table
- click on Subscribers in the left sidebar menu
- click to search or filter a type of subscriber if necessary
- click on the box to select one or more subscribers
- click on Delete
- confirm deletion
You can also click on Unsubscribe instead of Delete so that the contacts remain in the list. To review them, you will need to modify the default filtering on the table, and choose Unsubscribed:
Exporting Subscribers
To export the list of subscribers to the Newsletter, in .csv format and according to chosen criteria:
- log in to the Infomaniak Manager (manager.infomaniak.com) from a web browser like Brave or Firefox
- click on the icon at the top right of the interface (or navigate using the left sidebar menu, for example)
- choose Newsletter (universe Events & Marketing)
- if necessary, click on the name of the relevant domain in the displayed table
- click on Subscribers in the left sidebar menu
- click to search or filter a type of subscriber if necessary
- click on the box to select one or more subscribers
- click on Export
- click on the blue button once the export is prepared to download the .csv file
The file contains these columns:
- Status
- Sent
- Opens
- Clicks
- Subscription Date
- firstname
- lastname
- ip register
- and the manually created free fields (text, number, date, etc.)
This guide presents the conditions available to segment and filter your contact lists when sending a newsletter.
Segment contact lists
- open the Newsletter tool: https://newsletter.infomaniak.com
- open a draft or create a new newsletter
- in step 4 (Contacts), add one or more contact lists
- tick the box "Send to a segment of selected contacts"
- choose the filters you want
- click on Update at the bottom of the page to apply the filters
Filters / Conditions available for segmentation
It is possible to filter contacts according to actions performed or not, their registration dateand some customised fields. You can apply several conditions and add "OR" conditions in order to refine your filters. For example, it is possible to send a newsletter to all your contacts who have opened the 5 last newsletters OR who have opened a specific campaign.
Conditions available for the actions:
- filter contacts who have opened or not 1 / the last 5 / or a specific campaign
- filter the contacts who have clicked or not on one of the links from 1 / the last 5 / or a specific campaign
- filter contacts who have received or not 1 / the last 5 / or a specific campaign
Conditions available for the registration date:
- filter contacts registered on DD/MM/YYYY
- filter contacts registered after or before DD/MM/YYYY
- filter contacts registered between DD/MM/YYYY and DD/MM/YYYY
Conditions available for the customised fields:
- filter contacts whose customised field XXX is or is not DDDD
- filter contacts whose customised field XXX contains or does not contain EEEE
- filter contacts whose customised field XXX starts with FFFF
- filter contacts whose customised field XXX ends with GGGG
This guide explains how to create a token, or API key (also known as a token), for the API tool of Infomaniak Newsletter.
Obtaining a Token
To obtain a Newsletter API key:
- Log in to the Infomaniak Manager (manager.infomaniak.com) using a web browser such as Brave or Firefox.
- Click on the icon in the top right corner of the interface (or navigate using the left sidebar menu, for example).
- Select Newsletter (universe Events & Marketing).
- If necessary, click on the name of the relevant domain in the displayed table.
- Click on API Key in the left sidebar menu.
- Click on the blue Generate a Key button.
- Click the blue Create a Token button.
- Choose the appropriate product from the dropdown menu.
- Select a validity duration.
- Click the blue Create a Token button.
- Enter the Manager login password as prompted.
- Copy the token securely - it will no longer be accessible after this.
Refer to the Newsletter API documentation.
This guide details the rules to follow when sending emails from Infomaniak to multiple recipients without it being considered spam.
Obtaining Recipient Consent
Infomaniak is a Swiss host governed by Swiss laws. These federal laws and our terms of service stipulate that potential recipients must give their consent before being added to an email mailing list.
To have a user's registration for a newsletter considered voluntary, the user must:
- have entered their email address in a form dedicated to a specific topic
- have clicked on a validation link automatically sent after registration (point 1); this registration should only concern the topic specified at the time of registration
- be registered by the Newsletter system with their IP address and the date
This is called a double opt-in registration. The term "double opt-in" refers to a registration process in which a user takes two distinct actions to confirm their intention to receive communications, typically newsletters or marketing emails.
The owner of an email address can report any received message as spam at any time. Collecting subscriber registrations through double opt-in is the only way to protect against a potential spam complaint.
What to Do in Case of a Spam Complaint ?
As an email provider, Infomaniak must demonstrate its cooperation in the fight against spam and ensure that all of its customers are not blocked/blacklisted by potential complainants' email providers.
In the event of a spam complaint, Infomaniak may temporarily suspend deliveries and ask the message sender for proof of the complainant's registration; if provided, the complaint will become invalid.
However, the complaint will be justified if no registration proof is provided, and Infomaniak may be forced to take action: suspension of the email address, domain name, or contract termination in case of repeat offenses.
How to Stay Compliant?
If you wish to conduct email campaigns, make sure you have the information from point 3 above (IP address and registration date of each subscriber). This process ensures that the user has expressly confirmed their desire to receive communications, thereby strengthening the legitimacy of the subscriber list and reducing the risk of spam or unauthorized registration.
It is advisable to build your list by inserting a contact form on your website that will ensure the collection of your subscribers' email addresses via double opt-in.
An unsubscribe link must also be visible and included at the bottom of each of your newsletters.
This guide explains how to use the Infomaniak Newsletter tool with an external domain (not managed by Infomaniak).
Linking an External Domain
To access your Newsletter:
- Log in to the Infomaniak Manager (manager.infomaniak.com) using a web browser like Brave or Firefox
- Click on the icon in the top right corner of the interface (or navigate through the left sidebar menu, for example)
- Choose Newsletter (under Events & Marketing)
- Click on the Add a domain button (if necessary)
- Select Other domain from the dropdown menu (if necessary)
- Enter the domain name with which you want to send newsletters (the domain must belong to you)
- Click the blue Approve button
- Add the TXT / CNAME / DKIM records that you will receive by email and can be seen on the interface by clicking the button at your registrar:
This guide explains how to manage Soft Bounce and Hard Bounce errors that can occur in email delivery, especially when using Infomaniak Newsletter.
Hard Bounce
A hard bounce is an email that cannot be delivered for permanent reasons.
- Email sent to a non-existent address
- Recipient's email domain is not a real domain
- Recipient's server does not accept emails
- And so on.
Soft Bounce
A soft bounce is an error message indicating that the email is not delivered to the recipient and corresponds to a temporary routing problem: the email address is valid, and the sender can retry the delivery.
Several reasons can explain a soft bounce, indicating that the recipient's server temporarily refuses the email:
- The recipient's inbox is full: due to insufficient storage capacity, the recipient no longer receives messages
- A problem occurs at the recipient's email server: the server is temporarily unavailable or down, or the user has unintentionally set up filters that prevent the reception of certain messages
- When the email content, especially its attachments, is too large, the routing problem occurs at the time of sending
Unless the recipient has permanently abandoned their inbox without deleting their account, a soft bounce is a temporary issue.
This guide explains how to freely integrate emojis / emoticons / smileys into the title and content of an Infomaniak Newsletter.
Displaying Emoticons
on macOS
Press the keys CTRL + CMD ⌘ + SPACE
on Windows
Press the keys WINDOWS LOGO + PERIOD (.)
Alternative method:
- Right-click on an empty area of the taskbar
- In the menu, click on Show touch keyboard
- An icon of a keyboard will then appear in the bottom right corner of your screen
- Click on this icon to bring up the virtual keyboard
- Click on the key with a smiley face at the bottom left of the keyboard
- Use the different Windows emojis
Example of using an emoji in the title
Example of using an emoji in the body / content
This guide is about authentication tokens or tokens from Infomaniak, which are used to verify the identity of the application and grant it specific permissions to interact with Infomaniak's API functionalities and data securely.
Generate an Infomaniak API token
Authentication tokens or tokens are used to verify the identity of the application and grant it specific permissions to interact with the API functionalities and data securely.
To access the Infomaniak API, it is necessary to generate an access token. Its default duration is "unlimited" but it is possible to define a custom duration at its creation.
Attention, if no calls are made with the token for a year, it is automatically deactivated. It will then be necessary to generate a new one. There is no limit to the number of tokens you can create.
At the time of its creation, you will be able to choose the application and the scope accessible by the token (to correspond to your current need and project).
Add / retrieve a token
API keys are managed on this page of the Manager:
To do this:
- Click the blue Create a token button
- Choose the appropriate product from the drop-down menu according to your current need and project
- Choose a validity period
- Click the blue Create a token button
- Enter the Manager login password as requested
- Copy the token securely - it will no longer be accessible after that
Example of application: token for the Newsletter API
This guide explains how to receive an email notification when a new subscriber signs up to your newsletter using one of your contact forms.
Being notified when a new contact subscribes
- Open the Newsletter tool (newsletter.infomaniak.com) and choose the domain concerned
- Click on Subscription forms in the left menu
- Click on the form for which you want to follow subscriptions
- Check the box Receive an email when there is a new subscription
- Click on Save to confirm the changes
You will then receive an email as soon as a contact subscribes to your newsletter using this subscription form.