Type the Document Description here!


<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = 'https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.11';
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>



<span class="page-title-pdf">How to set up Automatic DTMF Sending</span>



<div class="fb-like" data-href="https://confluence.wildix.com/x/JoEbB" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>


 <div class="lang-box-pdf">
	<div>
		<div class="google-lang">
			<div id="google_translate_element">
			</div>
			<script type="text/javascript">
					function googleTranslateElementInit() {
						new google.translate.TranslateElement({pageLanguage: 'en', includedLanguages: 'de,es,fr,it,nl', autoDisplay: false}, 'google_translate_element');
						}
			</script>
			<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
		</div>
		
		<div class="pdf-button">
			<a href="https://confluence.wildix.com/spaces/flyingpdf/pdfpageexport.action?pageId=68911398" alt="Convert to .pdf" title="Convert to .pdf"><img src="https://confluence.wildix.com/download/attachments/14549012/pdf-button-download-wildix-documentation.png"></a>
		</div>
	</div>
</div>


This Articles describes how to set up automatic DTMF sending for scenarios where  users regularly dial a number that is an IVR.

Created: April 2020

Permalink: https://confluence.wildix.com/x/JoEbB

Introduction

There might be a scenario where your users regularly dial a number that is an IVR.  When doing so, the user likely needs to choose an option from the IVR.  

This custom application describes how to do this in an automated fashion. For instance, the end users could define a speed dial button that includes both the number and the tones that need to be sent to the remote party.  This can even include interdigit timing and tone durations.   

Example use case, a speed dial to a colleague from another company where you dial into their main number, then are prompted to enter the extension of the person you are calling.

Prerequisites

Dialplan

Please find attached Dialplan called “SendDTMFs”.  Download SendDTMFs Dialplan and import it into your system.

Speed dial key

Users can define speed dial keys in Collaboration, see Function keys, or administrators can create speed dial key for users, see WMS Start guide - User preferences.

In this example scenario, we will show how to setup the number to be dialed as well as how to specify some additional DTMF interactions to take place after the call is answered.

The provided Dialplan assumes the following format for the speed dial key:

numberPtones

So, for instance, if a user wants to dial the number 6141234567 and then send extension number 582 via DTMF if the call is answered, the speed dial key should be defined as “6141234567P582”. See screenshot below! 


Speed dial key (Advanced options)

In most cases, the example above is enough to allow the user to set up a speed dial key that would interact with the far end system after being answered. However, when dealing with sending tones (specially if more than one is to be sent), there are a couple of additional things that should be considered:

With the specified speed dial, the system will dial 6141234567, and if answered, tones 582 will be sent using .5 seconds as the inter digit time.  So as you can see, the value you specify after the second P is used as interdigit at 1 tenth of a second; 5 equals .5


With the specified speed dial above, the system will dial 6141234567, and if answered, tones 582 will be sent using .5 seconds as inter digit time and and 200ms as the tone duration.

Enabling the feature

Once a speed dial is configured as needed and the “SendDTMFs” Dialplan procedure has been imported into the system, all you need to do is create a Dialplan that will match the speed dial string and enable the feature before making the call: 


Shown entry (XXXXXX.P.)  in the previous picture was created in "users" Dialplan.

XXXXXX.P.  :This dial pattern will match any string that has at least 7 digits followed by a P and something else after the P. Meaning, this will match the minimum config for the speed dial (numberPtones).

  1. Set -> var -> ${EXTEN} - all needed values are stored in the dialed number (EXTEN variable), so we create a variable called var and set its value to variable EXTEN. Using the most complete mentioned example, 6141234567P582P5P200, var will store it too
  2. Set -> number -> ${SHIFT(var,P)} - the SHIFT function will use P as field separator. We get (and remove) the first item from “var” variable. So, number will be 6141234567 (everything before the first P). Then the “var” variable is equal to 582P5P200 (everything after the first P)
  3. Set -> tones -> ${SHIFT(var,P)} - with SHIFT function, using P as separator, we get (and remove) the first item from var variable again. Since var is 582P5P200 at this point, tones will be 582 (everything before the first P) and var will now be equal to 5P200 (everything after the first P)
  4. Set -> interdigit -> ${SHIFT(var,P)} - with SHIFT function, using P as separator again, we get (and remove) the first item from var variable. Since var is now 5P200, interdigit will be 5 (everything before the first P) and var will now be equal to 200 (everything after the first P). If interdigit was not specified, the default value will be used
  5. Set -> duration -> ${SHIFT(var,P)} - and lastly, with SHIFT function again, using P as separator, we get (and remove) the first item from the string (var). Since var is now JUST 200, SHIFT will return the entire string (200), and assign it to duration. If duration was not specified, the default value will be used
  6. SET => DIAL_OPTIONS => U(SendDTMFs^${tones}^${interdigit}^${duration}) :With this line we are enabling “SendDTMFs” dial plan and passing all needed arguments


<div class="fb-like" data-href="https://confluence.wildix.com/x/JoEbB" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>



<div class="ask-question">
		<div class="text-before-buttons">
			<span style="font-size: 24px; text-align: center;">Not finding the help you need?</span><br>
Join the Facebook group to ask a question!
		</div>
<div class="fb-buttons">
<span style="align: center;"><a href="https://www.facebook.com/groups/wildixtechwizards" target="_blank"><img src="https://manuals.wildix.com/wp-content/uploads/2017/03/facebook_tech-wizards.png" alt="facebook_tech-wizards" width="282" height="80" align="center"/></a></span></div>
	</div>