SMTP

Live Agent has been put in maintenance mode. The product will continue to be maintained in the foreseeable future. Users can continue to fully rely on Live Agent being available. In future releases, only security updates and bug fixes will be provided; no new features will be released.

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.	`""`

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:

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 your 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 log in 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>"`

Overview

Conversations

Assistants

Analytics Tools

Configure

Access Management

User Profile and Notifications

Miscellaneous

Values

Create Secrets for SMTP Passwords

Configuring Different SMTP Servers

No Authentication

Amazon SES

Outlook

SendGrid

MailGun

Mandrill

​Values

​Create Secrets for SMTP Passwords

​Configuring Different SMTP Servers

​No Authentication

​Amazon SES

​Outlook

​SendGrid

​MailGun

​Mandrill

Values

Create Secrets for SMTP Passwords

Configuring Different SMTP Servers

No Authentication

Amazon SES

Outlook

SendGrid

MailGun

Mandrill