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

Values

NameTypeDefault Value
configmap.SMTP_ADDRESSSet your SMTP address.""
configmap.SMTP_AUTHENTICATIONAllowed values: plain,login,cram_md5"plain"
configmap.SMTP_ENABLE_STARTTLS_AUTODefaults to true."true"
configmap.SMTP_OPENSSL_VERIFY_MODECan be: none, peer, client_once, fail_if_no_peer_cert"none"
configmap.SMTP_PASSWORDSMTP Password, ignored when the secret is defined.""
configmap.SMTP_PORTSMTP Port"587"
configmap.SMTP_USERNAMESMTP Username""
configmap.MAILER_SENDER_EMAILThe email from which all outgoing emails are sent.""

Create Secrets for SMTP Passwords

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:
NameTypeDefault Value
smtp.secretSMTP Secret Name""
smtp.secretPasswordKeySMTP 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>
NameTypeValue
configmap.MAILER_SENDER_EMAILstring""
Set the following variables based on your SMTP server configuration.
NameTypeValue
configmap.SMTP_ADDRESSstring""
configmap.SMTP_USERNAMEstring""
Password secretstring""

No Authentication

If your server does not need authentication, comment, or don’t provide these values: SMTP AUTHENTICATION, SMTP_USERNAME, SMTP_PASSWORD in the values.yaml file.
NameTypeValue
configmap.MAILER_SENDER_EMAILstring"Your SMTP Username"
configmap.SMTP_ADDRESSstring"smtp-mail.outlook.com"
configmap.SMTP_ENABLE_STARTTLS_AUTObooltrue
configmap.SMTP_PORTstring"587"

Amazon SES

NameTypeValue
configmap.SMTP_ADDRESSstring"email-smtp.<region>.amazonaws.com"
configmap.SMTP_AUTHENTICATIONstring"plain"
configmap.SMTP_ENABLE_STARTTLS_AUTObooltrue
configmap.SMTP_USERNAMEstring"<Your SMTP Username>"
Secret Passwordstring"<Your SMTP Password>"

Outlook

The sender and username must be the same as in Outlook.
NameTypeValue
configmap.MAILER_SENDER_EMAILstring"Your SMTP Username"
configmap.SMTP_ADDRESSstring"smtp-mail.outlook.com"
configmap.SMTP_AUTHENTICATIONstring"login"
configmap.SMTP_ENABLE_STARTTLS_AUTObooltrue
configmap.SMTP_USERNAMEstring"<Your SMTP username>"
Secret Passwordstring"<Your SMTP Password>"
configmap.SMTP_PORTstring"587"

SendGrid

NameTypeValue
configmap.SMTP_ADDRESSstring"smtp.sendgrid.net"
configmap.SMTP_AUTHENTICATIONstring"plain"
configmap.SMTP_DOMAINstring"<Your Verified Domain>"
configmap.SMTP_ENABLE_STARTTLS_AUTObooltrue
configmap.SMTP_PORTstring"587"
configmap.SMTP_USERNAMEstring"apikey"
Secret Passwordstring"<your Sendgrid API key>"

MailGun

NameTypeValue
configmap.SMTP_ADDRESSstring"smtp.mailgun.org"
configmap.SMTP_AUTHENTICATIONstring"plain"
configmap.SMTP_DOMAINstring"<Your Domain, this has to be verified in Mailgun>"
configmap.SMTP_ENABLE_STARTTLS_AUTObooltrue
configmap.SMTP_PORTstring"587"
configmap.SMTP_USERNAMEstring"<Your SMTP Username, view under Domains tab>"
Secret Passwordstring"<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 log in to mandrillapp.com.
NameTypeValue
configmap.SMTP_ADDRESSstring"smtp.mandrillapp.com"
configmap.SMTP_AUTHENTICATIONstring"plain"
configmap.SMTP_DOMAINstring"<Your Verified Domain in Mailchimp>"
configmap.SMTP_ENABLE_STARTTLS_AUTObooltrue
configmap.SMTP_PORTstring"587"
configmap.SMTP_USERNAMEstring"<Your SMTP Username, displayed under Settings -> SMTP & API info>"
Secret Passwordstring"<Any Valid API key, create an API key under Settings -> SMTP & API Info>"
I