Getting Started


After you have successfully installed the add-on you will need to make a few basic configuration settings before you can send your first email to Confluence.

To follow this guide you will need administrative rights. If you are not a Confluence Administrator you will need to ask a Confluence admin of your organization to do the steps for you.


Step 1 - Go to the Configuration Page

Go to the Confluence Welcome Page or any other page in Confluence. In the menu bar at the top right of your screen click on the Settings icon. Then select Manage apps from the drop-down.


Shows how to get to the general Settings in Confluence.

This will take you to an overview page which shows all of your currently installed add-ons. Find the mailto.wiki - Send Emails to Confluence add-on and expand the section by clicking on the title. Then click on the Configure button to go to the configuration page for the add-on.


Shows how to get to the configuration page of mailto.wiki.

Step 2 - Mandatory Settings

You should now see the configuration page for the add-on.


Shows the mandatory settings page of the add-on.

Before you can send your first email, you will have to do three things: set up your email server connection information, set the default space and the default content type.

Every email that you send to your registered email account will be automatically inserted into your default space as page or blog post, depending on what you configured as default content type. You can think of the default space as your INBOX.

First, you need to set up the email server connection information. For this purpose, an email account must be created, to which the emails can be sent later. We strongly recommend using this account only with mailto.wiki. Since mailto.wiki accesses the email account, unexpected behavior may occur, if you try to use the account for other purposes in parallel. 

After you have created an email account, you need to fill in the server and account information. You can see an example in the picture below.


Shows an example of a filled in server information configuration.

After you have filled in the server information, click on one of the two Save Settings buttons. After a few seconds, a window will pop up in the upper part of the settings, indicating whether mailto.wiki was able to successfully connect to the email account or not. In case of failure, a detailed error message will be displayed here. If this is not enough to solve the problem by yourself, please contact us at support@mailto.wiki. In case of success, you can continue with the settings.


After you registered at least one email address successfully you are able to send emails to Confluence. As already mentioned these get inserted in the default space. As the default space is set automatically during installation make sure to change it to a space of your choice.


Shows how to select a default space.

Finally you need to select a default content type. Confluence knows two types of contents: Pages and blog posts. Atlassian states that pages are great for when you want the information to last and evolve over time. If it's a point-in-time update or one-time communication then a blog post is the way to go.


Shows how to set the default content type.

Step 3 - Send your first email


You are now ready to send your first email to Confluence. Open your email program or log into your web-mail provider. Then write an email to the email account you registered above.


A test email.

After sending your email wait 5 minutes to give the system time to process your message and go to the default space you configured above. If you configured everything correctly the message will appear in the default space as page or blog post depending on your settings for the default content type.


Shows the email in Confluence.

Conclusion


You are now ready to send emails to Confluence. Try it out and if errors occur or something does not work as expected, don't hesitate to contact us at our Help Desk or via email at support@mailto.wiki. If you want more control over where your emails get posted, you can use Space Rules.