ExecEmail

The new ExecEmail is a self-contained email editor and sender. It replaces the older Outlook interface and removes the need for customers to install Microsoft Outlook.

These are the files that are needed for it to function properly:

​

	ExecEmail.exe	This is the email application that uses the customer"s SMTP Server.
	ExecEmail-Outlook.exe	This is the email application that uses MS Outlook.
	ETHtmleditor.htm	This is the template that displays the HTML editor, which allows you to see and modify the email before sending.
	HTMLEditor	This folder contains the HTML editor code, images, etc. If this folder is missing, ExecEmail may not work. Please follow the instructions below, and install it.

Download

• You can download v. 2023.4.20.1 of ExecEmail.exe HERE. Extract this file into the PMS software folder. *DO NOT replace a newer version with this one.

• If you're missing the template (ETHtmleditor.htm) and the HTMLEditor folder, you can download them HERE. Extract the contents of this file into the PMS software folder. This also contains a free HTML editor, ETHTMLEditor.exe, that you can use to edit templates. Editing HTML Letters, Documents and Forms
  
  
• This application requires the Microsoft .Net Framework 4.5. See Microsoft .NET Framework.

You MUST contact your email provider to obtain many of the settings described below.  Execu/Tech Systems is not your email provider and can't obtain your email settings for you.

You MUST verify that your email provider will allow SMTP Relay. If they don't allow SMTP Relay, emails will NOT send.

If you are using a Gmail account, read this first: Gmail Issues

Run ExecEmail.exe

• Open the Execu/Suite folder. Find Software Application Folder

• Find the program ExecEmail.exe and run it (double-click on it.)
  
  

The ExecEmail application will open. This is the settings window: (If you don't see the following window, you're running the older version.)

SMTP Server Settings: 

• You MUST obtain these settings from your email provider.

• You MUST verify that your email provider will allow SMTP Relay. If they don't allow SMTP Relay, emails will NOT send.

• If you are sending from a Gmail account, read this first: Gmail Issues​

Property Email Options:

​

After entering or editing the information, click Save.

Click Test to send a test email. You can change the To Address or add a CC for testing, but you cannot change the From Address.

If the test is successful, you will see an Email Sent popup message. 

If it is not successful, it will return an error message. Errors / Troubleshooting

Gmail Issues

If you use a Gmail account, you might get an error like this:

​

Email Not Sent

Contact your email provider to verify the email settings. This is an error returned by them and they will need to tell you why.
The following error was returned by your email provider:
────────────────────────────────────────
The SMTP server requires a secure connection or the client was not authenticated. The server response was: 5.7.0 Authentication Required. 

As of May 30, 2022, Google no longer supports signing in to third-party apps with your Google Account, using only your username and password.  Less secure apps & your Google Account - Google Account Help

Because of this, Gmail users will now need to create an App Password to be able to send emails with ExecEmail. Sign in with App Passwords - Google Account Help

Creating an App Password for ExecEmail

1. You must FIRST turn on 2-step verification for your Gmail (Google) account: Turn on 2-Step Verification - Google Account Help


2. While signed in, go to your Google account Security settings and scroll down to Signing in to Google.
   
   
   
   Or you can use the Google Account search bar and type in "app password"
   
   



3. Click on App Passwords. If you don’t have this option, it might be because:
• 2-Step Verification is not set up for your account.
• 2-Step Verification is only set up for security keys.
• Your account is through work, school, or other organization.
• You turned on Advanced Protection.


4. Click on Select app, and select Other (custom name)
   
   



5. Type in a custom name for the password (example: ExecEmail) and click Generate.
   
   


6. A 16-digit password will be generated. Write it down or copy it, as this is what you will enter into the Password field in ExecEmail settings in place of your actual account password. The 16-character app password is displayed with spaces so it is easier to read. When you enter it into ExecEmail, ignore the spaces and enter it as an unbroken string of 16 characters.
   
   
   
   Please note: You will need to create a new App Password anytime that your Google password is changed, and then update it in your ExecEmail settings.

ExecEmail Settings for Gmail:

SMTP Server: smtp.gmail.com

Username: Your Gmail account name (example@gmail.com)

Password: The 16-digit App Password you created

Port: 587

Both boxes should be checked.

ExecEmail Unique 'From Address'

You can specify a unique From Address by Terminal Number. This allows you to send emails from "reservations@" or "activities@", etc. based on the Terminal Number.

​

This only works with the newer, non-Outlook emailer. The Outlook emailer uses the user's From Address. Your SMTP server must allow the From Address to differ from the username and password. For security reasons, many SMTP servers don't allow this by default.

To set the terminal record's email address, go to System Maintenance > User I.D Setup > Terminal Record > 'From' Email Address:

All email documents sent from this terminal will contain this From Address.

Errors / Troubleshooting

There are 3 reasons why ExecEmail is not working:

1. Network or Internet problems are preventing ExecEmail from communicating with your email provider.
   Your IT professional can verify this. 
   
   
2. The email settings are wrong or entered incorrectly.
   Your email provider can verify the settings.
   
   
3. Your email provider doesn't allow relay either because your IP, user or sender isn't allowed.
   Your email provider can verify this and, if possible, enable it. 

The following aren't all of the errors you may see, but they are the most common:

The SMTP server requires a secure connection or the client was not authenticated. The server response was: 5.7.0 Authentication Required.

Possible causes:

• Username and/or password are incorrect.
• Require Authentication checkbox is not checked.
• You are using a Gmail account, and you entered your regular Gmail password instead of an App Password. See Gmail Issues.

Mailbox unavailable. The server response was : 5.7.1 Unable to relay for ____. 

​

Possible causes:

• Username and/or password are incorrect.
• Your email server doesn't allow relay.

Transaction failed. The server response was: 5.7.1 

<_________> : Sender address rejected: Access denied

• The mail server is rejecting the sender. This may be because of a relay restriction or a spam filter.

Unable to connect to the remote server

Possible causes:

• Your port number is wrong
• There is no SMTP server listening

The remote name could not be resolved 

Possible causes:

• The SMTP server specified in the settings doesn't exist or can't be reached from your computer.
• Check spelling. In the above example, the first part of the domain is misspelled.

Outlook must be installed at every computer that needs to email. The only exception is using Remote Desktop, where Outlook needs to be installed at the server with enough licenses for each user.  You might also need to install this: Microsoft.Office.Interop

Menuini.fil is a configuration file in the PMS software folder. This file can be opened with Notepad and edited.

Search for the line containing: HOTEL-MAIL-OUTLOOK=YES

It might be commented out with a # in front of the line, or it might have =NO rather than =YES.

• If it is commented out, remove the #.
• If the line has =NO, change it to =YES