Connectid Mail - Trouble Shooting guide
Download our trouble shooting guide in PDF
This document discussed the findings and resolution for different issues that customers faced during using or installing Connectid Mail Outlook Add-in.
1.1. Intended Audience
The intended audience of the documents is Product Owner, Project Managers, Developers, Sales Rep and Support Engineers from both Safe Online Aps, Denmark, and iXora Solution Ltd, Bangladesh.
1.2. Definitions, Acronyms, and Terminology
|1||API|| Application Programming Interface
|3||ADFS|| Active Directory Federation Service
|4||OWA|| Outlook Web App
Table 1: Definition, Acronyms, and Terminology
2. General Issues and Resolution or Workaround
2.1. Connectid Mail is grayed out on Desktop Client for another Plugin
In Desktop Client of outlook Connectid Mail is shown as grayed out if the client has another plugins / COM Add-In installed in outlook. Not all plugins are doing the same, however, there are few plugins that are disabling the web add-in. Disabling those COM add-ins enables Connectid Mail and works okay. Here are the examples of a few Plug-in/COM Add-In
- Swyx Plugin
- Avast antivirus
It is not always for all outlook clients.
Figure 1: Showing Connectid Mail is disabled in outlook Add-in for Avast COM Add-In.
There is no straight forward solution for that. It is not an issue for Connectid Mail itself rather an issue for the outlook client, operating system, and particularly the COM-Addin. It is an open issue for Microsoft and lots of other companies are also facing similar problems. By trial and error method few steps are given below to resolve the issue. However, it is not guaranteed that can solve the problem.
- Update the outlook to the latest version – In most cases, it may solve the problem.
- Sequence of install- Uninstall the COM Add-In and then install Connectid Mail after that, install the COM add-In.
- Windows update may help to solve the issue.
However, it is still an open issue and different community is presenting that to Microsoft to come up with a resolution.
Some references are given below:
There are some workarounds for this issue that may apply:
- Disable the COM Add-in which is creating problem unless it is extremely important
- Use the Web version of outlook to use Connectid Mail
2.2. Unable to sign-in to Connectid Mail from on-prem exchange
There is a lot of companies that haven't moved to the new model of Office 365. There is an exchange on-prem service that is being used for email correspondence together with ADFS. There are a couple of issues to install Connectid Mail on an on-Prem exchange environment.
2.2.1. Connectid Mail is installed but cannot login
The user can install Connectid Mail but cannot log in to the application from their desktop client. The user is getting the following error message:
Figure 2: Error message showing onPrem exchange after login from SSO
To solve the issue, you can check the following link to see if it is configured according to the link below:
Users are getting different error messages from the application related to sign-in.
- If the user gets a different error related to the sign-in process then please check if their active directory is sync with Azure Active Directory or not. You can get the detail for hybrid identity in the link below how-to setup: https://docs.microsoft.com/en-us/azure/active-directory/hybrid/whatis-hybrid-identity
- Check if user can login to Outlook Web version (owa) like https://outlook.office365.com
2.3. Microsoft Store Icon is not available for User’s Outlook to install Connectid Mail
Users are not getting the Microsoft Office Icon to install Connectid Mail or any other outlook add-In.
- The email account that the user is using is not an Office 365 account or any Exchange Account
- Outlook is not licensed with a proper email licensed
- Outlook is older than Office 2013
- For on-prem exchange from the admin center, the option is not allowed to install any marketplace add-in
- If the user does not have any office 365 or Exchange account, then ask them to purchase one
- Update the Outlook client to the latest version of outlook
- Verify if the user can access the store icon from the web version of outlook (owa)
If it is an on-prem exchange, then check the permission from the Admin center. Follow the steps given below:
- Step 1: Go to the permission section in Exchange Admin center and select the Organization Management. Edit the permission.
Figure 3: Exchange Admin Center Permission management
- Step 2: Press the “+” button in the Organization Management permission
Figure 4: Adding permission
- Step 3: Select the “Org Marketplace Apps” for the list of permission and press “OK”
2.4. Connectid Mail installing from an admin center is not possible – on Prem Exchange
The admin user is trying to install the add-in for the total organization from the admin center as a tenant admin. The installation was successful. However, the end-user cannot see the Connectid Mail icon in their outlook as well as owa version.
Before investigating further please make sure the tenant is ready for centralized deployment or not- Please follow the step described in the document to check if the tenant is ready for centralized deployment It needs an admin user to check the tenant is ready or not.
2.5. How to install an Add-In from Admin Center
From Admin Center you can go to settings and then go to “Apps”. From there select the option “Deploy Add-In”.
You can then use the “Next” option from there to install an add-In like Connectid Mail from Office Store or from the Manifest file.
2.6. How to delete an Add-In from admin center as Tenant Admin
To delete an Add-in centrally as Tenant Admin you can log in to the admin center and go to the app settings page Please see the image attached image to see where the “Delete” add-in option is available (full view). Please note that deleting an add-in required “Global Admin” permission, In some version, it is above the description of the add-in.
For a new view, it is below the add-in when you open it showing the picture below.
3. I am using a package of office 365. However, I am not able to install the Connectid Mail
To install Connectid mail requires a valid license for running. For a customer, it can be for different reasons and the Microsoft Product Package has so many variations it is difficult to say which license is valid for running an Outlook Add-In. To identify if an email can install the Connectid mail or not you can ask the following questions to your client:
- What Office 365 license the client is using.
- What is the version of Outlook? (A lower version of Outlook 2013 with updates does not support Add-in and for Mac minimum Outlook 2016)
- One.com is providing Office 365 Plus which is comparable to Office 365 Business. I think the license does not include installing Add-in. Please make sure if your client has a proper license by asking support of One.com.
- Check with the Client if they get the Store Icon on their toolbar.
- If the store icon is present, then if it is possible to install any other Add-in.
- If they can log in using https://outlook.office365.com, they can try to install the add-in there.
Supported Licenses for outlook add-in:
- Office 365 ProPlus
- Office 365 E1 License
- Office 365 E3 License
- Office 365 E5 License
- Exchange Online
Check the Graph API explorer to make sure the email is applicable to use the Connectid Mail app or not: https://developer.microsoft.com/en-us/graph/graph-explorer.
4. As a user I am unable to use the service, though the login is successful – I have Unilogin or SSO with my organizational id and office 365
If any customer has a “Unilogin” setup for their office365 tenant, then it is required to identify which is the actual “mailbox” address of the user-defined for the tenant. We can use the link below to identify the information that is provided by Microsoft Graph API: https://developer.microsoft.com/en-us/graph/graph-explorer.
The user needs to sign it with his/her user credential and get the response back from the API. By looking at that we can determine which is the mailbox address for that particular user.
5. If the user has two emails together and associated which email to use in the Connectid Mail from Admin
For Unilogin or similar setup, users may have two emails – one is for their organization email which is used for sending and receiving mails and the other one is the actual Office 365 email which is used internally to authenticate with Office365.
In this scenario if you want to add any user from the admin site then use the email which is used in his outlook – you can see that left side of the outlook desktop or outlook on the web.
6. How to add a domain/email in safe sender list in outlook
6.1. From an incoming email
Select the email and right-click to get the options “Junks” and then select “Never Block Sender’s Domain”. See the image below:
6.2. From the global section in Tab
From the “Home” tab go to the junk email option, as shown in the image below:
Step 2: Select the “Junk E-mail Options…” and a new window will pop up. Select the “Safe Senders” tab, as shown below:
Step 3: Add the domain and/or email addresses to the safe sender list.