Page tree
Skip to end of metadata
Go to start of metadata


The sched_hangup application allows you to schedule a hangup action for a call, basically to limit call duration.

 Click here to expand Table of Contents

Recipe 1

Before you call bridge add another action that executes the sched_hangup application.

So to make the call last 1 minute and end with cause SWITCH_CAUSE_ALLOTTED_TIMEOUT (which happens to be the default so you can omit it unless you need another cause.)

Also if you omit the '+' character the value will be considered the absolute epoch time you wish the call to end.

Once a call is already up you can do it from the sched_hangup API command from XML-RPC or the command CLI.

Do a show channels to get the uuid of the call then enter.

All the params besides uuid have the same meaning as the dialplan app.

Recipe 2

If you follow recipe 1 and your dialplan looks like:

you will execute hangup exactly 60 seconds after calling sched_hangup. This means 60 seconds including call setup time. For example, if remote side answers the call 15 seconds after phone starts ringing there will be 45 seconds left for the actual conversation.

If you want to ensure 60 seconds of '''talk''' time, schedule hangup at the moment of answering:

If your a-leg call has already been answered, e.g. with an IVR and you want to limit on the B-leg, then use: ''note: api_on_answer, not execute_on_answer''

See also


  • No labels