{"id":6855,"date":"2026-08-27T10:28:49","date_gmt":"2026-08-27T08:28:49","guid":{"rendered":"https:\/\/help.ino.cx\/?post_type=ht_kb&p=6855"},"modified":"2026-08-27T10:28:49","modified_gmt":"2026-08-27T08:28:49","slug":"speech-recognition-set-it-up","status":"publish","type":"ht_kb","link":"https:\/\/help.ino.cx\/index.php\/help-center\/speech-recognition-set-it-up\/","title":{"rendered":"Speech recognition – Set it up"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

[Reading time: 6 minutes]<\/em><\/p>\n\n\n\n

This article explains how to create speech recognition dictionaries<\/strong> in the Maker and how to use them in a voice smart routing to route a call according to the word your customer says. For the full list of actions available in a voice smart routing, see Voice smart routing actions<\/a><\/strong>.<\/em><\/p>\n\n\n\n

Overview<\/h2>\n\n\n\n

Speech recognition<\/strong> lets you ask a question over the phone and understand the spoken answer, instead of asking your customer to press a key.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

You first prepare a\u00a0dictionary<\/strong>, meaning the list of words you accept as an answer (for example: invoice, delivery, repair). Then, in a voice smart routing, you add the\u00a0Speech recognition (ASR)<\/strong>\u00a0action and select that dictionary. During the call your customer speaks, the\u00a0reference<\/strong>\u00a0of the recognized word is stored in a variable, and you use it for the rest of the journey.<\/p>\n\n\n\n

Configuration is done in the Maker, under Toolbox > Speech recognition<\/strong>.<\/p>\n\n\n\n

Note:<\/em>\u00a0Only available in France<\/strong>.<\/em><\/p>\n\n\n\n

1. Prerequisites<\/h2>\n\n\n\n

To create and use dictionaries you need:<\/p>\n\n\n\n

    \n
  • a\u00a0Smart<\/strong>\u00a0licence;<\/li>\n\n\n\n
  • the\u00a0Speech recognition<\/strong>\u00a0rights enabled on your role. They are set on the\u00a0role<\/strong>, not on the user profile: open the role, go to the\u00a0Toolbox<\/strong>\u00a0part and look for\u00a0Speech recognition<\/strong>\u00a0in the list. The on\/off button grants read access, then you tick the rights you want:\u00a0Modification<\/strong>,\u00a0Creation<\/strong>,\u00a0Deletion<\/strong>\u00a0and\u00a0Export<\/strong>;\"\"<\/li>\n\n\n\n
  • a\u00a0voice smart routing<\/strong>, since the\u00a0Speech recognition (ASR)<\/strong>\u00a0action only exists on that type of smart routing.<\/li>\n<\/ul>\n\n\n\n

    2. Creating a dictionary and its keywords<\/h2>\n\n\n\n

    2.1. The dictionary<\/h3>\n\n\n\n
      \n
    1. Go to\u00a0Toolbox > Speech recognition<\/strong>.<\/li>\n\n\n\n
    2. Click\u00a0Create<\/strong>: the\u00a0New dictionary<\/strong>\u00a0form opens.<\/li>\n\n\n\n
    3. Fill in the fields, then save with\u00a0Add the dictionary<\/strong>. The message\u00a0“The dictionary has been successfully created.”<\/em>\u00a0confirms it.<\/li>\n<\/ol>\n\n\n\n

      The available fields are:<\/p>\n\n\n\n

        \n
      • Name<\/strong>: the dictionary name (required, 255 characters maximum).<\/li>\n\n\n\n
      • Reference<\/strong>: required, 45 characters maximum. It fills in on its own from the name, in capitals and without accents, and you can change it. It must be unique and contain only letters, digits and the characters\u00a0_ + . @ –<\/strong>.<\/li>\n<\/ul>\n\n\n\n
        \"\"<\/figure>\n\n\n\n

        2.2. The keywords<\/h3>\n\n\n\n

        An empty dictionary cannot work: it needs at least one keyword.<\/p>\n\n\n\n

          \n
        1. Click the dictionary name to open it.<\/li>\n\n\n\n
        2. Click\u00a0Create<\/strong>: the\u00a0New keyword<\/strong>\u00a0form opens.<\/li>\n\n\n\n
        3. Fill in the fields, then save with\u00a0Add the keyword<\/strong>.<\/li>\n<\/ol>\n\n\n\n

          The available fields are:<\/p>\n\n\n\n

            \n
          • Name<\/strong>: the keyword name, so you can find it in the list (required, 255 characters maximum).<\/li>\n\n\n\n
          • Pronunciation of the word<\/strong>: this is what is listened for during the call (required, 45 characters maximum). Write the word the way it sounds, with spelling mistakes if needed. Unaccented letters and spaces only.<\/li>\n\n\n\n
          • Reference<\/strong>: this is the value stored in your variable when the word is recognized (required, 45 characters maximum). It fills in on its own from the name and stays editable.<\/li>\n\n\n\n
          • Alias<\/strong>: optional, used for statistics (45 characters maximum). Letters, digits, spaces and the 3 characters\u00a0_ . –<\/strong>.<\/li>\n<\/ul>\n\n\n\n

            The keyword list then shows the columns Name<\/strong>, Pronunciation of the word<\/strong>, Code<\/strong> (the keyword reference) and Alias<\/strong>.<\/p>\n\n\n\n

            Note: the Pronunciation of the word<\/strong> is used to listen, the Reference<\/strong> is used to decide. For a keyword named “Invoice”, you can write invoice as the pronunciation and keep INVOICE as the reference: INVOICE is what you will test later in your smart routing.<\/em><\/p>\n\n\n\n

            \"\"<\/figure>\n\n\n\n
            \"\"<\/figure>\n\n\n\n

            3. Using a dictionary in a smart routing<\/h2>\n\n\n\n

            3.1. Adding the action and choosing what to recognize<\/h3>\n\n\n\n

            In your voice smart routing version, add the Speech recognition (ASR)<\/strong> action, then fill in its form. The I want<\/strong> field offers three possibilities:<\/p>\n\n\n\n

              \n
            • to use a dictionary<\/strong>: you pick the dictionary from the list, in the\u00a0Dictionary<\/strong>\u00a0field;<\/li>\n\n\n\n
            • to use dictionary with its reference<\/strong>: you type the\u00a0Dictionary reference<\/strong>, handy when the reference comes from a variable;<\/li>\n\n\n\n
            • to recognize “yes” \/ “no”<\/strong>: there is no dictionary to prepare. Recognition is done on yes and no in the language of the interaction, and the variable receives the matching value, for example\u00a0yes<\/em>\u00a0or\u00a0no<\/em>\u00a0for a call in English.<\/li>\n<\/ul>\n\n\n\n

              Note: the form displays this warning, which applies here too: “Warning: If the corresponding entity is deleted or if its reference is modified, this action will no longer work.”<\/em><\/p>\n\n\n\n

              \"\"<\/figure>\n\n\n\n

              3.2. Storing the result in a variable<\/h3>\n\n\n\n

              Choose the Variable<\/strong> and the Field<\/strong> that will receive the result. The form spells it out: “in which to insert the CODE of the recognized dictionary word”<\/em>. So it is the reference of the recognized keyword<\/strong> that is stored, not the spoken word.<\/p>\n\n\n\n

              3.3. What the person on the phone experiences<\/h3>\n\n\n\n

              When the call reaches the action, a beep<\/strong> is played to signal that your customer can speak. The recording stops on its own after 2 seconds of silence<\/strong>, and lasts 5 seconds at most<\/strong>.<\/p>\n\n\n\n

              3.4. The action output branches<\/h3>\n\n\n\n

              The action offers four output branches to connect in your smart routing:<\/p>\n\n\n\n

              Output branch<\/th>When it is taken<\/th><\/tr>
              Recognized<\/strong><\/td>A keyword from the dictionary was recognized. Its reference is stored in the chosen variable.<\/td><\/tr>
              Unrecognized<\/strong><\/td>The person spoke, but the word was not recognized with enough certainty.<\/td><\/tr>
              Error<\/strong><\/td>The recognition could not be completed.<\/td><\/tr>
              Reference not found<\/strong><\/td>The requested dictionary cannot be found, for example because it was deleted or because the reference does not exist.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

              Always plan what happens on Unrecognized<\/strong>, for instance a second attempt or a transfer to an advisor.<\/p>\n\n\n\n

              4. Speech recognition in surveys<\/h2>\n\n\n\n

              You can also collect a spoken answer in a survey, without creating a dictionary.<\/p>\n\n\n\n

              On a Multiple choice question<\/strong> or a Yes\/no question<\/strong>, the Input type<\/strong> field offers:<\/p>\n\n\n\n

                \n
              • Numeric keys<\/strong>: the person presses a key;<\/li>\n\n\n\n
              • Speech recognition<\/strong>: the person answers out loud. On a multiple choice question, recognition is done by a number from 0 to 9; on a yes\/no question, it is done by Yes\/No.<\/li>\n<\/ul>\n\n\n\n

                5. Managing your dictionaries<\/h2>\n\n\n\n

                5.1. Searching and duplicating<\/h3>\n\n\n\n

                The list search is carried out on the name<\/strong> and the reference<\/strong> of the dictionary. From the Options<\/strong> menu on a row, Duplicate<\/strong> saves you from typing an existing dictionary or keyword again.<\/p>\n\n\n\n

                5.2. Deleting<\/h3>\n\n\n\n

                Deleting a dictionary also deletes all of its keywords<\/strong>, and nothing can be retrieved. You can also select several rows and delete them at once.<\/p>\n\n\n\n

                5.3. Exporting<\/h3>\n\n\n\n

                Export dictionaries<\/strong> launches an export containing the name, the reference and the creation and modification dates. A message confirms the launch, and the file appears in your Exports<\/strong>.<\/p>\n\n\n\n

                5.4. Limits<\/h3>\n\n\n\n

                Depending on your offer, the number of dictionaries and the number of keywords per dictionary can be limited. The counter is displayed on the page.<\/p>\n\n\n\n

                6. Good practices<\/h2>\n\n\n\n

                In the rest of your smart routing, test the keyword\u00a0reference<\/strong>, since that is what is stored in the variable.<\/p>\n\n\n\n

                Add at least one keyword before using a dictionary in a smart routing: an empty dictionary cannot work.<\/p>\n\n\n\n

                Do not change the reference of a dictionary already used in a\u00a0to use dictionary with its reference<\/strong>\u00a0action: the action would no longer find it.<\/p>\n\n\n\n

                Write the pronunciation without accents and the way it sounds, one word per keyword, to avoid confusion between two words that are too close.<\/p>\n","protected":false},"excerpt":{"rendered":"

                [Reading time: 6 minutes] This article explains how to create speech recognition dictionaries in the Maker and how to use them in a voice smart routing to route a call according to the word your customer says. For the full list of actions available in a voice smart routing, see Voice smart routing…<\/p>\n","protected":false},"author":5,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[107],"ht-kb-tag":[],"class_list":["post-6855","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-configuring"],"_links":{"self":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6855","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/comments?post=6855"}],"version-history":[{"count":1,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6855\/revisions"}],"predecessor-version":[{"id":6865,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/6855\/revisions\/6865"}],"wp:attachment":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/media?parent=6855"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=6855"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=6855"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}