Linking your mailbox to Tamago-DB will allow Tamago-DB to fetch email communication between the user and the contacts in Tamago-DB. 


Fetching and Caching


Fetching the email will happen when a user visits the contact record. Tamago-DB will retrieve the email message from the mailbox but without retrieving the actual content. It will contain the sender, recipients and other 'header' information.


Caching will be done once the email messages is being opened inside Tamago-DB. This will force the system to retrieve the email message's content, including the attachment file names.


Contact us for enabling the auto-caching feature.


Connecting your mailbox


You can connect your mailbox in "User settings" (top right menu).


Connecting your mailbox can be done by either IMAP or OAuth. Connecting with IMAP will require to enter your username and password. For this reason we recommend using OAuth. Connecting with OAuth is a more secure and reliable to give Tamago-DB the authorization to connect to your mailbox. The browser might still ask for your username and password, but only to log in on your mailbox to be able to give authorization to Tamago-DB. 



Connect with OAuth


Connecting with OAuth will take a few steps to complete. When using Gmail as your email provider, it will look as below :






Connect with IMAP


Connecting with IMAP requires you to enter your username and password from your mail account (not the Tamago-DB password) in the "Email account authentication" popup. 


If you don't know your "IMAP server" and "IMAP port" details, click "Lookup IMAP server details".  Tamago-DB will run a background query in an attempt to guess the most appropriate values. Depending on which provider you have, this might fail. If Tamago-DB can't determine the most appropriate values, contact your email administrator.


Changing the password of your mail account will result in Tamago-DB being unable to fetch new email messages. For this reason, connecting with OAuth is recommended.




Troubleshooting


If you still have trouble connecting and you happen to be using Gmail / Google Apps for business, the problem might be Google's settings.


Is IMAP enabled?


Make sure IMAP is generally enabled for your Gmail account and that "Show in IMAP is on for the "All Mail" label.



Usually IMAP is active for the "All Mail" label, however in some cases it can become disabled.  Ticking the corresponding checkbox will ensure that we can index all emails regardless of whether they have been archived or moved to different folders/labels.



Do you allow access for less secure apps (Google) ?


Double check that access is allowed for "less secure apps".  (This simply means that third-party applications like Tamago-DB are allowed to connect to your account.)

  1. Go to Google Security (Less Secure Apps)
  2. "Turn on" access for less secure apps


Note that you will need to speak to your domain administrator (whoever sat the email address) to turn on the access for less secure apps.



Do you have 2-Step Verification enabled ?


If you are using 2-Step Verification with Gmail or Google Apps, you will have to generate an "app password" and use that to sign-in.

Generating an app password is a simple three step process:


  1. Login to app passwords page to see your list of app passwords
  2. At the bottom of the page selection your application and device.  Click "Generate" to create a random app password.
  3. A new password will appear in a yellow bar.  Follow the instructions to add this password to your the application on your device to login.


If necessary, this password can be revoked from app passwords at any time.