Email integration within Alto, sometimes referred to as CAMS (CA Messaging Service), allows emails sent through Alto (along with their replies) to be seen and actioned directly within Alto.
This allows you to follow a complete history of email contact with clients straight from the Contacts and Properties timelines. It also negates the need to manually add file notes when email replies are received in Outlook, saving valuable time and the possibility of replies being missed.
Setting up email integration (CAMS) for the first time
Preparing for email integration
There are a few points to note prior to CAMS being enabled:
- CAMS will add a Reference Code to every single email Subject line sent from Alto going forward. This cannot be changed
- CAMS will pull in ALL emails once you sync your Outlook account. For this reason, you must make sure that no negotiators' work email addresses (the ones accessed through Office 365) are on any contact cards in Alto
Warning
CAMS will automatically assign any emails to contacts with matching email addresses. This means that if members of staff have set up contacts using their work email addresses, emails between them will upload to the contact record, including potentially confidential ones. This is avoided by making sure no negotiators’ email addresses are on contact records
Note
You need to be using Office 365 for your emails in order for the integration to work.
If you need to migrate your agency's email to Office 365, you should discuss this with your email administrator as the migration process needs to be carefully planned and executed in order to retain access to your mailboxes and email.
Microsoft provides comprehensive documentation on the different migration options that are available depending upon your existing email server in use. For more information on this, click here
When you're ready to proceed, please contact our support team by clicking Contact support below and completing the contact form. They will arrange for the email integration service to be enabled for you, prior to you then setting it up.
Setting up email integration
Regardless of whether you’re already using Office 365, or if you’ve just migrated to it, there are a small number of steps that need to be undertaken in Alto so that Alto can import Alto-related message replies.
Note
These steps only need to be completed once by your organisation
To complete this process, you will need Group Administrator permissions within Alto. You'll ALSO need Administrator access for your Office 365 account
You may not have one person with both of these permissions so it's possible that two people will need to work in tandem with each other to complete the setup process. There are initial steps which can be completed independently of each other, however, to complete the process one final step must be done in collaboration with each other. If you are not working in the same physical location, this can be completed by the Office 365 Administrator logging into the Alto Group Administrators computer remotely for a brief time.
Initial actions required by the Office 365 Administrator
Your Office 365 Administrator needs to find and make a note of your Tenant ID:
- Go to https://portal.azure.com/ and log in with your administrator account
- Click View under the Manage Microsoft Entra ID section
- The Overview screen shows the Tenant ID within the Basic information section. Either copy the Tenant ID by selecting Copy next to the ID or manually make a note of it and pass it on to your Alto Group Administrator if necessary, as this will be needed for the next steps
Initial actions required by the Alto Group Administrator
Once your Office 365 Administrator has identified and provided your Tenant ID, your Alto Group Administrator will need to connect Alto to your Office 365 account.
- Click Tools on the main navigation bar
- In the dropdown menu, click Templates and admin
- On the side menu, under System Tools, click System Administration
- Click Group Settings
- Scroll down and click Office365 Settings
- Enter your TenantID that you obtained earlier, in to the field
- Click Save
Final actions requiring both the Office 365 Administrator and Alto Group Administrator
These final steps will need to be completed from within Alto, however they'll require your Office 365 Administrator to enter their username and password for Office 365 in order to authorise the set up.
- Within your Alto Group Settings, click Office365 Settings again to re-open the screen containing the TenantID
- Click Office365 Consent
-
A separate screen opens. Your Office 365 administrator will need to log in with their credentials in order to authorise Alto to connect to your email
- If you attempt to log in with an Office 365 account that does not have Administrator access, you'll get the below message - sign in with an Administrator account instead
- Once logged in under an Administrator account, the following screen will show and indicate that Alto is requiring access to your Office 365 system. Click Accept to allow this
- Once your Office 365 Administrator has logged in and accepted the permission request, a confirmation screen appears
- If it says that that Access consent is granted, the process was successful and you can click Close
- If it was unsuccessful, close this screen and repeat the above process again ensuring the Tenant ID and Office 365 login details are correct
-
Once you've closed the confirmation and you're back within Group Settings, click Office365 Settings again to re-open the screen. There should now be a tick alongside Verified, this means that Alto is correctly linked up to Office 365
Note
If any users email addresses have changed during the migration to Office 365, each user will need to update their email address in Alto. To do this, they should:
- Click on their name on the main navigation bar
- Click Account Settings
- Click Your account
- Alongside Exchange Credentials, click Change
- A Change Exchange Credentials window appears. Enter the new email address in the User Name field
- Click Save
- A confirmation message appears. Click Check Settings
- If successful, the following message should appear after a few moments
Handling email notifications
Once the above steps have been completed and your email integration is set up, any emails sent from within Alto will enter the message syncing process.
When a recipient replies to an email, a notification will appear on your Alto main navigation bar along with a number to indicate how many notifications you currently have. If you're logged in to Alto at the time it arrives, you'll also see a pop up notification.
Note
The notifications will only appear to the user who sent the original email, although everybody will be able to see the emails sent and their replies, on the relevant timelines
If you click the notification, you can view the reply or dismiss the notification to remove it from the list. The reply will still be visible on the relevant timelines once the notification has been dismissed.
Identifying replies in timelines
Emails that have originated from Alto appear as normal in the Contacts and Properties timelines. Replies to these emails, once processed by the system, will appear in the Timeline as an Email Reply.
You can filter the timelines to separate these replies by using the Synced Emails filter option at the top of the Timeline.
Viewing synced emails
Email replies are handled in a similar manner to normal communications that have originated from Alto. If you click on a notification or an Email Reply in the Contacts/Properties Timeline, you'll be able to reply to the email as normal and download any attachments (a paperclip symbol on the Timeline entry indicates if an email contains an attachment).