Knowledge base

This guide explains how to create an API key for the Infomaniak Newsletter tool.

Getting an API key

1. Open the newsletter tool (https://newsletter.infomaniak.com)
2. Click on the relevant domain
3. On the left-hand menu, click on API key
4. Click on Create an API key

Read the Newsletter API documentation.

This guide presents the conditions available to segment and filter your contact lists when sending a newsletter.

Segment contact lists

1. open the Newsletter tool: https://newsletter.infomaniak.com
2. open a draft or create a new newsletter
3. in step 4 (Contacts), add one or more contact lists
4. tick the box "Send to a segment of selected contacts"
5. choose the filters you want
6. 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 the credits system for our new email service works.

Managing credits for sending newsletters

Generally, 1 credit = 1 newsletter sent.

There re two types of credits:

1. The credits offered wit heach of our Infomaniak products (not reported in the following months in the event of non-use)
2. The credits purchased (the shelf life is unlimited)

The credits offered are debited before the credits purchased.

Find out more

• Sending prices
• Video presenting the tool

To use the Newsletter tool automatically, you must manage the domain name you want to send your newsletters from (as well as its DNS zone) in the new Infomaniak admin console in order to use the Newsletter tool. For example, if you send your newsletters from the address name@test.com, the domain test.com must be managed with Infomaniak.

It is possible to use the Newsletter tool with a domain that is not managed with Infomaniak, you must add specific entries, which we will provide, into your DNS zone.

• If you transfer the domain name you use to send your newsletters to another registrar, you can no longer use the Newsletter tool and your account will be automatically disabled after 45 days.

This guide shows how to export and save contacts from the old newsletter tool in a .csv file

Exporting contacts in a .csv file

To import these contacts to the new newsletter tool: https://faq.infomaniak.com/2165

This guide explains why a newsletter might be blocked from being sent and how to continue sending a blocked newsletter.

Why block a newsletter from being sent?

Please be aware of the following steps:

• A newsletter is blocked from being sent if too many of the recipient email addresses are invalid
• A newsletter may be blocked if the SPAM rate is too high
• After a newsletter has been blocked, you must contact our support team to be able to send the blocked message

In order to avoid this situation:

• use only contact lists you have made up yourself
• make up your contact lists with double opt-in forms (to find out more)
• remove contacts you have not written to for over 6 months. Seldom-used contact lists also risk containing obsolete email addresses
• if needed, automatically clean your subscriber list with services such as neverbounce, bounceless or quickemailverification

Completing the sending of a blocked newsletter

After you have contacted our support team to unblock the sending:

1. open the newsletter tool (https://newsletter.infomaniak.com)
2. go to Newsletters
3. click on the newsletter which has been blocked from being sent
4. go to the last step Validation & Sending
5. click on Send the newsletter. The newsletter will automatically be sent to the contacts which have not yet received it

This video guide shows how to use the Infomaniak newsletter tool to create and send a newsletter.

Creating and sending a newsletter

Find out more about the Infomaniak newsletter tool

Sending a newsletter

This guide shows how to import contacts using a .csv file. This allows you, for example, to recover all contacts from another newsletter tool like MailChimp or the old Infomaniak newsletter tool.

Importing a .csv file

This video guide shows how to create a registration form and integrate it on a WordPress site using a Widget. A registration form allows visitors to a site to subscribe to a newsletter and to be added to one or more contacts lists.

Creating a registration form

Comments

• You must have at least one contacts list to create a registration form
• One registration form can update several contacts lists
  

If you do a test send of your Newsletter (last step before the final send)

then it is normal for the links present in your sent message during the test (top part: "READ THIS EMAIL IN MY BROWSER" = link to see the message in a browser and bottom part: "UNSUBSCRIBE" = link to allow the user to unsubscribe) to not work.

They will of course be functional when you actually send the newsletter.