Skip to main content

Verifying DTMF Output Switching Functionality

Symptomes

The issue occurs when using a DTMF action to switch outputs (forsuch switchingas controlling doors, barriers, etc.) during a call. The expected output switchingswitch doeseither notdoesn't happen,happen or it happens inconsistently.

The output switch may fail if the intercoms are unavailable or busy, (when an allow list is configured) the action may be denied for the called number is blacklisted,number, the specific action (such as calling a script, setting a tag, etc.) configured to be executed after the DTMF action may have failed, and/or network instability maymight also contribute to the problem.issue.

How to Reproduce

Step 1:
 Go to the dashboard and add a control panel for intercom stations if there is not yet one present.isn't already set up.

image.png

Step 2:
 Enter the number you want to make a test call to,to and click the "dial"Dial" button.

 

Step 3:

During the conversationcall, press the DTMF digit that should preformtrigger the configured action.

The configured DTMF action should now be executed.

Cause

Issues with DTMF actions are likely caused by one or more of the following:

  • Intercom unavailability: If the intercom(s) involved in the action are unavailable or busy, the output switching may not occur since a call from this intercom can not be made.

  • Called number is blacklisted:denied: If ana whitelist/allow list is specified for the DTMF action, the called number may not be allowed to preformperform the action when they press the DTMF digit.
  • Script, tag, or other action failed: If an action is configured forto be executed after the DTMF action, this action may have failed.

Solution / How To

1. Check the call history

Navigate to "Intercom / Call History"

image.png

HereHere, you canwill see a list of all calls on the system.

 

If yourthe issue is with a specific intercom or location, you might want tocan filter onby thisthat specific locationintercom or intercom (number).number.

image.png

Open one of the calls where you might suspect the issueissue.

is

For present.
Inexample, this caseif the configured DTMF doesaction notisn't workworking when calling a specific number, than open a call to that number.

 

 

image.png

First to check if the DTMF action was send by the called number we will open the value history for the call and search for a message likelike: the following: "event(press).digit(1)"

 

WhenIf this message is not present, thisit would meanmeans that the user (the called number) did notdidn't press a DTMF digit during the call,digit, or the DTMF digit was pressed but not received due to a network issue.

image.png

After that we will check the logbook for any logs that would indicate an issue.

 

InFor thisexample, caseif Iyou was able to findsee a log message thatlike:
Action indicated that the DTMF action was'a' denied for the'b', calledthis number

(meaningmeans the called number was not found in the configured allow list for the DTMF action).action.

image.png

2. Check the configured action

Navigate to "System / Devices" or "Intercom / Intercom Stations" and open the intercom station where the DTMF action should be configured.

image.png
Open the DTMF action configured for this intercom station.station and ensure it is set up correctly.

image.png

When a DTMF digit is received that matches the configured digit for our action, than the action to execute (such as calling a script, setting a tag, etc.) will be executed.

 

To verify that the action to execute functions correctly, check one of the following articles:

image.png

References

Describe where to find external answers or extra informations

Back to top