{"id":18047,"date":"2018-05-18T12:25:08","date_gmt":"2018-05-18T12:25:08","guid":{"rendered":"https:\/\/developer.kore.ai\/v7-3\/?post_type=docs&#038;p=13937"},"modified":"2021-03-26T09:40:53","modified_gmt":"2021-03-26T09:40:53","slug":"ivr-integration","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v7-3\/docs\/bots\/advanced-topics\/ivr-integration\/ivr-integration\/","title":{"rendered":"IVR Integration"},"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 it comes to automating customer interactions, IVR systems have proven to be among the top choices for organizations. But if you are using an Interactive Voice Response (IVR) system for your customer service, odds are you might have encountered these two issues quite often:<\/p>\n<ul>\n<li><strong>Non-Intuitive Interface: <\/strong>IVR systems do not simply let the customers state their need. They make the users go through a plethora of menu options from which to select before finding their intent. Even if they allow users to express their intent at first go, the backend programs can only understand a limited number of phrases.<\/li>\n<li><strong>Static Flows: <\/strong>IVR systems use static call flows that do not align with the nonlinear and contextual nature of human interactions. Take the following example of a customer trying to Book Flight tickets:\n<pre>User: Book me a ticket to NYC\r\nIVR: Sure, for which date?\r\nUser: Wait, will it rain there this Sunday?\r\nIVR: Sorry, I don\u2019t understand the input.<\/pre>\n<p>Conventional IVR system leaves limited room for the users to articulate their requests beyond the rigid program flows.<\/li>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h2><span class=\"ez-toc-section\" id=\"Koreai_IVR_Support\">Kore.ai IVR Support<\/span><\/h2>\n<p>Kore.ai allows you to give a conversational makeover to your IVR system. It lets you build <a href=\"https:\/\/blog.kore.ai\/a-complete-guide-to-chatbots\" rel=\"noopener noreferrer\" target=\"_blank\">chatbots<\/a> with human-like conversation capabilities and integrate them with your existing IVR system, thus taking your organization\u2019s customer service experience to a whole new level.<\/p>\n<p>The following features enable\u00a0 the seamless integration of your Kore.ai Bots with your existing IVR:<\/p>\n<ul>\n<li><b>Native VXML Support<\/b>: Built-in support to parse and generate W3C compliant VXML files.<\/li>\n<li><b>Hybrid integration<\/b>: Flexibility to build use cases or dialogs on the Bots Platform, which can work in-sync with the IVR dialogs.<\/li>\n<li><strong>Discourse Analyzer<\/strong>: Kore.ai\u2019s discourse analyzer helps enterprises generate conversation flows using historical chat or call transcripts. Chat and call transcripts are analyzed using neural network-based machine learning models to identify intents and discourse patterns to fulfill a specific intent. This is an out-of-the-box feature which is in Beta state. Contact our <a href=\"http:\/\/support.kore.ai\">support team<\/a> if you want to try this feature.<\/li>\n<li><b>Granular Call Flow Support<\/b>: Ability to define all the call flow elements such as grammar, prompts, retry and time-out periods. Kore.ai supports call termination handlers, allowing you to end calls or invoke dialogs in case of exceptions.<\/li>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h2><span class=\"ez-toc-section\" id=\"Setting_Up\">Setting Up<\/span><\/h2>\n<p>Setting up IVR integration involves the following three steps:<\/p>\n<ol>\n<li><strong>Configure Bot Settings<\/strong>: Define IVR settings such as transcription options, welcome messages, standard responses and VXML properties<\/li>\n<li><strong>Dialog Definition: <\/strong>Define Dialog by configuring node-specific grammar, prompts, and call flow behavior like time-out, retries.<\/li>\n<li><strong>Channel Setup: <\/strong>Set up authentication, configure WebHook in your IVR system and enable channel.<\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"Bot_Settings\">Bot Settings<\/span><\/h3>\n<h4>Step 1: IVR Settings for a Bot<\/h4>\n<p>As the first step of the integration, you first need to enable the IVR settings for the bot and define the Transcription options and VXML properties. These settings act as the default for the bot. You may override VXML properties defined at the bot level by defining custom values at the node level of the Dialog tasks.<\/p>\n<p><b>To configure IVR settings for the bot<\/b><\/p>\n<ol>\n<li>Open the Bot for which you want to integrate the IVR.<\/li>\n<li>Hover over the Left navigation panel and select <b>Channels<\/b><\/li>\n<li>Locate and click <b>IVR Settings<\/b>. The IVR Panel with <strong>Instructions<\/strong> opens.<\/li>\n<li>From the <strong>Configuration<\/strong> tab,\n<ol>\n<li>You can use <strong>Kore.ai IVR Sandbox<\/strong> for testing your Bot, <a href=\"#ivr-sandbox\">see below for details<\/a>.<br \/>\n<span style=\"text-decoration: underline\">IMP<\/span>: If you save the configuration after associating an app without Enabling IVR Settings, the platform will pre-populate the required settings for Sandbox.<\/li>\n<li>Associate an App with the IVR channel &#8211; either by creating a new one or selecting an existing one.<\/li>\n<li>Use the WebHook URL provided in your external application.<\/li>\n<\/ol>\n<\/li>\n<li>From the <strong>Settings<\/strong> tab set the configurations.\n<div class=\"alert alert-info\"><b>Note<\/b>: The IVR Settings options on Dialog task nodes, Standard Responses, and Welcome Message become visible only when you enable IVR Settings for the bot from here.<\/div>\n<p><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/IVR-Properties-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-22619\" src=\"\/wp-content\/uploads\/sites\/15\/IVR-Properties-1.png\" alt=\"\" width=\"699\" height=\"767\" \/><\/a><\/p>\n<p class=\"note\">If you have <span style=\"text-decoration: underline\">enabled IVR Sandbox<\/span>, the following settings are required by the platform. These will be pre-populated if you <span style=\"text-decoration: underline\">do not <\/span>enable the IVR settings. In case you have enabled the settings, ensure the values are the same as given below, sandbox may not respond as expected if you use different values:<br \/>\n&#8211; Enable Transcription set to <em>Yes<\/em>,<br \/>\n&#8211; transcription engine source set to <em>builtin:speech\/transcribe<\/em>,<br \/>\n&#8211; IVR Data Extraction Key set to <em>userinput<\/em>,<br \/>\n&#8211; ASR Confidence Threshold Key set to <em>userinput.confidence<\/em>,<br \/>\n&#8211; ASR Threshold Confidence set to <em>50<\/em><\/li>\n<li>(Optional) To enable an external transcription engine, under <strong>Enable Transcription<\/strong>, select <b>Yes<\/b>.\n<ul>\n<li>On enabling the transcription engine, a text box appears for entering the source of the transcription engine.\n<div class=\"alert alert-info\"><b>Note<\/b>: Bots Platform supports all UniMRCP-encoded voice-to-text services. Only if you select the Enable Transcription option for the bot, the platform allows you to do away with defining grammar during configuring IVR settings for any node (described in Step 2).<\/div>\n<p><a href=\"#Configuring_Grammar\">See below for detailed configuration for Grammar syntax<\/a>.<\/li>\n<\/ul>\n<\/li>\n<li>Enter the following details to complete the setup:<br \/>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>IVR Data Extraction Key<\/td>\n<td>Specify the syntax to extract the filled data<\/td>\n<\/tr>\n<tr>\n<td>End of Conversation Behavior<br \/>\n(post ver7.1)<\/td>\n<td>\n<p>This property can be used to define the bot behavior at the end of conversation. The options are:<\/p>\n<ul>\n<li>Trigger End of Conversation Behavior and configure the Task, Script or Message to be initiated. <a href=\"\/v7-3\/docs\/bots\/advanced-topics\/event-based-bot-actions\/#End_of_Conversation\" target=\"_blank\" rel=\"noopener noreferrer\">See here for details<\/a>.<\/li>\n<li>Terminate the call.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>Call Termination Handler<\/td>\n<td>Select the name of the Dialog task that you want to use as the call termination handler when the call ends in error.<\/td>\n<\/tr>\n<tr>\n<td>VXML Properties<\/td>\n<td>\n<p>Click <b>Add Property. <\/b>Enter property names and values to use in defining the VXML definition.<\/p>\n<div class=\"alert alert-info\"><b>Note<\/b>: You should these properties and values in the VXML files for all call flows in the IVR system.<\/div>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"2\">ASR Confidence Threshold<\/td>\n<\/tr>\n<tr>\n<td>Threshold Key<\/td>\n<td>This is the variable where the ASR confidence levels are stored. This field is pre-populated, do not change it unless you are aware of the internal working of VXML.<\/td>\n<\/tr>\n<tr>\n<td>Define ASR threshold confidence<\/td>\n<td>In the range between 0 to 1.0 which defines when the IVR system hands over the control to the Bot.<\/td>\n<\/tr>\n<tr>\n<td>Timeout Prompt<\/td>\n<td>Enter the default prompt text to play when the user doesn\u2019t provide the input within the timeout period. If you do not specify a Timeout Prompt for any node, this prompt take its place.<\/td>\n<\/tr>\n<tr>\n<td>Grammar<\/td>\n<td>\n<p>Define the grammar that should be used to detect user\u2019s utterance<\/p>\n<ul>\n<li>The input type can be Speech or DTMF<\/li>\n<li>Source of grammar can be Custom or Link\n<ul>\n<li>For Custom, write VXML grammar in the textbox.<\/li>\n<li>For Link, enter the URL of the grammar. Ideally, the URL should be accessible to the IVR system so that the resource can be accessed while executing the calls at runtime<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><a href=\"#Configuring_Grammar\">See below for detailed configuration for Grammar syntax<\/a>.<br \/>\n<b>Note<\/b>: If the\u00a0<b>Enable Transcription\u00a0<\/b>option is enabled for the bot along with specifying the source of the transcription engine, defining grammar isn\u2019t mandatory.<\/td>\n<\/tr>\n<tr>\n<td>No Match Prompt<\/td>\n<td>Enter the default prompt text to play when user input is not present in the defined grammar. If you do not specify a <em>No Match Prompt<\/em> for any node, this prompt take its place.<\/td>\n<\/tr>\n<tr>\n<td>Barge-In<\/td>\n<td>Select whether you want to allow a user input while a prompt is in progress. If you select no, the user cannot provide input until IVR completes the prompt.<\/td>\n<\/tr>\n<tr>\n<td>Timeout<\/td>\n<td>Select the maximum wait time to receive user input from the drop-down list, from 1 second up to 60 seconds.<\/td>\n<\/tr>\n<tr>\n<td>No. of Retries<\/td>\n<td>Select the maximum number of retries to allow. You can select from just 1 retry up to 10 retries.<\/td>\n<\/tr>\n<tr>\n<td>Log<\/td>\n<td>\n<p>Select <b>Yes <\/b>if you want to send the chat log to the IVR system.<\/p>\n<p>&nbsp;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>Once you have enabled the IVR channel, we recommend configuring the <strong>Welcome Event<\/strong> for IVR Settings. This would play a welcome message for users when they connect to the Bot via the IVR channel.<br \/>\nFor this:<\/p>\n<ol>\n<li>From\u00a0<strong>Natural Language -&gt; Event Handlers<\/strong> configure\u00a0<strong>Welcome Event<\/strong><\/li>\n<li>Select\u00a0<strong>Show Message<\/strong> under\u00a0<strong>Event Configuration<\/strong><\/li>\n<li>Click the <strong>Add IVR Settings<\/strong> button to open the IVR settings window<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/IVR-welcome-event.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-23299\" src=\"\/wp-content\/uploads\/sites\/15\/IVR-welcome-event.png\" alt=\"\" width=\"1366\" height=\"768\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095414\/IVR-welcome-event.png 1366w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095414\/IVR-welcome-event-300x169.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095414\/IVR-welcome-event-1024x576.png 1024w\" sizes=\"auto, (max-width: 1366px) 100vw, 1366px\" \/><\/a><\/li>\n<li>Under the <strong>Initial Prompts<\/strong> text box, enter the message that needs to be played when user connects to the Bot.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/IVR-welcome-event2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-23300\" src=\"\/wp-content\/uploads\/sites\/15\/IVR-welcome-event2.png\" alt=\"\" width=\"694\" height=\"295\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095414\/IVR-welcome-event2.png 694w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095414\/IVR-welcome-event2-300x128.png 300w\" sizes=\"auto, (max-width: 694px) 100vw, 694px\" \/><\/a><\/li>\n<li>For details regarding other configuration fields, refer to the <a href=\"#Dialog_Settings\">Configuring IVR Settings for a Node<\/a> section below.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3 id=\"ivr-sandbox\"><span class=\"ez-toc-section\" id=\"Sandbox_Configuration\">Sandbox Configuration<\/span><\/h3>\n<p><span style=\"text-decoration: underline\">Note<\/span>: This option was introduced in ver 7.1 of the platform. It is not available for on-prem installation.<\/p>\n<p>Kore.ai offers an <strong>IVR Sandbox environment<\/strong> to instantly launch your bot for interactions over voice calls. This is particularly useful when a working IVR system is not feasible or available for testing your Bot over a voice channel. IVR Sandbox is an optional integration and it can coexist with your custom IVR integration.<\/p>\n<p>Enabling this option will give you a Phone Number, Pin, and Secret. You can call your bot by using the phone number and PIN allocated for your bot to develop and test the bot with your teams. On receiving the valid Pin and Secret you will be connected to the Bot for interactions.<\/p>\n<p><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/IVR_sandbox.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-22601\" src=\"\/wp-content\/uploads\/sites\/15\/IVR_sandbox.png\" alt=\"\" width=\"1366\" height=\"768\" \/><\/a><\/p>\n<p>Once enabled you can access the IVR Sandbox interaction details by selecting the\u00a0<strong>Test<\/strong>\u00a0button on hover over the IVR icon from the channels page.<\/p>\n<p><strong>Limitations<\/strong><\/p>\n<ul>\n<li>The platform supports only a limited number of concurrent lines hence calls to your bots via IVR Sandbox may not be responded to at times.<\/li>\n<li>We strongly recommend you use IVR Sandbox only for serving internal testing purposes and not for the end-users of your bots as there might be some functional limitations.<\/li>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3 id=\"config-grammar\"><span class=\"ez-toc-section\" id=\"Configuring_Grammar\">Configuring Grammar<\/span><\/h3>\n<p>You will need to define at least one Speech Grammar to the IVR system.<br \/>\nThere is no default Grammar that will be considered by the system. In this section, we will walk you through the steps needed to configure a Grammar system for the bot to function on the IVR system.<\/p>\n<p>Typically for an IVR enabled bot, the speech utterance of the user will be vetted and parsed by the Grammar syntax at the IVR system before being diverted to the Bot.<\/p>\n<p>Kore.ai supports the following Grammar systems:<\/p>\n<ul>\n<li>Nuance<\/li>\n<li>Voximal<\/li>\n<li>UniMRCP<\/li>\n<\/ul>\n<p>Each one requires their own configuration.<\/p>\n<h4>Nuance<\/h4>\n<p>In case you want to use grammar syntax rules from Nuance Speech Recognition System, you need get a license for the same. Once you register and obtain a license from Nuance, you will be given access to two files &#8211; <strong>dlm.zip<\/strong> &amp; <strong>nle.zip<\/strong>. Ensure that the path to these VXML is accessible to the bot.<\/p>\n<p><strong>Configurations<\/strong>:<\/p>\n<ol>\n<li>Set\u00a0<strong>Enable Transcription<\/strong> to\u00a0<em>no<\/em><\/li>\n<li>In the <strong>Grammar<\/strong> section:\n<ul>\n<li>Select\u00a0<strong>Speech<\/strong> or <strong>DTMF <\/strong>option as per your requirement.<\/li>\n<li>In the text box to define vxml enter the vxml path to dlm.zip file. The url will be of the format: <code>http:\/\/nuance.kore.ai\/downloads\/kore_dlm.zip?nlptype=krypton&amp;dlm_weight=0.2&amp;lang=en-US<\/code><\/li>\n<li>Replace the above path according to your setup<\/li>\n<li>The language code &#8220;<em>lang=en-US<\/em>&#8221; will be based on your setup<\/li>\n<\/ul>\n<\/li>\n<li><strong>Add Grammar<\/strong> to add another path to <code>nle.zip<\/code>. Follow the above-mentioned steps.<\/li>\n<li><strong>Save<\/strong> the settings.<\/li>\n<\/ol>\n<h4>Voximal\/UniMRCP<\/h4>\n<p>In case you want to use grammar syntax rules from Voximal or UniMRCP, you need to specify the transcription source.<\/p>\n<p><strong>Configurations<\/strong>:<\/p>\n<ol>\n<li>Set\u00a0<strong>Enable Transcription<\/strong> to <em>yes<\/em><\/li>\n<li>In the\u00a0<strong>Transcription engine source<\/strong> text box that appears:\n<ul>\n<li>for Voximal, enter <em>&#8220;builtin:grammar\/text&#8221;<\/em><\/li>\n<li>for UniMRCP, enter <em>&#8220;builtin:grammar\/transcribe&#8221;<\/em><\/li>\n<\/ul>\n<\/li>\n<li>You can leave the <strong>Grammar<\/strong> section blank, the above transcription source uri will handle the syntax and grammar vetting of the speech.<\/li>\n<li><strong>Save<\/strong> the settings.<\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"Dialog_Settings\">Dialog Settings<\/span><\/h3>\n<h4>Step 2: Setting Up IVR Settings for Dialog Nodes<\/h4>\n<p>On the IVR Properties panel for a node, you can enter node-specific prompts, grammar, as well as parameters for call-flow behavior such as time-out and retries. If not enabled, you can use the\u00a0<strong>enable<\/strong> button to enable the IVR settings for the Bot and then customize for the specific node.<\/p>\n<p>IVR settings apply only for the following nodes and message types:<\/p>\n<ul>\n<li>Entity Node<\/li>\n<li>Message Node<\/li>\n<li>Confirmation Node<\/li>\n<li>Standard Responses<\/li>\n<li>Welcome Message<\/li>\n<\/ul>\n<div class=\"alert alert-info\"><b>Note<\/b>: Most IVR settings are the same for all nodes, with a few exceptions.<\/div>\n<h5><strong>Configuring IVR Settings for a Node<\/strong><\/h5>\n<p>To configure IVR settings for a node, hover over the node in the Dialog task and click the Settings icon. On the Properties panel, click the IVR icon.<\/p>\n<p><strong>IVR Settings Field Reference<\/strong><br \/>\nThe following sections provide detailed descriptions of each IVR setting, including descriptions, applicability to nodes, default values and other key information.<\/p>\n<ul>\n<li style=\"list-style-type: none\">\n<ul>\n<li><strong>Prompts:\u00a0<\/strong>\n<ul>\n<li>You can enter prompts in one of these formats: Plain text, Script, File location of an audio file. If you want to define JavaScript or attach an audio file, click the icon before the prompt text message box and select a mode. By default, it is set to Text mode.<\/li>\n<li>You can enter more than one prompt messages of different types. You can define their order of sequence by dragging and dropping them.<\/li>\n<li>Multiple prompts are useful in scenarios where the prompt has to be played more than once, to avoid repetition, since the prompts are played in order.<\/li>\n<\/ul>\n<\/li>\n<li><strong>Initial Prompts<\/strong><br \/>\n<em>Apply to: Entity, Confirmation, Message nodes; Standard Responses and Welcome Message<\/em><br \/>\nPrompts that are played when the IVR first executes the node. If you do not enter a prompt for a node, the default user prompt for the node plays by default. If you do not enter a prompt for Standard Responses and Welcome Message, the default Standard Response and Welcome Message are played by default.<\/li>\n<li><strong>Timeout Prompts<\/strong><br \/>\n<i>Apply to: Entity, Confirmation; Standard Responses and Welcome Message<\/i><br \/>\nPrompts that are played on the IVR channel when the user has not given any input within the specified time. If you do not enter a prompt for a node, the default Error Prompt of the node is played. Standard Responses and Welcomes have a default Timeout Prompt that plays if you don&#8217;t define No Match Prompts.<\/li>\n<li><strong>No Match Prompts<\/strong><br \/>\n<i>Apply to: Entity, Confirmation; Standard Responses and Welcome Message<\/i><br \/>\nPrompts that are played on the IVR channel when the user&#8217;s input has not matched any value in the defined grammar. If you do not enter a prompt here or select <b>No Grammar<\/b> option for an Entity or Confirmation node, the default Error Prompt of the node is played. Standard Responses and Welcomes have a default No Match Prompt that plays if you do not enter it.<\/li>\n<li><strong>Error Prompts<\/strong><br \/>\n<i>Apply to: Entity, Confirmation;\u00a0<\/i><br \/>\nPrompts that are played on the IVR channel when user input is invalid Entity type. If you do not enter a prompt here, the default Error Prompt of the node is played.<\/li>\n<li><strong>Grammar<\/strong><br \/>\n<i>Applies to: Confirmation; Standard Responses and Welcome Message<\/i><br \/>\nDefine the grammar that should be used to detect user&#8217;s utterance. You can define one or more grammars for a node.<\/p>\n<div class=\"alert alert-info\"><b>Note<\/b>: If the <b>Enable Transcription <\/b>option is enabled for the bot along with specifying the source of the transcription engine, defining grammar isn\u2019t mandatory.<\/div>\n<p><strong>To define the grammar<\/strong><\/p>\n<ol>\n<li>Select <b>Speech <\/b>or <b>DTMF <\/b>as the input type.<\/li>\n<li>Source of grammar can be <strong>Custom<\/strong> or <strong>Link<\/strong> from the drop-down list\n<ol>\n<li>For Custom, write VXML grammar in the textbox below.<\/li>\n<li>For Link, enter the URL of the grammar. Ideally, the URL should be accessible to the IVR system so that the resource can be accessed while executing the calls at runtime.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<li><strong>Advanced Options<\/strong><br \/>\nThese properties override the properties set in the Bot IVR Settings page.<\/p>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Timeout<\/td>\n<td>Select the maximum wait time to receive user input from the drop-down list, from 1 second up to 60 seconds. The default value is the same as defined in the Bot IVR Settings page.<\/td>\n<\/tr>\n<tr>\n<td>No. of Retries<\/td>\n<td>Select the maximum number of retries to allow. You can select from just 1 retry up to 10 retries.<br \/>\nThe default value is the same as defined in the Bot IVR Settings page.<\/td>\n<\/tr>\n<tr>\n<td>Behavior on Exceeding Retries<br \/>\n(applies only to <span style=\"text-decoration: underline\">entity node<\/span>)<\/td>\n<td>\n<p>Define behavior when either\u00a0the timeout or number of retry attempts exceed the specified limit. Options include:<\/p>\n<ul>\n<li>Invoke CallTermination Handler<\/li>\n<li>Initiate Dialog: Select a Dialog task from the list of bot tasks.<\/li>\n<li>Jump to specific node in current task: Select a node from the list of nodes in the current Dialog task.<\/li>\n<\/ul>\n<p>Post v7.3, this feature has been enhanced so that on exceeding entity error count, the platform will trigger the Behavior on Exceeding Retries behavior, when the transcription is enabled.<\/td>\n<\/tr>\n<tr>\n<td>Barge-In<\/td>\n<td>Select whether you want to allow a user input while a prompt is in progress. If you select no, the user input is not considered until the prompt is completed. The default value is <b>No<\/b>.<\/td>\n<\/tr>\n<tr>\n<td>VXML Properties<\/td>\n<td>Click <b>Add Property. <\/b>Enter property names and values to use in defining the VXML definition. These values defined for a node or a standard response override the global VXML properties defined in the Bot IVR settings page.<\/td>\n<\/tr>\n<tr>\n<td>Log<\/td>\n<td>Select <b>Yes <\/b>if you want to send the chat log to the IVR system. The default value is <b>No<\/b>.<\/td>\n<\/tr>\n<tr>\n<td>Recording<\/td>\n<td>Define the state of recording to be initiated. The default value is <b>Stop<\/b>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><strong>Channel Override<\/strong><br \/>\nYou can write JavaScript code for the prompts in Entity nodes, Standard Messages, and Welcome Message to take full control of the call behavior. In such cases, you should write channel override JavaScript that generates the entire VXML code as the Bots Platform doesn\u2019t append the IVR VXML snippet, but substitutes it with the code you write.<br \/>\nFollow these steps to write channel override for an Entity node:<\/p>\n<ol>\n<li>Hover over the Entity node and click the icon.<\/li>\n<li>UnderUser Prompts or Error Prompts section, click <b>Manage Prompts<\/b> or <b>Manage Errors <\/b>respectively.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/Manage-Prompts.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-13946\" src=\"\/wp-content\/uploads\/sites\/15\/Manage-Prompts.png\" alt=\"\" width=\"496\" height=\"437\" \/><\/a><\/li>\n<li>Click <b>Add Prompt Message.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/Add-Prompt-Message.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-13947\" src=\"\/wp-content\/uploads\/sites\/15\/Add-Prompt-Message.png\" alt=\"\" width=\"1072\" height=\"247\" \/><\/a><\/b><b><br \/>\n<\/b><\/li>\n<li>From the <b>Channels <\/b>drop-down list, select<b> IVR.<\/b><\/li>\n<li>On the Message editor, click <b>JavaScript.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/new-Javascript-prompt-message.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-13948\" src=\"\/wp-content\/uploads\/sites\/15\/new-Javascript-prompt-message.png\" alt=\"\" width=\"1038\" height=\"391\" \/><\/a><\/b><b><br \/>\n<\/b><\/li>\n<\/ol>\n<p>Define JavaScript that generates the entire VXML code, and click <b>Save.\u00a0<\/b><\/p>\n<p>Follow these steps to write channel override for a Standard Response:<\/p>\n<ol>\n<li>Hover over the select Standard Response and select<b> Add Channel Response &gt; IVR<\/b>.<\/li>\n<li>On the Add Channel Overrides window, select the following:\n<ol>\n<li>Channel: IVR<\/li>\n<li>Task and node for which to write the override.<\/li>\n<\/ol>\n<\/li>\n<li>Under the Response editor, click <b>Advanced Mode<\/b> and type the code.<\/li>\n<\/ol>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h3><span class=\"ez-toc-section\" id=\"Channel_Settings\"><span id=\"Channel_Settings\" class=\"ez-toc-section\">Channel\u00a0Settings<\/span><\/span><\/h3>\n<h4>Step 3: Setting Up IVR Channel for the Bot<\/h4>\n<p>After configuring IVR Settings at both the Bot and the Dialog levels, you should configure IVR Channel for the bot. IVR channel provides a generic integration to connect bots with IVR systems. Kore.ai platform generates required VXML files to be exchanged as part of bot interaction with the end user via the IVR systems.<br \/>\n<strong>Enabling IVR Channel and Associating an APP<\/strong><br \/>\nKore.ai Bots require a JWT token to authenticate the incoming requests from IVR. For generating JWT token, you should associate an app with the bot. You can select any of the existing Apps available in your Kore.ai account or create a new app.<\/p>\n<ol>\n<li>Hover over the side navigation panel of the bot and click <b>Channels<\/b>.<\/li>\n<li>On the Channels page, click <b>IVR<\/b>. The IVR Channel Instructions page opens.<\/li>\n<li>Click the <b>Configuration <\/b>tab.<\/li>\n<li>From the Select App drop-down list, select an existing App. If you do not have any app to associate the bot with, click Add.<\/li>\n<li>Copy the following:\n<ol>\n<li><b>WebHook URL: <\/b>For calling the bot from IVR.<\/li>\n<li><b>Client Secret: <\/b>To generate JWT token that must be appended to the WebHook URL.<\/li>\n<\/ol>\n<\/li>\n<li>Select <b>Yes <\/b>for Enable Channel.<\/li>\n<\/ol>\n<p><strong>Generating JWT Token<\/strong><\/p>\n<ol>\n<li>Go to <a href=\"https:\/\/jwt.io\/\">https:\/\/jwt.io\/<\/a> nd scroll down the page to the Decoded section.<\/li>\n<li>Replace the contents in the <strong>Payload<\/strong> box with\n<ul>\n<li>sub &#8211; set to user name or call Id; and<\/li>\n<li>appId &#8211; set to Client ID of the app copied in the previous section<\/li>\n<\/ul>\n<\/li>\n<li>Scroll to <b>Verify Signature<\/b> section. In the Your-256-bit secret placeholder field, enter the copied <b>Client Secret<\/b>.<\/li>\n<li>Click Share JWT. The JWT token gets copied.<\/li>\n<li>JWT has to be passed in the IVR hook URL as value for the query parameter &#8220;token&#8221;:<br \/>\n<code>https:\/\/bots.kore.ai\/ivr\/hooks\/{{botId}}?token={{JWT}}<\/code><\/li>\n<\/ol>\n<p><strong>Calling Bot from IVR Call flow<\/strong><br \/>\nYou can pass data to the bot from the IVR call flow using VXML &lt;subdialog&gt; as shown in the picture below. The subdialog src should be Webhook URL with JWT Token which takes the following parameters as Input<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/last-image.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-13951\" src=\"\/wp-content\/uploads\/sites\/15\/last-image.png\" alt=\"\" width=\"649\" height=\"162\" \/><\/a><\/p>\n<ul>\n<li><em>message<b> : <\/b><\/em>Message from User<\/li>\n<\/ul>\n<ul>\n<li><em>from<\/em>: Unique User&#8217;s Identity Ex: Phone Number<\/li>\n<\/ul>\n<ul>\n<li><em>to<\/em>: Bot Stream Id<\/li>\n<\/ul>\n<p>The <i>endOfConversation<\/i> variable should be processed from the data returned from the sub-dialog. If the value is set to true, it indicates that the dialog execution (conversation) is complete. It can be a triggering point to end the call with the user.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small 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":"When it comes to automating customer interactions, IVR systems have proven to be among the top choices for organizations. But if you are using an Interactive Voice Response (IVR) system for your customer service, odds are you might have encountered these two issues quite often: Non-Intuitive Interface: IVR systems do not simply let the customers...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[32],"tags":[],"class_list":["post-18047","post","type-post","status-publish","format-standard","hentry","category-ivr-integration"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts\/18047","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/comments?post=18047"}],"version-history":[{"count":31,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts\/18047\/revisions"}],"predecessor-version":[{"id":24870,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts\/18047\/revisions\/24870"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/media?parent=18047"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/categories?post=18047"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/tags?post=18047"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}