Troubleshoot SMTP Channel
  • 03 Dec 2024
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Troubleshoot SMTP Channel

  • Dark
    Light
  • PDF

Article summary

If a customer is having problems sending email notifications then the 2 most common issues are:

  • The credentials for Turbo360 to talk to the SMTP server are not correct

  • Turbo360 does not have network line of sight to the SMTP server

The credentials for Turbo360 to talk to the SMTP server are not correct


In this case its a good idea to test the SMTP settings outside Turbo360 to validate you can send an email.  Below are some Powershell scripts that can help you try this.

Email without SSL

Remember to update the variables with your credentials and to and from address


# Set variables
$smtpServer = ""  # Replace with your SMTP server
$smtpPort = 25                  # Common ports: 25, 587, or 465
$from = ""        # Sender email address
$to = ""    # Recipient email address
$subject = "Test Email from PowerShell"
$body = "This is a test email sent via PowerShell."
$username = "Add your username here"   # Your SMTP username (if required)
$password = "Add your password here"   # Your SMTP password (if required)

# Create a secure password object
$securePassword = ConvertTo-SecureString $password -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($username, $securePassword)

# Send email
Send-MailMessage -SmtpServer $smtpServer -Port $smtpPort -From $from -To $to -Subject $subject -Body $body -BodyAsHtml -Credential $credential

Email with SSL

Remember to update the variables with your credentials and to and from address

# Set variables
$smtpServer = ""  # Replace with your SMTP server
$smtpPort = 587                  # Common ports: 25, 587, or 465
$from = ""        # Sender email address
$to = ""    # Recipient email address
$subject = "Test Email from PowerShell"
$body = "This is a test email sent via PowerShell."
$username = "Add your username here"   # Your SMTP username (if required)
$password = "Add your password here"   # Your SMTP password (if required)

# Create a secure password object
$securePassword = ConvertTo-SecureString $password -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($username, $securePassword)

# Send email using SSL
Send-MailMessage -SmtpServer $smtpServer -Port $smtpPort -From $from -To $to -Subject $subject -Body $body -BodyAsHtml -Credential $credential -UseSsl

Email with SendGrid via SMTP

If your using sendgrid remember the following:

  • Your API key is the password

  • The value “apikey” is the username

  • Your from address needs to be a validated sender in SendGrid

# Set variables
$smtpServer = "smtp.sendgrid.net"  # Replace with your SMTP server
$smtpPort = 587                  # Common ports: 25, 587, or 465
$from = ""        # Sender email address
$to = ""    # Recipient email address
$subject = "Test Email from PowerShell"
$body = "This is a test email sent via PowerShell."
$username = "apikey"   # Your SMTP username (if required)
$password = "[Your API Key goes here]"   # Your SMTP password (if required)

# Create a secure password object
$securePassword = ConvertTo-SecureString $password -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($username, $securePassword)

# Send email using SSL
Send-MailMessage -SmtpServer $smtpServer -Port $smtpPort -From $from -To $to -Subject $subject -Body $body -BodyAsHtml -Credential $credential -UseSsl

Turbo360 does not have network line of sight to the SMTP server


If you are having issues sending from Turbo360 but you have managed to get the powershell scripts above to work correctly then the most likely problem is Turbo360 does not have line of site to the SMTP server.

Some of the common causes of this are:

Turbo360 SaaS Hosting

Turbo360 Private Hosting

  • Does your SMTP server have a firewall rule which is blocking access?

  • If you have configured your Turbo360 Private Hosting instance to use an Azure VNet, have you got an NSG or firewall which is preventing access from Turbo360 to the SMTP server


Was this article helpful?

ESC

Eddy AI, facilitating knowledge discovery through conversational intelligence