Troubleshooting SMTP Issues in Opkey

Let’s walk through some common issues you might encounter while configuring SMTP settings in Opkey and how to resolve them.

1. SMTP Server Connection Issues

Unable to connect to the SMTP server.

Solution: This could be due to Incorrect SMTP Server Name or Port Number. To resolve this,

• Double-check the SMTP Server Name and Port Number with your IT team.

• Recheck port numbers.

• Ensure the SMTP server is reachable from your network (try pinging the server).

2. Authentication Failures

Authentication errors when sending emails.

Solution: This could be due to incorrect Username or Password entered for SMTP server authentication.

• Re-enter the Username and Password provided by your IT team.

• Ensure the "Require Authentication" checkbox is selected if authentication is needed.

• If using the same Email Address as the Username, make sure the checkbox is selected.

3. Emails Not Being Sent

Emails are not being sent after test execution.

Solution: This could be due to incorrect recipient email addresses or network issues. To resolve this issue,

• Verify the email addresses entered in the "Email IDs" field are correct and separated by commas if multiple.

• Check your network connection and SMTP server status.

• Use the "Send Test Mail" option to verify the configuration.

4. SSL/TLS Configuration Errors

Issues with enabling SSL/TLS for secure email transfer.

Solution: This issues could be due to misconfiguration of SSL settings or server not supporting SSL. To resolve this,

• Confirm with your IT team whether SSL/TLS should be enabled.

• If SSL is enabled, ensure the correct port is being used.

• Try disabling SSL/TLS to see if the issue persists.

5. Skipped Over Steps Not Included in Email Reports

Skipped Over steps are not showing up in the email reports.

Solution: The issue could be due to corresponding checkbox not selected during configuration of SMTP in Opkey. You can,

• Check the "Include Skipped Over steps" checkbox when setting up your SMTP configuration if you need these steps included in the reports.

6. SMTP Settings Not Saving

SMTP settings are not saving or being applied.

Solution: This issue maybe caused due to incomplete form submission or an possible UI issue. To resolve this,

• Ensure all mandatory fields (*) are filled out.

• Try refreshing the page or re-entering the details.

• Clear your browser cache and retry the configuration.

7. Issues Sending Test Mail

The "Send Test Mail" feature fails to deliver emails.

Solution: This issues could be caused due to incorrect SMTP configuration or network issues. to resolve this,

• Re-check all SMTP settings, including server name, port, username, and password.

• Ensure that the SMTP server is accessible from your network.

• Consult your IT team to verify server health and availability.

General Troubleshooting Tips

• Always verify your SMTP details with your IT team before configuring.

• Check firewall settings to ensure SMTP traffic is allowed.

• If issues persist, try restarting the Opkey application or clearing your browser cache.

You should now have the tools to troubleshoot any issues you encounter with SMTP settings in Opkey. For more detailed assistance on this issue, reach out to your IT support team or Opkey support.