{"id":17898,"date":"2016-08-17T18:02:21","date_gmt":"2016-08-17T18:02:21","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&#038;p=5842"},"modified":"2024-03-11T07:30:04","modified_gmt":"2024-03-11T07:30:04","slug":"adding-the-email-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/channel-enablement\/adding-the-email-channel\/","title":{"rendered":"Adding the Email Channel"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p>When you add the email channel to your VA, the XO Platform automatically generates the email address for end users to communicate with your assistant. By default, the email address syntax is <strong><em>&lt; bot name &gt;@bots.kore.com<\/em><\/strong>. For example, <strong><em>customer-support@bots.kore.com<\/em><\/strong>. Optionally, you can add a custom name, such as <strong><em>my-bot@bots.kore.com<\/em>.<\/strong><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-message color_blue\"><div class=\"w-message-body\"><p><b>Note<\/b>: A maximum of 5000 characters are allowed for the email channel. This character limit is configurable for On-premise installation.<\/p><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p><span style=\"font-weight: 400;\">By adding the email channel to your VA, end users can interact with it using any standard email client, such as <\/span><i><span style=\"font-weight: 400;\">Microsoft Outlook<\/span><\/i><span style=\"font-weight: 400;\"> or <\/span><i><span style=\"font-weight: 400;\">Yahoo<\/span><\/i><span style=\"font-weight: 400;\">.<\/span><\/p>\n<h2><span class=\"ez-toc-section\" id=\"Configure_a_Custom_Display_Name\">Configure a Custom Display Name<\/span><\/h2>\n<p>Developers can now define custom display names for configured email addresses with the optional<strong> Display Name<\/strong> field. Providing the display name ensures that the name linked to the sender\u2019s email address is visible to the end user in the sender\u2019s email profile. An example of how a display name, when provided, appears to the end user is given below:<\/p>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309065647\/email-display-name.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61404\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309065647\/email-display-name.png\" alt=\"\" width=\"550\" height=\"119\" \/><\/a><\/p>\n<p>For more details, please refer to<strong> Step 3<\/strong>\u00a0in the next section.<\/p>\n<p>When <strong>Display Name<\/strong> is not provided, the email profiles appear with the sender&#8217;s name linked to the email address and the text \u201c<em>Bot (via Kore)<\/em>\u201d to the end user.<\/p>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309070024\/banking-support-display-name.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61407\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309070024\/banking-support-display-name.png\" alt=\"\" width=\"400\" height=\"85\" \/><\/a><\/p>\n<h2><span class=\"ez-toc-section\" id=\"Steps_to_Add_the_Email_Channel\">Steps to Add the Email Channel<\/span><\/h2>\n<ol>\n<li>On the XO Platform, go to <strong>Deploy <\/strong>&gt;<strong> Channels <\/strong>&gt;<strong> Email <\/strong>on the left navigation menu.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309075611\/navigate-to-email-channel.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61429\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309075611\/navigate-to-email-channel.png\" alt=\"\" width=\"600\" height=\"400\" \/><\/a><\/li>\n<li>In the <strong>Email<\/strong> window, change the first portion of the address set to the VA name (default value) for <strong><label class=\"text-block ng-binding\">Email to this bot can be sent to the below email address<\/label><\/strong><label class=\"text-block ng-binding\">.<\/label>\n<div class=\"col-xs-10 noPadding\">\n<form class=\"form-inline ng-pristine ng-valid\">\n<div class=\"form-group\">\n<div class=\"input-group pull-left\"><\/div>\n<\/div>\n<\/form>\n<\/div>\n<p>.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309074159\/email-field-entry.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61423\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309074159\/email-field-entry.png\" alt=\"\" width=\"550\" height=\"220\" \/><\/a><\/li>\n<li><strong>(Optional)<\/strong> Enter the value for <strong>Display Name<\/strong> to customize how the configured email address will appear to the end user.<\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-message color_blue\"><div class=\"w-message-body\"><p><b>Note<\/b>: A maximum of 30 characters are allowed for the display name, including special characters, numbers, and spaces.<\/p><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309074529\/add-display-name.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61426\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309074529\/add-display-name.png\" alt=\"\" width=\"550\" height=\"123\" \/><\/a><\/p>\n<ol start=\"4\">\n<li>Choose whether you want to send a contact card to all users as a part of the introduction message under<strong> Send contact card (.VCF)<\/strong>.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309073344\/send-contact-card.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61419\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309073344\/send-contact-card.png\" alt=\"\" width=\"500\" height=\"132\" \/><\/a><\/li>\n<li>Under the <strong>Enable Channel<\/strong> section, select <strong>Yes <\/strong>to enable the channel.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309073141\/enable-email-channel.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61416\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309073141\/enable-email-channel.png\" alt=\"\" width=\"400\" height=\"137\" \/><\/a><\/li>\n<li aria-level=\"1\"><strong>(Optional) <\/strong>Turn on the <strong>Email Template Design (Optional)<\/strong> toggle to configure the header and footer of the emails that are sent via the configured email address, and do the following:<\/li>\n<\/ol>\n<ul>\n<li>Click <b>Edit Header<\/b> and <b>Edit Footer<\/b> to configure the header and footer details.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309072850\/optional-selection-email-template.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61413\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309072850\/optional-selection-email-template.png\" alt=\"\" width=\"650\" height=\"400\" \/><\/a><\/li>\n<li>In the <b>Edit <\/b>window, change the header and footer details, and click <b>Preview<\/b> to see the changes.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20231016075539\/email_template_designer3.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-59822\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20231016075539\/email_template_designer3.png\" alt=\"\" width=\"650\" height=\"300\" \/><\/a><\/li>\n<\/ul>\n<ul>\n<li>Click <b>Save<\/b>.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20231016075859\/email_template_designer4.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-59826\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20231016075859\/email_template_designer4.png\" alt=\"\" width=\"650\" height=\"300\" \/><\/a><\/li>\n<\/ul>\n<ol start=\"7\">\n<li>In the <strong>Email <\/strong>window, click <strong>Save<\/strong>. The <em>Channel added successfully<\/em> message is displayed.<br \/>\n<img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-61410\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20240309072346\/email-template-design-header-footer.png\" alt=\"\" width=\"700\" height=\"400\" \/><\/li>\n<\/ol>\n<p>Once the channel is enabled and all configurations are verified, you can optionally publish the assistant to make it available for end-users, with the new channel. Learn more about<a href=\"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/publish\/publishing-bot\/\"> Publishing your Virtual Assistant<\/a>.<\/p>\n<p>To learn more about working with Channels within the Kore.ai XO Platform, please see<a href=\"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/channel-enablement\/adding-channels-to-your-bot\/\"> Channel Enablement.<\/a><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<\/div><\/div><\/div><\/div><\/div><\/section><section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\"><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"When you add the email channel to your VA, the XO Platform automatically generates the email address for end users to communicate with your assistant. By default, the email address syntax is &lt; bot name &gt;@bots.kore.com. For example, customer-support@bots.kore.com. Optionally, you can add a custom name, such as my-bot@bots.kore.com. Note: A maximum of 5000 characters...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-17898","post","type-post","status-publish","format-standard","hentry","category-channel-enablement"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17898","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/comments?post=17898"}],"version-history":[{"count":25,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17898\/revisions"}],"predecessor-version":[{"id":61446,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17898\/revisions\/61446"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=17898"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=17898"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=17898"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}