{"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-22T10:17:59","modified_gmt":"2021-03-22T10:17:59","slug":"adding-the-sms-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v8-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>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\/18\/screen-1-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14206 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/screen-1-1.png\" alt=\"\" width=\"500\" height=\"207\" \/><\/a><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/18\/screen-1-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14207 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/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\/18\/2-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14208 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/2-1.png\" alt=\"\" width=\"500\" height=\"213\" \/><\/a><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/18\/3-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14212 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/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\/18\/4-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14209 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/4-2.png\" alt=\"\" width=\"500\" height=\"375\" \/><\/a><\/li>\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\/18\/5-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14211 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/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<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>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\/18\/Screenshot-226.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14213 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/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<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>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\/18\/Screenshot-217.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14214 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/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\/18\/buy-a-number.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14216 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/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\/18\/purchase-number-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-14221 alignnone\" src=\"\/wp-content\/uploads\/sites\/18\/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.<br \/>\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><\/li>\n<\/ol>\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\/v8-1\/wp-json\/wp\/v2\/posts\/17900","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/comments?post=17900"}],"version-history":[{"count":4,"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/posts\/17900\/revisions"}],"predecessor-version":[{"id":27129,"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/posts\/17900\/revisions\/27129"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/media?parent=17900"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/categories?post=17900"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v8-1\/wp-json\/wp\/v2\/tags?post=17900"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}