When Gold-Vision mail tracking is not working as expected, there can be a number of reasons behind the issue. This could range from configuration errors to network-related problems.
Below is a review of the most common cases to explore, along with potential solutions to address them.

Mail Tracking Logs

Global mail tracking logs can be found in the logs area under the settings menu.

1. Open the Settings menu
2. Select Logs 
3. Locate the MailScanner_YYYY-MM-DD log (where YYYY-MM-DD represents the current date)
4. The log will by default contain connection and tracking errors

The log can be enhanced by turning on “Info Logging”.  Please note this will result in a much more verbose log that contains detailed steps from the mail tracker.

1. Open the Settings menu
2. Select Log Settings 
3. Against “Info Logging” and “Warning Logging” select Enabled 
4. Save 

User Level Diagnostics

There are several settings available on a per-user basis that can affect mail tracking.

User Mailbox Connection Test

Whilst the mail tracking diagnostics provides a high level overview, more detailed information can be obtained by running individual tests against each user.

1. Open the Settings menu
2. Under User & Team Administration select Users
3. Click on a user to open the record
4. From the Actions Menu select Mail Tracking Settings
5. Click the Test button
6. A message will appear shortly reporting “Unable to Connect to Mailbox“
7. Take note of  the unique identifier on the red error shown on the message
8. Open Settings and select Logs 
9. Click on the  GoldVision8_YYYY-MM-DD log to download it
10. Review the code by finding the unique identifier within the log

Check Mail Scanning Enabled per User

There are settings that control whether mail tracking is enabled on a per user basis.  There are two flags to be aware of “Disable Mail Scan“, which globally turns off mail tracking for a user and “Scan Emails” that tells the mail sync to track emails.

1. Click Settings
2. Under User & Team Administration select Users
3. Click on a user to open the record
4. Ensure the Disable Mail Scan box is unchecked 
5. Ensure the Scan Emails box is checked 
6. Save 

Check User Scan Folders Setting

Check each user has been correctly configured to scan folders within their mailbox.

1. Click Settings
2. Under User & Team Administration select Users
3. Click on a user to open the record
4. Ensure one of the below is present in the Mail Tracking Folders field
   • An asterisk *  (means scan all folders) – recommended
   • A semi colon separated list of folder name : Inbox; Sent; Another Folder etc
5. Save 

Review User Last Scanned Date

A quick check that can be performed against a user record is to review the user “Last Scanned” date, which is auto-populated when the mail tracker processes it.  If the scanned date is a long time ago it suggests a connection or service issue.  If the scanned date is recent it suggests mail scanning is working but some setting or rule is preventing some or all emails being tracked.

1. Click Settings
2. Under User & Team Administration select Users
3. Click on a user to open the record
4. Read the “Last Scanned Date” field data

Azure Registered Application Client Secret

During the setup of mail tracking on Gold-Vision, it is necessary to configure the Azure Registered Application Client Secret Key on the Microsoft side. One potential reason for mail tracking failures on Gold-Vision is the default expiry of the Client Secret Key after one year. Once expired, a new key must be generated. Please refer to the following link for detailed instructions on how to complete this process: Mail Tracking Setup

Settings Correct but Email Not Tracking

If all settings appear to be correct but some or all email is not being tracked into the system then check the below for common causes.

Why I can’t see emails tracked against an Account / Contact?

Emails will automatically track against an Account or Contact record if:

1. The email domain field against the account has the relevant customer email domain.
   – Go to the specific account and look for Email Domains field, add the domain if this is missing
2. The Contact Email field is filled in.
   – Go to the contact record to ensure the email address of the contact is entered in the Email field

Why can I see an email against the an Account or Contact I was not expecting?

1. Check the email recipient list, especially CC/BCC, for emails addresses or domains that are stored against the account or contact

Emails are not automatically linking to Activities, Opportunities, Quotes or Projects

Emails will automatically track against Gold-Vision items when using reference numbers in the email subject

1.  Check if the email subject has the correct reference that matches exactly
2.  Check if the Reference Number Alert is active