Connecting your Microsoft 365 (Outlook) Emails and Calendars

In this guide we show you how to connect your emails and calendars. For both there are two options:

  • Connecting a central email and calendar for the account
  • Connecting emails and calendars for individual users

To get started navigate to Settings > Integrations > Office 365

Connecting Emails

There are two ways you can connect a Microsoft 365 email depending on what you are trying to connect.

  1. Central email for the whole company
  2. Individual user emails

Please note: if you have set that users can’t connect their own email in the email settings, users will not be able to send emails from their own email address on job records. You can check the email settings guide for more information or visit Settings > Survey settings > Email and SMS settings.

 

Connecting a central email for the whole company

Under Settings > Survey settings > Email templates > Connect email tab, you can click the Office 365 option to connect via OAuth2.0 or use the Other option to connect using SMTP/IMAP.

If connecting via the SMTP route please visit our other connecting emails guide for further details.

Using the 0Auth2.0 route you’ll be taken to the the Office 365 integrations page. Using the “Account settings” tab you’ll be able to connect a central email address. The email connected here is used to send your automated emails. Press the connect button and follow the on screen prompts.

 

Connecting a central email for the whole company

Following the same process above, you can then navigate to the “Your settings” tab. On this tab a user connects their own email address. The email connected here can be used to send emails from the ‘Email’ tab on the quote/job timeline.

Troubleshooting

The wrong email is automatically connecting when I press “Connect email” 

If Microsoft picks up that your browser is logged into one account already, they will automatically connect your logged in account to Survey Booker. To prevent this and choose which email you want to connect you can:

  1. Open a browser in “Incognito mode” on Google Chrome or “Private mode” on Edge. This won’t be logged into any systems.
    1. To do this, click the 3 vertical dots in the top right of your browser.
    2. Around the 3rd option down is “New Incognito window” or “New Private Window”.
  2. In this new browser window, log in to Survey Booker and connect your email.
  3. Microsoft will ask you which account you want to connect to as you will not be logged into Office 365 in this private/incognito browser.

 

I need admin authorisation when connecting for the first time:

Connecting for the first time

Connecting Calendars

There are two ways you can connect a Microsoft 365 calendar depending on what you are trying to connect.

  1. Central email for the whole company
  2. Individual user emails

 

Connecting a central calendar for the whole company

Navigate to Settings > Integrations > Office 365

Under the “Account settings” tab you can connect a central company calendar for posting calendar events to. For example, jobs that aren’t assigned to any one.

 

Connecting individual user calendars

Following the same process above, you can then navigate to the “Your settings” tab. On this tab a user connects their own calendar. When settings appointment dates, report due dates and tasks, these events can be posted through to individual user calendars if connected.

Connecting for the first time

Calendar settings

There are three tabs:

  • Inspection due
  • Report due
  • Tasks

Under each tab you have a separate activation slider to set if that event type should be sent to your calendar or not. Turn it on to allow that event type to add to your calendar.

You can also set a different event title, description, location and attendees using the shortcodes listed. How you set up your template here will set how your calendar event is created.


Frequently asked questions

Which calendar will events be added to?

Individual user calendar: When setting an inspection date, report due date or task, the event will be added to the assigned users calendar provided:

  • The user has connected their calendar in the settings
  • The event type is set as active in your O365 settings

Central calendar: If no user is assigned or the assigned user hasn’t connected a calendar, the event will add to your central calendar connected under the Account settings tab.

 

What happens if I make changes to an appointment date:

  • Rescheduled appointments: the event will be rescheduled in the user’s calendar.
  • Reassigned appointments: the event will be removed from the original user’s calendar and added to the new user’s calendar.
  • Cancelled appointments: when a job is cancelled, the event will be automatically removed from the user’s calendar.
  • Manually moving the job status back: if you move the job back from inspected to booked, we’ll remove the report due event. Likewise, if you move the status back from booked to accepted, we’ll remove the appointment from the calendar.

 

What happens if my calendar disconnects?

We’ll send the user an email to let them know their calendar has disconnected advising that they need to login and reconnect it. If you’ve booked an appointments and it’s defaulted to the central calendar due to the calendar disconnection, you can move the job back to accepted and rebook it to send it to their calendar once rebooked.

Click on the image to enlarge

Example description

OVERVIEW
Job type: [Survey Type]

CUSTOMER
Customer name: [Customer Name] – main customer name, not the report name. 
Customer email: [Customer Email]
Customer phone: [Customer Phone]
Correspondence Line 1: [Correspondence Address Line One]
Correspondence Line 2: [Correspondence Address Line Two]
Correspondence City: [Correspondence City]
Correspondence county: [Correspondence Country Code]
Correspondence postcode: [Correspondence Postal Code]

JOB DETAILS
Survey quote: £[Survey Quote]
SB ID: [Survey ID] 
Internal ID: [Internal ID] 
Internal ref: [Internal Reference]
Additional info: [Additional Info]
Assigned user: [Assigned User]
Extras: [Optional Services]
Payment date: [Payment Date]
Total paid: £[Total Paid]

TERMS
Signed term logs: [Signed Term Logs]
Signed terms: [Signed Term Link]
Signed terms date: [Signed Terms Date]

PROPERTY
Address: [Address]
Postcode: [Postcode]
Property value: £[Property Value]
Tenure: [Tenure]
Bedrooms: [Bedrooms]
Property link: [Property Link]
Property type: [Property Type]

ACCESS
Property access through: [Property Access Through]
Access company: [Access Company Name]
Access name: [Access Name]
Access email: [Access Email]
Access number: [Access Number]
Access address: [Access Address]
Access notes: [Access Notes]

Connecting Microsoft 365 the first time

The first time you connect Microsoft 365, the user signing in must use an administrator level account on your Microsoft 365 account. This is required to approve the connection with the Survey Booker app.

If your email is not administrator level you will see this error:

Click on the image to enlarge

To resolve this, an Administrator needs to configure user consent settings in Outlook.


 Configure User Consent Settings

1. Sign into your Microsoft 365 administrator account.

2. Click Settings > Org Settings.

3. In User consent to apps, ensure checkbox is ticked.

Click on the image to enlarge

4. Click Save Changes. 

 

An alternative to the above configuration is to consider enabling the admin consent workflow to allow users to request an administrator’s review and approval of an application that the user is not allowed to consent to:

Further information about the admin consent workflow can be found on Microsoft’s website here: https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/configure-admin-consent-workflow

Alternatively you can grant tenant-wide admin consent to an application: https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/grant-admin-consent

 


Admin user

Once you sign in with an administrator level Microsoft 365 email, you’ll be asked to grant permission to Survey Booker to access your account to write emails and log replies.

Once you approve access, you’ll be redirected to Survey Booker.

Click on the image to enlarge

Composing an email and setting a signature

Click on ‘Compose email’.

The pop up will then appear allowing you to write an email. You can write in the message you want to send to your customer.

 

Setting a signature

Press the pencil icon at the bottom of the page. Press the ‘add new sign’ button. If you want a signature to appear by default when writing an email, please select the ‘Set this signature as a primary signature’ tick box.

Enter your signature – currently we cannot autoformat multiline signatures. To set up a multiline signature please add:

  • <strong> Text here </strong> for bold
  • <br> To move onto a new line
  • <small> Text here </small> to make any text smaller font (e.g. disclaimers)

 

E.g. Survey Booker <br> 01234567890 <br><br><strong>www.surveyooker.co.uk </strong>

Will display as:

 

Survey Booker
01234567890

www.surveybooker.co.uk

 

 

Adding attachments

Click on the paper click icon.

Select the attachment(s) you’d like to add.

You will then see them on the message ready to send.

 

 

Custom templates and standard attachments

To create pre-set templates that can be selected for use on the timeline page please see this guide: Personalising your email templates and standard attachments

The technical bits

We connect to Azure using OAuth2.0. The graph here shows the authorisation flows used with Azure.

Click on the image to enlarge