{"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":"2021-03-30T13:03:34","modified_gmt":"2021-03-30T12:03:34","slug":"adding-the-sms-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v7-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 will need to set up a Programmable SMS app, define the messaging service and then 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 Twilio SMS channel, you need to:<\/p>\n<ol>\n<li><strong>Setup Account-<\/strong> Login to Twilio developer portal and set up an account.<\/li>\n<li><strong>Setup Messaging Service-<\/strong> In the Programmable Messages section, create a messaging service<\/li>\n<li><strong>Add Phone Number-<\/strong> Associate a Twilio Phone Number to your bot.<\/li>\n<\/ol>\n<p><b>To add Twilio Channel:<\/b><br \/>\nThe following procedure requires an active <em>Twilio<\/em> account for developers with access to the Twilio Console. For more information, see <em>Creating a Twilio Trial Account<\/em> later in this topic.<\/p>\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 gets displayed.<\/li>\n<li><a href=\"https:\/\/www.twilio.com\/\">Login <\/a>to Twilio developer portal and in the <b>Settings<\/b> section, navigate to the <b>General<\/b> tab.\u00a0 Create your API credentials, if you have not already set up your account. 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\/12\/screen-1-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14206 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/screen-1-1.png\" alt=\"\" width=\"500\" height=\"207\" \/><\/a><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/screen-1-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14207 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/screen-1-2.png\" alt=\"\" width=\"500\" height=\"203\" \/><\/a><\/li>\n<li>Navigate to <b>Programmable SMS<\/b> section from <b>All Products &amp; Services <\/b>menu. Click on <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\/12\/2-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14208 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/2-1.png\" alt=\"\" width=\"500\" height=\"213\" \/><\/a><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/3-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14212 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/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. Under <b>Outbound Settings<\/b>, update the <b>Status Callback Request URL<\/b> field with the information provided in the Configurations tab.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/4-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14209 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/4-2.png\" alt=\"\" width=\"500\" height=\"375\" \/><\/a><br \/>\nUnder <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. <b>Save<\/b> your changes and proceed.<\/li>\n<li>To add a number, navigate to <b>Numbers<\/b> section and associate a Twilio Phone Number to this bot. If you do not have a Twilio Number, you need to buy one.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/5-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14211 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/5-2.png\" alt=\"\" width=\"500\" height=\"159\" \/><\/a><\/li>\n<li>Navigate to the <b>Configurations<\/b> tab in the Twilio SMS channel page to review and complete the channel setup.<\/li>\n<\/ol>\n<h1><span class=\"ez-toc-section\" id=\"Editing_the_Twilio_Channel\">Editing the Twilio Channel<\/span><\/h1>\n<p>To edit the Twilio channel, hover your mouse over the channel and click to modify. You can make necessary updates to your channel configurations and save them. You may also disable or delete the channel information by clicking the <b>Settings<\/b> icon.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/Screenshot-226.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14213 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/Screenshot-226.png\" alt=\"\" width=\"500\" height=\"239\" \/><\/a><br \/>\nSelect one of the following commands to modify the channel:<\/p>\n<ul>\n<li><b>Disable\/Enable<\/b> \u2013 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<li><b>Delete<\/b> \u2013 Click <b>Delete<\/b>, and then click <b>OK<\/b> in the <b>Delete Confirmation<\/b> dialog to permanently delete the Bot channel configuration.<\/li>\n<\/ul>\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=\"Creating_a_Twilio_Trial_Account\">Creating a <em>Twilio<\/em> Trial Account<\/span><\/h1>\n<p>You can signup 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>. After you create an account, you can sign in and open the <b><em>Twilio<\/em><\/b> <b>Console Dashboard<\/b>. In the <b>Account Summary<\/b> section, you will find the <b>Account SID<\/b> and <b>Auth Token<\/b>.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/Screenshot-217.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14214 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/Screenshot-217.png\" alt=\"\" width=\"500\" height=\"240\" \/><\/a><br \/>\nCopy the <b>Account SID<\/b> and <b>Auth Token<\/b> and save for configuring the Twilio channel settings in Kore.ai Bot Builder. You will also need a telephone number for your end users to send text message interactions to for your bot. On the <b>Dashboard<\/b> page, you can scroll down and click Numbers. The <b>Phone Numbers Dashboard<\/b> is displayed. Click <b>Numbers<\/b> on the left navigation menu to display the<b>\u00a0Numbers <\/b>page. Click <span style=\"color: #ff0000\"> Buy a number.<\/span><br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/buy-a-number.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14216 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/buy-a-number.png\" alt=\"\" width=\"500\" height=\"160\" \/><\/a><br \/>\nOn the <b>Get Started with Phone Numbers<\/b> page, click <b>Get your first Twilio phone number.<\/b>\u00a0A dialog is displayed with the phone number you will need to configure the Kore.ai Twilio channel. Click <b>Buy This Number<\/b> to save the number to your account.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/purchase-number-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14221 alignnone\" src=\"\/wp-content\/uploads\/sites\/12\/purchase-number-2.png\" alt=\"\" width=\"500\" height=\"202\" \/><\/a><br \/>\nThe 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.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_medium with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"To add Twilio SMS as a channel, you will need to set up a Programmable SMS app, define the messaging service and then 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 Twilio...","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\/v7-1\/wp-json\/wp\/v2\/posts\/17900","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/comments?post=17900"}],"version-history":[{"count":3,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts\/17900\/revisions"}],"predecessor-version":[{"id":22463,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts\/17900\/revisions\/22463"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/media?parent=17900"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/categories?post=17900"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/tags?post=17900"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}