{"id":17900,"date":"2016-08-17T18:57:45","date_gmt":"2016-08-17T18:57:45","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&#038;p=5847"},"modified":"2024-02-22T08:10:07","modified_gmt":"2024-02-22T08:10:07","slug":"adding-the-sms-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/channel-enablement\/adding-the-sms-channel\/","title":{"rendered":"Adding the Twilio SMS 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>To add Twilio SMS as a channel, you must set up a Programmable SMS app, define the messaging service, and associate the bot with a Twilio Phone Number. When you add the Twilio channel to your bot, end-users for your bot can interact with your bot using text messages.<\/p>\n<p>To add the Twilio SMS channel, follow the below steps:<\/p>\n<ol>\n<li><strong>Setup Account<\/strong> &#8211; Login to Twilio developer portal and set up an account.<\/li>\n<li><strong>Setup Messaging Service <\/strong>&#8211; In the Programmable Messages section, create a messaging service<\/li>\n<li><strong>Add Phone Number <\/strong>&#8211; Associate a Twilio Phone Number to your bot.<\/li>\n<\/ol>\n<p>To add the Twilio Channel, follow the below steps:<br \/>\nThe following procedure requires an active <em>Twilio<\/em> account for developers with access to the Twilio Console. For more information, refer to <em>Creating a Twilio Trial Account<\/em> later in this topic.<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>In <b>Bots<\/b> section of the Bot Builder, click the bot that you want to add the Twilio SMS channel to.<\/li>\n<li>On the <b>Channels<\/b> tab, click the <b>Twilio SMS<\/b> icon. The <b>Twilio SMS Channel<\/b> page is displayed.<\/li>\n<li><a href=\"https:\/\/www.twilio.com\/\">Login <\/a>to Twilio developer portal.<\/li>\n<li>Under the <b>Settings<\/b> section, click the <b>General<\/b> tab.<\/li>\n<li>Create your API credentials, if you have not already set up your account.<\/li>\n<li>Copy your <b>Account SID<\/b> and <b>Auth Token<\/b> and enter them in the <b>Configurations<\/b> tab of the Twilio channel page.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/screen-1-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14206 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/screen-1-1.png\" alt=\"\" width=\"500\" height=\"207\" \/><\/a><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/screen-1-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14207 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/screen-1-2.png\" alt=\"\" width=\"500\" height=\"203\" \/><\/a><\/li>\n<li>Go to the <b>Programmable SMS<\/b> section from the <b>All Products &amp; Services <\/b>menu.<\/li>\n<li>Click <b>Create New Messaging Service<\/b> option. Provide a name for your messaging service and select Use Case as <b>Chat Bot\/Interactive 2-way<\/b>.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/2-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14208 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/2-1.png\" alt=\"\" width=\"500\" height=\"213\" \/><\/a><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/3-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14212 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/3-2.png\" alt=\"\" width=\"500\" height=\"216\" \/><\/a><\/li>\n<li>After creating the service, make note of the <b>Service SID<\/b> of this service and enter it in the <b>Configurations<\/b> tab of the Twilio SMS channel page.<\/li>\n<li>Under <b>Inbound Settings<\/b> section, select the <b>Process Inbound Messages<\/b> option and update the <b>Request URL<\/b> and <b>Fallback URL<\/b> fields with the information provided in <b>Configurations<\/b> tab of the Twilio SMS channel page.<\/li>\n<li>Under <b>Outbound Settings<\/b>, update the <b>Status Callback Request URL<\/b> field with the information provided in the <strong>Configurations<\/strong> tab.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/4-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14209 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/4-2.png\" alt=\"\" width=\"500\" height=\"375\" \/><\/a><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-message color_yellow\"><div class=\"w-message-body\"><p><b>Important<\/b>: The Callback URL now includes the <b><i>streamid<\/i><\/b> in the API request to identify the virtual assistant being accessed. When an incoming request is qualified with this identifier, it helps with traceability, troubleshooting, and remediation at the network level during anomalies like malicious calls or unusual bot activity.<\/p><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li style=\"list-style-type: none;\">\n<ol start=\"12\">\n<li>Under <b>Copilot Features<\/b> section, make sure that <b>Sticky Sender<\/b>, <b>MMS Converter<\/b>, <b>Scaler<\/b>, <b>Short Code Reroute, <\/b>and <b>Country Code Geomatch<\/b> options are enabled.<\/li>\n<li><b>Save<\/b> your changes and proceed.<\/li>\n<li>To add a number, go to the <b>Numbers<\/b> section and associate a Twilio Phone Number to this bot. If you do not have a Twilio Number, you must buy one.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/5-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14211 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/5-2.png\" alt=\"\" width=\"500\" height=\"159\" \/><\/a><\/li>\n<li>Go to the <b>Configurations<\/b> tab in the Twilio SMS channel page to review and complete the channel setup.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h1><span class=\"ez-toc-section\" id=\"Edit_the_Twilio_Channel\">Edit the Twilio Channel<\/span><\/h1>\n<p>To edit the Twilio channel, follow the below steps:<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Hover over the channel and click to modify.<\/li>\n<li>You can make necessary updates to your channel configurations and save them. You can also disable or delete the channel information by clicking the <b>Settings<\/b> icon.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/Screenshot-226.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14213 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/Screenshot-226.png\" alt=\"\" width=\"500\" height=\"239\" \/><\/a><br \/>\nSelect one of the following commands to modify the channel:<\/li>\n<\/ol>\n<ul>\n<li><b>Disable\/Enable<\/b>\n<ul>\n<li>Click <b>Disable<\/b> to temporarily disable the use of the Twilio SMS channel for your bot. To enable the use of the Twilio SMS channel, click <b>Enable.<\/b><\/li>\n<\/ul>\n<\/li>\n<li><b>Delete<\/b>\n<ul>\n<li>Click <b>Delete<\/b>.<\/li>\n<li>On the <b>Delete Confirmation<\/b> dialog box, click <b>OK<\/b> to permanently delete the bot channel configuration.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<div class=\"alert alert-warning\"><b> Warning:<\/b> This operation is permanent, and cannot be undone.<\/div>\n<h1><span class=\"ez-toc-section\" id=\"Create_a_Twilio_Trial_Account\">Create a Twilio Trial Account<\/span><\/h1>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>You can sign up and create a free <em>Twilio<\/em> trial account at <a href=\"https:\/\/www.twilio.com\/try-twilio\">https:\/\/www.twilio.com\/try-twilio<\/a>.<\/li>\n<li>After you create an account, you can sign in and open the <b>Twilio<\/b> <b>Console Dashboard<\/b>.<\/li>\n<li>In the <b>Account Summary<\/b> section, you can find the <b>Account SID<\/b> and <b>Auth Token<\/b>.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/Screenshot-217.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14214 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/Screenshot-217.png\" alt=\"\" width=\"500\" height=\"240\" \/><\/a><\/li>\n<li>Copy the <b>Account SID<\/b> and <b>Auth Token<\/b> and save for configuring the Twilio channel settings in Kore.ai Bot Builder. You also need a telephone number for your end users to send text message interactions to for your bot.<\/li>\n<li>On the <b>Dashboard<\/b> page, you can scroll down and click Numbers. The <b>Phone Numbers Dashboard<\/b> is displayed.<\/li>\n<li>Click <b>Numbers<\/b> on the left menu to display the<b>\u00a0Numbers <\/b>page. Click <strong>Buy a number<\/strong><span style=\"color: #ff0000;\">.<\/span><br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/buy-a-number.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14216 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/buy-a-number.png\" alt=\"\" width=\"500\" height=\"160\" \/><\/a><\/li>\n<li>On the <b>Get Started with Phone Numbers<\/b> page, click <b>Get your first Twilio phone number.<\/b><\/li>\n<li>On the corresponding dialog box, you can find the phone number that you must configure the Kore.ai Twilio channel.<\/li>\n<li>Click <b>Buy This Number<\/b> to save the number to your account.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/35\/purchase-number-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14221 alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/purchase-number-2.png\" alt=\"\" width=\"500\" height=\"202\" \/><\/a><\/li>\n<li>The phone number is saved and accessible from the <b>Home<\/b> screen on the <b>Dashboard<\/b>. You are now ready to configure the Twilio channel in Kore.ai Bot Builder.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<p>&nbsp;<\/p>\n<p><b>Related Link<\/b><\/p>\n<ul>\n<li><a href=\"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/kb\/how-do-i-include-an-image-in-an-outbound-twilio-sms-mms\/\" target=\"_blank\" rel=\"noopener noreferrer\">How do I include an Image in an Outbound Twilio SMS (MMS)?<\/a><\/li>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"ult-spacer spacer-6ae884e420944\" data-id=\"6ae884e420944\" data-height=\"10\" data-height-mobile=\"10\" data-height-tab=\"10\" data-height-tab-portrait=\"\" data-height-mobile-landscape=\"\" style=\"clear:both;display:block;\"><\/div><\/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\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t\r\n\t\t<\/div>\r\n\t<\/div>\r\n<\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"To add Twilio SMS as a channel, you must set up a Programmable SMS app, define the messaging service, and associate the bot with a Twilio Phone Number. When you add the Twilio channel to your bot, end-users for your bot can interact with your bot using text messages. To add the Twilio SMS channel,...","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-17900","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\/17900","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=17900"}],"version-history":[{"count":12,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17900\/revisions"}],"predecessor-version":[{"id":61287,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17900\/revisions\/61287"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=17900"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=17900"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=17900"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}