How it works
Keeping the Boréalis application in the loop for emails/meetings with your stakeholders is the quickest way to keep track of your engagement with minimum effort. The Mail Handler feature helps users automatically generate a full communication record in Boréalis, including title, description, date, time, participants, type of communication, and more, directly from their email service.
Here are basics rules every Boréalis users should know about the feature:
1. Emails sent to the mail handler are processed instantly.
2. Only Boréalis users with 'writing' access rights can send emails to the Mail Handler. If emails are sent by employees that are not users, they won't be processed.
3. Copying the system's BCC email address in an email will create an "Email" communication. The current level of the email will be analyzed by the system.
4. Forwarding an email to the system's BCC email address will create an "Email" communication. The second level of the email will be analyzed. Only email that are forwarded only to the system will be considered as a 'forward' and analyzed as such. If users add other recipients when fowarding an email to the system, then only the first level will be analyzed.
5. Replying to a meeting and sending it to our system's email address will create a "Meeting" communication. The information of the meeting invite will be added in Boréalis.
Once the Mail Handler validates that the email sender is a Boréalis user, here are the steps the system will follow to process the email:
All attached documents will be linked to the new communication. If images are embedded in the body of the email, these images will be linked as documents in the communication. If vCards (electronic business cards) are attached to an email transferred to the system, the application will create an individual's record (and its organisation) instead of a communication.
The application will recognize if the email sent to the system is part of a thread from previously recorded communications. The conditions below must be met for an email to be linked to a thread:
- The email must be a transfer (FW:) or a reply (RE:) to an email that already exists in the system
- The email must not be a transfer or reply to a meeting invite. In this case, the communication of this meeting invite will be updated instead of creating new communications.
Participants/staff members linked or automatically created
Main rules for staff members:
- If the email is linked to one or more employees, all staff members with the email address will be linked.
- If the email recipients are employees that are not already in the staff members register AND their email addresses contains the configured domain, a staff member will be created automatically.
Main rules for participants:
- If the email is linked to one or more positions, all the positions will be linked. When the communications are linked to positions, then they are also linked to the individuals and the positions' related organizations. If the email is not linked to a position in the individual profile but the 'Always link communications to main position' check box is ticked, the communication will be linked to its main position.
- If the email address is linked to multiple individuals and organizations in the system, all of them will be linked to the communication.
- If there is no email address but only a name, then the system will proceed to analysis based on names instead of email addresses:
- If only an organization is found, then the organization with that email address will be linked to the communication.
- If an individual and an organization are found and that individual has a position in that oganization in the system, then the position will be linked. In the case no position exists, then the individual and the organization will be linked.
- If the individual found is not in the system, it will be created automatically.
- The email address will be added as the main email.
- The name of the stakeholder will be either the name found or the first part of the email address (if only the email address).
- If recognized by the Mail Handler, an organization may be linked or created (if not already in the system). A position may also be created if an organization is found.
When forwarding an email to the system, the Mail Handler analyse the signature of the second level of the email. If the individual has no phone number, email or postal address, the Mail Handler will create the contact information.
If one ore more BBC aliases are recognized by the Mail Handler, the communications will be linked to the corresponding element. BCC aliases exists for projects, subject categories, general atmosphere and engagement plans. Please refer to this article for more details.
Once an email is sent to the system, user will receive a confirmation email with the following information:
- Details regarding the newly created communication
- A list of individuals and staff members that were created (if applicable - green dot in front of the stakeholder/staff member name when created and purple dot when profile updated)
- Warnings if the information was not processed by the system with an explanation
We strongly recommend users to always read confirmation emails to make sure that the communication was properly created. It is thus the best time to update data in the system if needed.