Notifications can be accessed by clicking the 'Notifications' tab on the Settings screen.
Under Notifications, you can access:
- Email Notifications
Under General (Settings), you can access:
- Master Password Configuration
- Storage Settings
Under License, you can access:
Under Troubleshooting, you can access:
Under Extensions, you can access:
- Key-Value Stores
Under Advanced, you can access:
- Move Routes Between Integrations
- Import Artifact Pair Information
- Upgrade Backup Files
To facilitate troubleshooting, you can configure automated email notifications for new errors and issues encountered in Tasktop.
Emails will contain a count of new issues and errors (excluding 'ignored' errors) since the last email notification, and a link to the Activity screen to view the errors/issues. Emails will be sent only if a new error or issue occurs.
To configure email notifications click '+Add Email Server' (or 'Configure Notification Settings' if using Tasktop Cloud).
This will bring you to the Email Notifications screen.
Note: If you are using Tasktop Cloud, you will only see three fields available: To Email Address, Subject Prefix, and Notification Frequency.
The form requires that the following fields be filled out:
- To Email Address: The email address that will receive the notifications. This field is limited to one email address.
- From Email Address: The email address listed in the 'sender address' (or 'from') field of notification emails sent by Tasktop. In many cases, this will match the email whose settings are configured in the 'Email Server Settings' section below, though a different email (such as firstname.lastname@example.org) can be configured here. If a user were to hit 'reply' on an email notification, this is the email the reply would be sent to.
- Subject Prefix (optional): The prefix appended to the subject line of the Error Notification emails. This defaults to [Tasktop] but can be edited if needed. This can help users filter email notifications from Tasktop based on prefix.
- Tasktop Server URL: The URL used to access your instance of Tasktop. This is used to construct links to errors and issues in the notification emails.
- Notification Frequency: The frequency of email notifications. Emails will contain a count of new issues and errors since the last notification and will only send if a new error or issue has occurred since the prior email.
Email Server Settings
These are the email server settings that allow Tasktop to send notifications.
- Username (optional): Username for the authenticated SMTP server.
- Password (optional): Password for the authenticated SMTP server.
- SMTP Server: The SMTP host name of your mail server.
- SMTP Port: The SMTP Port number to use.
- If Protocol = SMTP, the value for this will typically be 25.
- If Protocol = SMTPS, the value for this will typically be 465.
- If Protocol = SMTP_STARTTLS, the value for this will typically be 587, but can also be port 25.
- Connection Timeout: Specifies the maximum period, in seconds, that establishing an email server connection is permitted to take. This defaults to 60 seconds, which should cover most scenarios.
- SMTP: Basic unencrypted SMTP Protocol.
- SMTPS: A more advanced, encrypted SMTP Protocol (SMTP Secure), which will perform server certificate validation.
- SMTP_STARTTLS: A modern protocol that wraps the unencrypted SMTP protocol in TLS (formerly known as SSL encryption), and will perform server certificate validation. This will attempt the STARTTLS wrapper, but if it is not supported by the server, the client will fall back to basic SMTP.
Google email users should select SMTP_STARTTLS.
Here's an example of a filled in form:
You can test your email server settings by clicking the 'Test Connection' button in the upper right corner of the screen, or send a test email by clicking the 'Send Test Email' button.
Once settings are filled in and the connection has been tested, click 'Save' to save your settings, and 'Turn On Notifications' to enable email notifications.
Once saved, you will be able to turn email notifications on or off and to delete the notification settings from the Notifications screen. You can also click 'Configure Notification Settings' to modify your existing settings:
Note: If an email notification fails, an issue will be surfaced on the Activity screen in Tasktop.