Updated via BpDeleteTranslateTags script |
Wyler.metge (talk | contribs) Updated via BpClonePage extension. Source page: draft:Contact-center-administrator-guide/CallCenterConfiguration/EmailSettings |
||
| Line 1: | Line 1: | ||
= Email Settings= | = Email Settings= | ||
This menu contains various settings related to email communications. Note that in addition to customer interactions, email in Bright Pattern Contact Center is used for various auxiliary tasks, such as sending transcripts of chat sessions, password reset instructions, scheduled reports, and voicemail audio files. | This menu contains various settings related to email communications. Note that in addition to customer interactions, email in Bright Pattern Contact Center is used for various auxiliary tasks, such as sending transcripts of chat sessions, password reset instructions, scheduled reports, and voicemail audio files. | ||
| Line 12: | Line 12: | ||
== Email Header and Footer == | == Email Header and Footer == | ||
This section relates to customer email interactions and lets you define mandatory standard messages that will be inserted above (the header) and/or below (the footer) the main text of each email that is sent to a customer. Some examples of such messages are references to case numbers, legal disclaimers, and a company’s contact information. Headers and footers are not applied to [[contact-center-administrator-guide/EmailTab|acknowledgements]] (initial automatic replies sent to acknowledge receipt of incoming mail). | This section relates to customer email interactions and lets you define mandatory standard messages that will be inserted above (the header) and/or below (the footer) the main text of each email that is sent to a customer. Some examples of such messages are references to case numbers, legal disclaimers, and a company’s contact information. Headers and footers are not applied to [[contact-center-administrator-guide/EmailTab|acknowledgements]] (initial automatic replies sent to acknowledge receipt of incoming mail). | ||
| Line 23: | Line 23: | ||
=== Header and Footer Screen Properties === | === Header and Footer Screen Properties === | ||
The ''Email Header and Footer'' screen properties are described as follows. | The ''Email Header and Footer'' screen properties are described as follows. | ||
==== Language ==== | ==== Language ==== | ||
The ''Language'' setting is where you select the language of the header and footer message. Note that you can define the header and footer in multiple languages. The system will automatically insert the version corresponding to the language of the main text of the email. | The ''Language'' setting is where you select the language of the header and footer message. Note that you can define the header and footer in multiple languages. The system will automatically insert the version corresponding to the language of the main text of the email. | ||
'''Please note''': The languages listed here differ from those found in [[contact-center-administrator-guide/LanguageSkills|Language Skills]]; only auto-detectable languages are available to select from this menu. | '''Please note''': The languages listed here differ from those found in [[contact-center-administrator-guide/LanguageSkills|Language Skills]]; only auto-detectable languages are available to select from this menu. | ||
==== Header ==== | ==== Header ==== | ||
Type the text of the message that should appear in the ''Header'' field, above the main text of all emails sent to customers. | Type the text of the message that should appear in the ''Header'' field, above the main text of all emails sent to customers. | ||
==== Footer ==== | ==== Footer ==== | ||
Type the text of the message that should appear in the ''Footer'' field, below the main text of all emails sent to customers. | Type the text of the message that should appear in the ''Footer'' field, below the main text of all emails sent to customers. | ||
==== Insert $() ==== | ==== Insert $() ==== | ||
This setting specifies the menu of substitution fields that can be inserted in the header and footer messages. Except for ''$(cursor)'', these are the same [[contact-center-administrator-guide/KnowledgeBase|substitution fields]] that are used in Knowledge Base articles. | This setting specifies the menu of substitution fields that can be inserted in the header and footer messages. Except for ''$(cursor)'', these are the same [[contact-center-administrator-guide/KnowledgeBase|substitution fields]] that are used in Knowledge Base articles. | ||
==== Remove ==== | ==== Remove ==== | ||
Use the ''Remove'' button to remove the header and footer in the selected language. | Use the ''Remove'' button to remove the header and footer in the selected language. | ||
== | == System Email Account == | ||
Use this page to configure the email settings for system-generated communications. This account handles internal notifications, such as password reset instructions, scheduled reports, voicemail forwarding, and chat transcripts. | |||
Note that this page ''does not'' configure email accounts for customer interactions. For information on configuring outbound email for contact center operations, see [[contact-center-administrator-guide/Email|email scenario entries]]. | |||
Select the desired '''Protocol''' for the connection: ''SMTP'' or ''Microsoft Graph''. The required settings vary based on the selected protocol. | |||
=== Protocol: SMTP === | |||
When the ''protocol'' option is set to ''SMTP'', the following properties are required. | |||
[[File:SMTP-Config-50.png|thumb|600px|center|Email Settings > SMTP Configuration]] | |||
==== | ==== Tenant sender display name ==== | ||
The name that will appear in the ''From'' field of system emails. | |||
==== Tenant sender email address ==== | |||
The email address that will appear in the ''From'' field of system emails. | |||
==== SMTP server hostname ==== | |||
Specify the SMTP server host name. | |||
==== SMTP server port ==== | |||
Specify the SMTP server port number. | |||
==== Connection security ==== | |||
Select the cryptographic protocol used to secure the connection: | |||
* For an unsecured connection, select '''none'''. | |||
'' | |||
* To upgrade a plain text connection to a secure one, select '''negotiate encryption in a plain connection (STARTTLS)'''. | |||
'' | |||
* To secure the connection immediately upon establishment, select '''use an encrypted connection (TLS)'''. | |||
* To | |||
==== Server requires authentication ==== | ==== Server requires authentication ==== | ||
Indicate whether client authentication is required for the SMTP server. | |||
==== Username ==== | ==== Username ==== | ||
The username for SMTP client authentication. Required if ''Server requires authentication'' is enabled. | |||
==== Password ==== | ==== Password ==== | ||
The password for SMTP client authentication. Required if ''Server requires authentication'' is enabled. | |||
==== Check settings ==== | ==== Check settings ==== | ||
Use the ''Check settings'' button to verify | Use the ''Check settings'' button to verify your SMTP settings. | ||
== Password Recovery Template == | === Protocol: MS Graph === | ||
When the ''protocol'' option is set to ''MS Graph'', the following properties are required. | |||
{{Note| | |||
In order to use ''MS Graph'' as a protocol option, your service provider must: | |||
* Configure your contact center to use the centralized internal email service. | |||
* Enable Microsoft Graph API support. | |||
}} | |||
[[File:MSGraph-Config-535.png|thumb|600px|center|Email Settings > MS Graph Configuration]] | |||
==== Connect account ==== | |||
Click ''Connect account'' to open a Microsoft login window. Log in to your account and authorize the application to send emails on your behalf. If you are already signed in, the system may automatically detect your active session. Once connected, the ''Tenant sender email address'' and ''Tenant sender display name'' fields are automatically populated. For more information, see [[Contact-center-administrator-guide/ApplicationNotes/MSGraph|How to Configure Microsoft Email Account Access Using Microsoft Graph]]. | |||
==== Tenant sender email address ==== | |||
Indicates the address that will send system emails. | |||
==== Tenant sender display name ==== | |||
Indicates the name of the sender of system emails. | |||
==== Check settings ==== | |||
Click to verify the MS Graph settings. | |||
== Password Recovery Template == | |||
To configure a template for password reset instructions, select '''Password Recovery Template''' from the ''Email Settings'' menu. | To configure a template for password reset instructions, select '''Password Recovery Template''' from the ''Email Settings'' menu. | ||
| Line 93: | Line 125: | ||
=== Password Recovery Template Screen Properties === | === Password Recovery Template Screen Properties === | ||
The ''Password Recovery Template'' screen properties are described as follows. | The ''Password Recovery Template'' screen properties are described as follows. | ||
| Line 99: | Line 131: | ||
This setting specifies the text that will appear in the ''Subject'' field of the emails with password reset instructions. | This setting specifies the text that will appear in the ''Subject'' field of the emails with password reset instructions. | ||
==== Message ==== | ==== Message ==== | ||
This setting specifies the text that will appear in the body of the emails with password reset instructions. | This setting specifies the text that will appear in the body of the emails with password reset instructions. | ||
| Line 109: | Line 141: | ||
== Chat Transcript Template == | == Chat Transcript Template == | ||
To configure a | To configure a template for chat transcripts, select '''Chat Transcript Template''' from the ''Email Settings'' menu. | ||
| Line 121: | Line 148: | ||
=== Chat Transcript Template Screen Properties === | === Chat Transcript Template Screen Properties === | ||
The ''Chat Transcript Template'' screen properties are described as follows. | The ''Chat Transcript Template'' screen properties are described as follows. | ||
| Line 130: | Line 157: | ||
The ''Sender email address'' will appear in the ''From'' field of the emails with chat transcripts. This setting is mandatory for sending emails with chat transcripts. | The ''Sender email address'' will appear in the ''From'' field of the emails with chat transcripts. This setting is mandatory for sending emails with chat transcripts. | ||
==== Subject ==== | ==== Subject ==== | ||
This setting specifies the text that will appear in the ''Subject'' field of the emails with chat transcripts. | This setting specifies the text that will appear in the ''Subject'' field of the emails with chat transcripts. | ||
Latest revision as of 16:00, 2 March 2026
Email Settings
This menu contains various settings related to email communications. Note that in addition to customer interactions, email in Bright Pattern Contact Center is used for various auxiliary tasks, such as sending transcripts of chat sessions, password reset instructions, scheduled reports, and voicemail audio files.
To configure email settings, select Email Settings from the Call Center Configuration menu.
Note the following:
- Except for the SMTP settings, configuring the system to send voicemail attachments is done via scenarios. For more information, see section Voicemail of this guide and description of the Voicemail block in the Scenario Builder Reference Guide.
- Except for the SMTP settings, configuring the system to send reports via email is done via the Scheduled Reports page.
- Except for the SMTP settings and chat transcript template, configuring the system to email chat transcripts is done via scenarios. Note that the EMail scenario block is not used for this purpose. Rather, sending a chat transcript email is triggered by setting variable $(item.sendTranscript) to 1 in the chat scenario. You can see an example of such configuration in the Support Chat scenario template.
This section relates to customer email interactions and lets you define mandatory standard messages that will be inserted above (the header) and/or below (the footer) the main text of each email that is sent to a customer. Some examples of such messages are references to case numbers, legal disclaimers, and a company’s contact information. Headers and footers are not applied to acknowledgements (initial automatic replies sent to acknowledge receipt of incoming mail).
Note: The headers and footers configured here will be applied to all emails sent from your contact center regardless of the service. For service-specific email templates, default Knowledge Base articles should be used.
To configure these elements, select option Email Header and Footer from the Email Settings menu.

The Email Header and Footer screen properties are described as follows.
Language
The Language setting is where you select the language of the header and footer message. Note that you can define the header and footer in multiple languages. The system will automatically insert the version corresponding to the language of the main text of the email.
Please note: The languages listed here differ from those found in Language Skills; only auto-detectable languages are available to select from this menu.
Header
Type the text of the message that should appear in the Header field, above the main text of all emails sent to customers.
Type the text of the message that should appear in the Footer field, below the main text of all emails sent to customers.
Insert $()
This setting specifies the menu of substitution fields that can be inserted in the header and footer messages. Except for $(cursor), these are the same substitution fields that are used in Knowledge Base articles.
Remove
Use the Remove button to remove the header and footer in the selected language.
System Email Account
Use this page to configure the email settings for system-generated communications. This account handles internal notifications, such as password reset instructions, scheduled reports, voicemail forwarding, and chat transcripts.
Note that this page does not configure email accounts for customer interactions. For information on configuring outbound email for contact center operations, see email scenario entries.
Select the desired Protocol for the connection: SMTP or Microsoft Graph. The required settings vary based on the selected protocol.
Protocol: SMTP
When the protocol option is set to SMTP, the following properties are required.

Tenant sender display name
The name that will appear in the From field of system emails.
Tenant sender email address
The email address that will appear in the From field of system emails.
SMTP server hostname
Specify the SMTP server host name.
SMTP server port
Specify the SMTP server port number.
Connection security
Select the cryptographic protocol used to secure the connection:
- For an unsecured connection, select none.
- To upgrade a plain text connection to a secure one, select negotiate encryption in a plain connection (STARTTLS).
- To secure the connection immediately upon establishment, select use an encrypted connection (TLS).
Server requires authentication
Indicate whether client authentication is required for the SMTP server.
Username
The username for SMTP client authentication. Required if Server requires authentication is enabled.
Password
The password for SMTP client authentication. Required if Server requires authentication is enabled.
Check settings
Use the Check settings button to verify your SMTP settings.
Protocol: MS Graph
When the protocol option is set to MS Graph, the following properties are required.
|
In order to use MS Graph as a protocol option, your service provider must:
| ||

Connect account
Click Connect account to open a Microsoft login window. Log in to your account and authorize the application to send emails on your behalf. If you are already signed in, the system may automatically detect your active session. Once connected, the Tenant sender email address and Tenant sender display name fields are automatically populated. For more information, see How to Configure Microsoft Email Account Access Using Microsoft Graph.
Tenant sender email address
Indicates the address that will send system emails.
Tenant sender display name
Indicates the name of the sender of system emails.
Check settings
Click to verify the MS Graph settings.
Password Recovery Template
To configure a template for password reset instructions, select Password Recovery Template from the Email Settings menu.

Password Recovery Template Screen Properties
The Password Recovery Template screen properties are described as follows.
Subject
This setting specifies the text that will appear in the Subject field of the emails with password reset instructions.
Message
This setting specifies the text that will appear in the body of the emails with password reset instructions.
You can use the following variables in this text:
- $(FIRST) for the first name of the email recipient
- $(LAST) for the last name of the email recipient
- $(LOGIN) for recipient’s username
- $(LINK) as a placeholder for password recovery link
Chat Transcript Template
To configure a template for chat transcripts, select Chat Transcript Template from the Email Settings menu.

Chat Transcript Template Screen Properties
The Chat Transcript Template screen properties are described as follows.
System sender display name
This is the name that will appear in the From field of the emails with chat transcripts. This setting is mandatory for sending emails with chat transcripts.
System sender email address
The Sender email address will appear in the From field of the emails with chat transcripts. This setting is mandatory for sending emails with chat transcripts.
Subject
This setting specifies the text that will appear in the Subject field of the emails with chat transcripts.
Message
This setting specifies the text that will appear in the body of the emails with chat transcripts.
You can use the following variables in this text:
- $(FIRST) for the first name of the email recipient
- $(LAST) for the last name of the email recipient
- $(LOGIN) for recipient’s username
- $(CHAT_TRANSCRIPT) for chat transcript
- $(TENANT_NAME) for your business name as it is registered with your service provider
< Previous | Next >