Differences

This shows you the differences between two versions of the page.

--- system_objs [2019/04/03 19:06] – [HVAC Controller] ingrid
+++ system_objs [2019/06/19 18:26] – [Report] ingrid
@@ Line 366: / Line 366: @@
 This object is needed to configure SMTP server parameters to send email messages from the server (used to send alerts, reports etc.).
-  * **SMTP server** Default server hostname of the desired e-mail service, for example "smtp.google.com".
+  * **SMTP server** Default server hostname of the desired e-mail service. For Gmail the server is "smtp.gmail.com".
-  * **Server port** Default server listening port, for example, for Gmail accounts "587".
+  * **Server port** Default server listening port. This port is usually 25 for not encrypted connection. For Gmail, use port 465 for SSL and 587 for TLS.
-  * **From** E-mail address specified in the sender field; if this property is empty in the e-mail will appear noreply@thinknx.com in the from field.
+  * **From** E-mail address specified in the sender field; if this property is empty in the e-mail will appear noreply@thinknx.com in the from field. For Gmail account and for many other this field must be filled with the proper sender email address ("my_email@gmail.com")
-  * **Authentication** Enable or disable SMTP user authentication by means of username and password.\\ If the property ”Authentication” is set to ”Enable”, the following properties will appear:
+  * **Authentication** Enable or disable SMTP user authentication by means of username and password. It is necessary to enable it when using Gmail server. \\ If the property ”Authentication” is set to ”Enable”, the following properties will appear:
-    * Username: E-mail address used as username of the e-mail account.
+    * Username: E-mail address used as username of the e-mail account or any other authentication string. For Gmail it must be the email address ("my_email@gmail.com")
     * Password: Password of the e-mail account.
-  * **Use SSL** If enabled, use SSL encription to connect with the server.
+  * **Use SSL** If enabled, use SSL encription to connect with the server. Must be enabled with Gmail.
+Please note that when Gmail is used with Pop3 apps like Thinknx Server, it is required to enable "Allow less secure apps" from within your Gmail account.
+Here's how to find this Gmail security option:
+  * Open your web browser, e.g., Internet Explorer, Safari, Mozilla Firefox, Google Chrome, Opera, etc.
+  * Go to https://myaccount.google.com/security.
+  * Sign into your account.
+  * Scroll down to the "Less secure app access" section. If you are using the 2-step verification when signing in, you will not be able to see this section. Disable the 2-step verification option in order to enable the "Less secure app access".
+  * Turn this option "ON".
+After configuring the Email Account in System, you can now send emails through a generic button or using the Report object as well.
+  * When using the Generic Command button, select Internal Services --> Email Account --> Your Email Account object --> Send email to recipients and fill the parameters as desired.
+  * When using the Report object, select Report from System tab, and disable the Default SMTP in the parameters. Then select your Email Account from the dropdown list instead.
 ==== Object commands ====
@@ Line 815: / Line 827: @@
   * **Use default SMTP** SMTP server determines the email sender address; if enabled, email messages are sent from the default SMTP; if not, the following property is displayed:
   * **Email Account** Select the ”Email account” item from the list. Please refer to the dedicated section above.
+<wrap important> it is always advised to disable the Default SMTP and create an Email Account object in System to be used here. See section [[system_objs#email_account| Email Account]] for more information.
 ==== Adding recipients ====