mod_dptools: unbind_meta_app
About
Use unbind_meta_app to unbind a key previously bound with bind_meta_app. Takes the key value as its ARG. If no argument (key value) is provided, then ALL keys bound on the channel will be unbound.
Examples
<!-- Unbind a particular key - in this case, 7 (dialing *7 will not trigger any app after this is executed). -->
<action application="unbind_meta_app" data="7"/>
<!-- Unbind ALL keys bound on this channel. -->
<action application="unbind_meta_app" data=""/>
Notes
After bind_meta_app binds a key on a call leg, that binding will exist for the entire life of the call leg - or until unbind_meta_app is used. However, in some instances it may not suffice to perform unbind_meta_app on a particular key - you may want to do unbind_meta_app for ALL keys (provide no argument):
<!-- Unbind ALL keys bound on this channel. -->
<action application="unbind_meta_app" data=""/>
To explain this note, consider the case of a call leg on which bind_meta_app was executed to bind only the digit 7. Later on in the life of the call, the call leg is sent through an IVR. Before placing the call leg into the IVR, unbind_meta_app for key 7 is executed:
<action application="unbind_meta_app" data="7"/>
Although 7 was the only key bound, and now it is unbound, pressing '*' will still tell the system to listen for meta app digit. So, even though unbind_meta_app 7 was executed, pressing '*' will have no effect in the IVR the call leg is now in. To completely turn off the meta app binding mechanism, do:
<action application="unbind_meta_app" data=""/>
BEFORE placing the call leg into an IVR. Then the IVR can correctly detect '*', should you use '*' in your IVR.