We'll connect Office 365 and set SigParser to automatically create and update contacts every day for you.
Go to Settings -> Data Sources and click "Add" on the Office 365 connector.
Authenticate and accept the permissions.
You should see a screen to configure your mailbox settings. Click the checkboxes for "Create contacts" and "Update contacts".
Click "Save"
Go to the Dashboard to see the email processing progress. You will get an email when processing completes.
Need to monitor multiple mailboxes? See the Mailboxes section below.
If no contacts were created in Office 365, follow these troubleshooting steps.
Automatic Contact Creation/Updating from SigParser
SigParser can automatically push new contact records and update existing contact records in your Outlook Contacts. We don't suggest using this feature. Instead we suggest just exporting a CSV file and importing that. If you want more information contact our sales team.
Office 365 Security Permission Details
When you connect Office 365 we ask for the following permissions and for these reasons.
Mail.Read.Shared - Grants SigParser read only access to your email. This doesn't give SigParser any rights to modify or delete your email.
Calendars.Read.Shared - Allows SigParser to read the events on your calendar to display analytics in the user interface and discover more contact details.
Contacts.ReadWrite.Shared - Allows SigParser to create and update contacts automatically for you. By default SigParser doesn't but as soon as you're done connecting, you can enable this feature.
User.ReadBasic.All - Allows SigParser to discover your email address and also display suggestions when you're adding more mailboxes if you need to.
offline_access - Needed for SigParser to check your email and calendar every day without your intervention.
If your company doesn't allow accessing these permissions by SigParser, see the steps they can follow to enable access.
You will have to reconnect your Office 365 email accounts every 90 days to SigParser. It's a limitation of the Office 365 API.
Managing Settings
Each mailbox has it's own set of settings to control things like updating and creating contacts and permissions. You can also buy additional email history at a per mailbox level.
Disable Checking Mailboxes
You can disable checking a specific mailbox by clicking the "Disable Mailbox" button. This will not disable the entire connection of mailboxes.
Updating Contacts
Contacts are updated based on their email address.
Title
Only filled in if it is empty or previously set by SigParser.
Mobile Phone
Only filled in if it is empty or previously set by SigParser.
Other phone numbers
Only filled in if blank.
Address
Only filled in if blank.
Creating Contacts
Contacts are created if no contact already exists in Office 365 Contacts with the same email address. Contacts are always created per connected mailbox.
Caution!!! We suggest only enabling this feature if SigParser is only connected to your own personal email accounts. If your entire company's email accounts are connected to SigParser you could end up with tens of thousands of contacts being pushed to your Office 365 contacts.
SigParser will set the following fields on any contacts:
Title
Mobile Phone
Business Phones
Home Phones
Address
Company Name
File As - Set to the first and last name
Missing contacts
If SigParser didn't create contacts in Office 365 that you expected it to, you can do the following to force it to resync the contacts. This can happen if the pervious processing job completed before you set the "Create contacts" checkbox to checked.
Go to the Settings -> Data Sources
Click "Edit" on email account
Verify the "Create contacts" checkbox is checked on the mailbox you expect. This is at the bottom of the page.
Go to the top of the page and click "Push Contacts".
In the modal window, select a date in the past (format 1/1/2018) and you'll see an estimate of the number of contacts SigParser will attempt to resync.
Click "Submit". It will then run a job to try and push any contacts it can.
Grant OAuth Access
One common issue is for employees of organizations, especially large ones, is that the IT teams disallow mail access via OAuth. This makes it impossible for SigParser to access the email. But you can follow these steps to resolve the issue.
The generic documentation from Microsoft on how to grant/revoke OAuth app permissions is here if you want to read it.
OAuth apps are managed in the Office 365 Cloud App Security portal. You must be a global administrator or security administrator to perform the following task.
Go to the Cloud App Security portal https://portal.cloudappsecurity.comand sign in.
If you are told you need purchase the "Cloud App Security" portal then this likely isn't the issue.
From the left menu choose Investigate > OAuth apps.
You should see "SigParser" listed in the apps list.
Click the "Checkmark" to grant SigParser access.
You can view the permissions SigParser requests by clicking on the row.