Skip to content

SMTP

SMTP needs to be configured for functionalities such as Agent notifications for new conversations, password resets, to verify new Agent accounts, etc.

Values

Name Type Default Value
configmap.SMTP_ADDRESS Set your SMTP address. ""
configmap.SMTP_AUTHENTICATION Allowed values: plain,login,cram_md5 "plain"
configmap.SMTP_ENABLE_STARTTLS_AUTO Defaults to true. "true"
configmap.SMTP_OPENSSL_VERIFY_MODE Can be: none, peer, client_once, fail_if_no_peer_cert "none"
configmap.SMTP_PASSWORD SMTP Password, ignored when the secret is defined. ""
configmap.SMTP_PORT SMTP Port "587"
configmap.SMTP_USERNAME SMTP Username ""
configmap.MAILER_SENDER_EMAIL The email from which all outgoing emails are sent. ""

Creating A Secret For The SMTP Password

Before installing Live Agent with Helm, create a secret on the Kubernetes cluster namespace where Live Agent is installed. Take note of the SMTP secret name and key, and set the following values:

Name Type Default Value
smtp.secret SMTP Secret Name ""
smtp.secretPasswordKey SMTP Secret Key ""

Configuring Different SMTP Servers

Here is a sample of configurations for getting email functionality working for the Live Agent application. Remember that the SMTP password is stored in the secret, as mentioned above.

For the following sender value, you could use either email@yourdomain.com or BrandName <email@yourdomain.com>

Name Type Value
configmap.MAILER_SENDER_EMAIL string ""

Set the following variables based on your SMTP server configuration.

Name Type Value
configmap.SMTP_ADDRESS string ""
configmap.SMTP_USERNAME string ""
Password secret string ""

No Authentication

If you server does not need authentication, comment, or don't provide, these values: SMTP_AUTHENTICATION. SMTP_USERNAME, SMTP_PASSWORD in the values.yaml file.

Name Type Value
configmap.MAILER_SENDER_EMAIL string "Your SMTP Username"
configmap.SMTP_ADDRESS string "smtp-mail.outlook.com"
configmap.SMTP_ENABLE_STARTTLS_AUTO bool true
configmap.SMTP_PORT string "587"

Amazon SES

Name Type Value
configmap.SMTP_ADDRESS string "email-smtp.<region>.amazonaws.com"
configmap.SMTP_AUTHENTICATION string "plain"
configmap.SMTP_ENABLE_STARTTLS_AUTO bool true
configmap.SMTP_USERNAME string "<Your SMTP Username>"
Secret Password string "<Your SMTP Password>"

Outlook

The sender and username must be the same as in Outlook.

Name Type Value
configmap.MAILER_SENDER_EMAIL string "Your SMTP Username"
configmap.SMTP_ADDRESS string "smtp-mail.outlook.com"
configmap.SMTP_AUTHENTICATION string "login"
configmap.SMTP_ENABLE_STARTTLS_AUTO bool true
configmap.SMTP_USERNAME string "<Your SMTP username>"
Secret Password string "<Your SMTP Password>"
configmap.SMTP_PORT string "587"

SendGrid

Name Type Value
configmap.SMTP_ADDRESS string "smtp.sendgrid.net"
configmap.SMTP_AUTHENTICATION string "plain"
configmap.SMTP_DOMAIN string "<Your Verified Domain>"
configmap.SMTP_ENABLE_STARTTLS_AUTO bool true
configmap.SMTP_PORT string "587"
configmap.SMTP_USERNAME string "apikey"
Secret Password string "<your Sendgrid API key>"

MailGun

Name Type Value
configmap.SMTP_ADDRESS string "smtp.mailgun.org"
configmap.SMTP_AUTHENTICATION string "plain"
configmap.SMTP_DOMAIN string "<Your Domain, this has to be verified in Mailgun>"
configmap.SMTP_ENABLE_STARTTLS_AUTO bool true
configmap.SMTP_PORT string "587"
configmap.SMTP_USERNAME string "<Your SMTP Username, view under Domains tab>"
Secret Password string "<Your SMTP Password, view under Domains tab>"

Mandrill

If you would like to use Mailchimp to send your emails, use the following environment variables:

Note: Mandrill is the transactional email service for Mailchimp. You need to enable transactional email and login to mandrillapp.com.

Name Type Value
configmap.SMTP_ADDRESS string "smtp.mandrillapp.com"
configmap.SMTP_AUTHENTICATION string "plain"
configmap.SMTP_DOMAIN string "<Your Verified Domain in Mailchimp>"
configmap.SMTP_ENABLE_STARTTLS_AUTO bool true
configmap.SMTP_PORT string "587"
configmap.SMTP_USERNAME string "<Your SMTP Username, displayed under Settings -> SMTP & API info>"
Secret Password string "<Any Valid API key, create an API key under Settings -> SMTP & API Info>"
Back to top