KBI 311664 MAPI Email Alerts Stop Working

Version

Argent Advanced Technology – All Versions

Date

Monday, 28 May 2018

Summary

Email Alerts from Argent unexpectedly stop firing

After troubleshooting, you realize it is ONLY the Messaging Application Program Interface (MAPI) email alerts which are no longer working

Further investigation leads to a prompt on the Argent server stating the company’s security certificate was not trusted

Technical Background

Argent gives customer’s three options with sending email alerts

  • MAPI
  • SMTP
  • Lotus Notes

MAPI is a Microsoft Windows program interface that enables you to send e-mail from within an application

Argent takes advantage of MAPI to allow for email alerting within the Argent Console

MAPI has many advantages such as being able to read the GAL (Global Address List) of a user’s Exchange environment

This advantage allows users to create email templates within Argent with only knowing the user’s name and not the full email address

The GAL resolves the rest automatically

This is not without its problems though

MAPI profiles are usually quite stable but do occasionally suffer loss of security certification

This can be due to any number of reasons such as a new security certificate was released, a corrupted MAPI profile, an update to Outlook, or an update to Exchange itself

Resolution

Resolving the issue CAN be as simple as clicking ‘Yes’ on the Security Alert prompt

If there is no Security Alert prompt and MAPI email is still failing, follow the steps below to recreate the MAPI profile on the Argent server

This will force a reissue of security certificate

  1. Log into Argent server as the Argent Service account
  2. Close Outlook on Argent server if it is open
  3. Go to Control Panel
  4. Open MAIL
  5. Choose ‘Show Profiles’

  6. Write down the name of the Argent MAPI Profile (You will need to know it for later steps)
  7. Remove the Argent MAPI Profile
  8. Press the ‘Add’ button
  9. Name the new Mail Profile the same as the old profile name
  10. Press ‘OK’
  11. In Outlook 2007, Outlook 2010, Outlook 2013 and Outlook 2016, you can simply type your desired display name, email address and password and Outlook will try to determine and configure your account automatically

    If this fails you can still choose to configure it manually with the information provided by your Exchange Administrator

  12. Uncheck ‘Use Cached Exchange Mode’
  13. Follow on-screen instructions to (further) configure your account

    Again; ask your Exchange administrator if you do not know these details

  14. Once created, you should receive a prompt to trust the Microsoft Security Certification

    Choose ‘Yes’