Skip to main content

SMTP Configuration (Business License)

SMTP configuration is required for your WhautoChat Business License platform to send essential emails such as login verification codes, account activation emails, password resets, team member invites, and other important platform notifications. Without a properly configured SMTP server, users and administrators will not receive these critical communications, which can impact user experience and security.

This guide will walk you through what SMTP settings you need to collect from your email provider (such as SMTP server address, port, username, password, and encryption type).

By following this guide, you will ensure that your WhautoChat Business License deployment can reliably send emails to your users and administrators.

Step 1: Choose an SMTP Provider​

  • You can use a commercial provider (e.g., SendGrid, Mailgun, Amazon SES, Gmail) or your own mail server.

Step 2: Gather SMTP Details​

  • Host (SMTP server address)
  • Port (usually 587 for TLS, 465 for SSL, or 25 for non-secure)
  • Username (email address or SMTP user)
  • Password (SMTP password or app password)
  • TLS/SSL requirement

Step 3: Configure WhautoChat​

In your installation folder, locate the web-server.env file. This file contains the environment variables required for your WhautoChat deployment, including SMTP settings.

Make sure to update the following section in web-server.env with your SMTP provider details:

# SMTP Configuration (Required for Signup verification, team member invites and notifications) - Any SMTP server will work E.g. AWS SES, MailGun, SendGrid, etc
SMTP_HOST='your_smtp_host'
SMTP_PORT='your_smtp_port'
SMTP_USERNAME='your_smtp_username'
SMTP_PASSWORD='your_smtp_password'
DEFAULT_FROM_EMAIL='Product Support <[email protected]>'
SUPPORT_EMAIL='[email protected]'
  • Replace the values in single quotes with your actual SMTP details.
  • DEFAULT_FROM_EMAIL is the name and email that will appear as the sender for outgoing emails.
  • SUPPORT_EMAIL is the address users can reply to for support questions.

Any SMTP server will work, including AWS SES, MailGun, SendGrid, Gmail (with app password), or your own mail server.

Security Best Practices​

  • Use app-specific passwords or API keys if supported by your provider.
  • Never share your SMTP credentials publicly.
  • Enable 2FA on your email provider account.
  • Use secure ports (465 or 587) and always require TLS/SSL.

Troubleshooting​

  • Check your SMTP provider’s logs for rejected connections or authentication errors.
  • Ensure your server’s firewall allows outbound connections to the SMTP port.
  • Some providers (e.g., Gmail) may require you to enable access for less secure apps or generate an app password.

Refer to your SMTP provider’s documentation for detailed steps and troubleshooting tips.

Security Best Practices​

  • Use app-specific passwords or API keys if supported by your provider.
  • Never share your SMTP credentials publicly.
  • Enable 2FA on your email provider account.
  • Use secure ports (465 or 587) and always require TLS/SSL.

Troubleshooting​

  • Check your SMTP provider’s logs for rejected connections or authentication errors.
  • Ensure your server’s firewall allows outbound connections to the SMTP port.
  • Some providers (e.g., Gmail) may require you to enable access for less secure apps or generate an app password.

Refer to your SMTP provider’s documentation for detailed steps and troubleshooting tips.