Nylas Email/Calendar Integration
The purpose of this document is to clarify how the Naviga system provides an interface for synchronizing email messages and calendar action items of G-Suite, Office 365, or Microsoft Exchange. Note that G-Suite is the business suite including Gmail, Calendar, Photos, Google Docs for businesses. Email data is loaded from the mail app into the Ad system based on the email addresses for "My contacts" in CRM module. Calendar items created in the system are automatically moved into the mail app. Changes to calendar items previously synchronized are automatically copied to CRM or the mail app depending on the most recent change date and time.
Overview – NYLAS Integration
Naviga is using the third-party service Nylas to facilitate the synchronization between your CRM emails and calendars on G-Suite or Microsoft. The Nylas API provides the synchronization service to allow you to create, read, update, delete emails and calendar items.
Currently we support only G-Suite or Office 365
For more details on security and integration, please refer to the Nylas website and documentation at this website: https://www.nylas.com/
IMPORTANT NOTE: The NYLAS software is setup and maintained by NAVIGA, there will be links to NYLAS in this document but only for the sake of creating and configured your G-Suite and Office applications to talk to NYLAS. Again – you will have no direct interaction with the NYLAS software, this falls on the Naviga Team.
Workflow
Here is a run through of process to get your system configured to integration with Naviga Systems
Customer sets up O365/G-Suite using the instructions provided by NYLAS (links provided below in this document)
Send Naviga the Client ID and secret key value from setup
Naviga Keys in those credentials in NYLAS – NYLAS is managed completely by Naviga
Naviga takes the NYLAS application and keys that information into Naviga Application
Customer users goes to User setup in the system and authenticates. This initiates the Sync from your Mail system to Naviga Ad, through Nylas. (details on this are below)
Data flow
User initiates Authentication from Naviga Ad – log in through O365/G-Suite as prompted/normal
This creates a user acct in NYLAS
NYLAS syncs specified folders from the users email – these folders are specified on the CRM – User profile in Naviga Ad. The emails will be sync'd only from the time of authentication onward.
Naviga Ad – Then pulls (syncs) emails from the User's "My Contacts" on the customer accounts
Saves those to Naviga Ad where they are viewable based upon the permissions on the users in the system.
Setting up G-Suite
https://developer.nylas.com/docs/developer-guide/provider-guides/google/create-google-app/
Again, a reminder – you will not log into NYLAS. Follow the link in Google to create your application. The first thing they ask is if you are doing a Hosted or Native Application. We are doing hosted.
The next thing they ask; and it is specific to Google is if you are doing an Internal or External Application. At the part where you need to choose internal or external for the user type, you need to choose internal.
In all cases we need back from your G-Suite Setups
CLIENT ID SECRET KEY
Setting up Office 365/Azure
For Microsoft the setup is a bit different and there are no certification requirements:
Creating an Azure Application
Pay attention to the permissions mentioned – see below for the common settings that you need to configure.
CLIENT ID
Please pay close attention to the documentation in the link above as it has the information you need. Here are some items that usually come up:
This is the Client ID.
SECRET KEY VALUE – you only get one shot to write this down, it is NOT the secret ID
Other important settings Allow Token Exchange
Set to Multitenant.
OAuth – Callback URL:
The Authorized redirect URIs have been updated:
For U.S. Hosted authentication use
https://api.us.nylas.com/v3/connect/callbackFor E.U. Hosted authentication use
https://api.eu.nylas.com/v3/connect/callback
Add the following Permissions:
User Setup–CRM Email Integration
These screens enable you to activate the synchronization feature. First screenshot below can be accessed via Setup -> User Security ->Calendar User Integration for users with permissions to use that screen. Second screenshot below is accessed via "My Profile" which is the small icon 
at the top left of all screens with a menu bar.
User Security Screen:
Enable Email Sync – Set to yes, if email synchronization is desired.
Email Folders(s) – Select the desired folder(s) to sync here. Upon first authorization this email folders dropdown may be blank. Click the refresh icon in the top right corner
to refresh this window and see the folders.User Name / Email Address: This is where the user email address or user name can be entered. It will generally be the same email address as the user’s email in Naviga, but it doesn't have to be; it can be a different email for G-Suite or Microsoft email.
Connection Authorized: Once you click the button to authorize the synchronization, the system initiates the synchronization through NYLAS directly to your Mail system. If you are using G-Suite you should be redirected to Google to log in and authenticate. If you are using Office 365 – it should take you to the Office Login page etc.
This is typically where the setups will fail if everything is not setup properly. This is a one-time step, not to be repeated for synchronization.
Enable Calendar Sync – Set to yes, if calendar/action items synchronization is required.
Whose emails can a user see?
Email Synchronization
The system automatically searches the emails in the folders defined in the user parameters for any email with a To, From or CC email address matching the email addresses of the user’s "My Contacts" in CRM customers. Only emails dated on or after the Users Email Synchronization Initial Authorization date/time which have not yet been loaded into CRM are selected by the system and automatically moved into the system CRM.
Note that the system recognizes if your email account contains emails which are not sent to and from your CRM contact, they won’t be synchronized into Naviga. Only email exchanges and threads of emails between you and your CRM contact will be synchronized between Naviga CRM and your email account. Even if the contact person exists in the system, but is not "my contact", it will not be sync'd, so be sure to appropriately flag contacts which you would like to sync.
Attachments will not be viewable from Naviga Ad.
If user deletes emails from CRM, the emails will not be erased from the email app.
Note that if user generates an email from their email application to a client (email does not originate from the system), it would still sync with the system, so long as the email address of the contact used for the email is linked to that contact in the database and the email is stored in one of the folders specified for the sync. (In prior versions, Inbox and sent mail were the default if nothing is selected. THAT IS NO LONGER TRUE. The user must actually select desired folders for anything to Sync)
If the email is sent from the system, it will appear in the section "System Generated Emails" on the Account record. Emails sent from their email client and sync'd to the system will be found in the "Email Integration" section. Both the system generated and the sync'd emails will be counted in the Manager "Rep Activity" screen in the count of emails
Automatic Synchronization
The G-Suite interface requires that you make a setting change to your google account. If you go to Sign-in & security, you must set it to allow for less secure apps.
View Emails
The emails display in the advertiser’s customer overview screen under the Email Integration shutter.
The emails can be viewed by clicking the View hyperlink button.
As a CRM Manager, navigate in CRM to the menu Rep Activity -> Scroll to the shutter My Reps Activity. Click the hyperlink count under the Email tabs.
This displays the emails synchronized with the external email address.
Calendar Synchronization
New calendar items created in CRM will be synchronized with the Mail App calendar.
On the User Security screen, click the button “Enable Calendar Sync” to “Yes”.
When you open an action item you can see the calendar related to that item. From the Customer Overview screen, scroll to the “New To-Do” button and click it.
Note that you must click the button Sync to set its value to “Yes” for this item to synchronize with your calendar. The Short Description field entry will then appear on your Calendar in your Calendar app. Depending on the Action Type selected, the Sync setting might already be defaulted to Yes or No according to the CRM System Settings.
Any update to either calendar item on Naviga CRM or on your Calendar app is reflected on the other one.
Note that the synchronization on the Calendar app won’t automatically schedule an appointment with your contact or notify this contact of any meeting, but it only serves as a reminder to you of an action item. You must add the contact name and contact information in the Action To-Do item to have this information in the action item.
INTERNAL Components for Naviga Support
Windows Service
For the synchronization to happen, the Windows Service must be running at all time. Naviga IT will set this section to be running in the Admin screen.
Scroll to the Outlook Web Access section.
Enable Outlook Web Access Processing by setting the flag to “Yes”.
Enter the number of minutes after which the synchronization takes place. Recommended to set this at 5 or 10 minutes, if you do 1 minute, it will be syncing everyone’s email every minute and it bogs down the sync process.
Troubleshooting
Google Won’t Sync
It isn’t recommended to perform a manual synchronization in CRM the first time you connect synchronization of email and calendar, because this will take up hours and occupy the user’s machine in synchronizing Naviga with the other systems.
If the CRM Sales rep has been emailing a prospect or client, only after the Sales rep creates this contact in CRM and starts synchronization, the system will display the new emails synchronized with this contact. The system will not retrieve emails older than the synchronization date with the contact in CRM.
The synchronized emails do not include the system generated emails such as AR Statements, and Invoices.
Note that if a Sales rep has been communicating and synchronizing his email with a CRM contact, then this Sales rep leaves the company and his contacts are moved over to another Sales rep, the new Sales rep will not be able to view the older emails between this contact and the previous Sales rep who left the company. Synchronization for the new Sales rep begin only when he starts synchronizing his email with this contact so that only his emails to and from this contact display for him on his email and on CRM.
The system returns error when synched and user receives this message when connecting: “A suspicious app was blocked from accessing your account.”
Naviga Ad does not have control over this; this is due to Google security settings. Click “Yes, it was me” to verify it is you.
G-Suite users
Click the gear icon toward the upper right of the G-Suite window.
Click on the 'Settings' link.
Check 'Mail notifications off' under the Desktop Notifications section.
Click Save.
Click “Allow less secure apps: ON”.
Calendar Won’t Sync
For Microsoft, if multiple calendars are used (iPhone/Mac, etc.) the system will sync the default, and if the default is currently not the outlook calendar, the sync may not work, so you must define the path as follows:
Using a Mac – Set the Default Calendar
Go to ICal / Calendar on the Mac
On the menu bar choose calendar > preferences
On the general tab in there is an option for default calendar
Make sure the default calendar is the Exchange calendar
Using iPhone – Set the Default Calendar
Go to Settings > Calendar
Default Calendar > Place the check box on the default Outlook/Exchange calendar location
Outlook – default Path
File > Account Settings > Account Settings > Data Files tab.
This is the location and then you can list the calendar name.
Notes on User Email usage
The system automatically searches emails in the folders defined in user parameters for any email with a To, From or CC email address matching the email addresses of the user’s "My Contacts" in CRM customers.
Only emails dated on or after the Email Synchronization From date/time which have not yet been loaded into CRM are selected by the system and automatically moved’.
User can then click on the hyperlinks of emails in CRM to delete or view.
If user clicks the view hyperlink, a popup screen will display with the email.
Click the “to” hyperlink and contact person details will open.
If user deletes emails from CRM, the emails won’t be erased from the email app.
Note that if user generates an email from their email application to a client (email does not originate from the system), it would still sync with the system, so long as the email address of the contact used for the email is linked to that contact in the database and the email is stored in one of the folders specified for the sync. On the other hand, if the email is sent from the system, it will not populate the Salesrep Sent folder.
Naviga Ad System generated emails (things we send out that show as history on the account) that are sent through our software that do not have a trail to your email application.
Here are some screenshots showing this:
Notes on Calendar usage
New calendar items must be created in CRM to be synchronized to the Mail App calendar provided the following conditions all present:
The action item was flagged for synchronization at entry time.
The action date/time is on or after the Calendar Synchronization From date/time.
Calendar items changed in CRM are updated in the Mail App calendar provided the following conditions are all present:
The action item was flagged for synchronization at entry time.
The action date/time is on or after the Calendar Synchronization From date/time.
The system items change date/time is more recent than the Mail App items change date/time.
Calendar items changed in the Mail App calendar which originated from CRM are updated in CRM provided the following are all true:
The action date/time is on or after the Calendar Synchronization From date/time.
The Mail App item change date/time is more recent than the system action item change date/time.
When user completes a calendar item and deletes it in the system, it will be removed from the mail app calendar.
Meanings of Nylas' Statuses
valid
All emails for folders, contacts, and calendars are syncing reliably.
invalid
The account has an authorization issue and needs to be re-authenticated.
Last updated
Was this helpful?