WaitForCondition()

Since 16.20.0, 18.6.0 Applications

Wait (sleep) until the given condition is true.

Last reviewed 2026-04-14

WaitForCondition(replacementchar,expression[,timeout,interval])

Dialplan Builder -- build your WaitForCondition() command

replacementchar

Specifies the character in the expression used to replace the `$` character. This character should not be used anywhere in the expression itself.

expression

A modified logical expression with the `$` characters replaced by *replacementchar*. This is necessary to pass the expression itself into the application, rather than its initial evaluation.

timeout (optional)

The maximum amount of time, in seconds, this application should wait for a condition to become true before dialplan execution continues automatically to the next priority. By default, there is no timeout.

interval (optional)

The frequency, in seconds, of polling the condition, which can be adjusted depending on how time-sensitive execution needs to be. By default, this is 0.05.

Full arguments reference

replacementchar required - Specifies the character in the expression used to replace the $ character. This character should not be used anywhere in the expression itself.
expression required - A modified logical expression with the $ characters replaced by replacementchar. This is necessary to pass the expression itself into the application, rather than its initial evaluation.
timeout - The maximum amount of time, in seconds, this application should wait for a condition to become true before dialplan execution continues automatically to the next priority. By default, there is no timeout.
interval - The frequency, in seconds, of polling the condition, which can be adjusted depending on how time-sensitive execution needs to be. By default, this is 0.05.

Description

Waits until expression evaluates to true, checking every interval seconds for up to timeout. Default is evaluate expression every 50 milliseconds with no timeout.

Wait for condition dialplan variable/function to become 1 for up to 40 seconds, checking every 500ms

same => n,WaitForCondition(#,#["#{condition}"="1"],40,0.5)

Sets WAITFORCONDITIONSTATUS to one of the following values:

WAITFORCONDITIONSTATUS
- TRUE - Condition evaluated to true before timeout expired.
- FAILURE - Invalid argument.
- TIMEOUT - Timeout elapsed without condition evaluating to true.
- HANGUP - Channel hung up before condition became true.

Arguments

replacementchar required - Specifies the character in the expression used to replace the $ character. This character should not be used anywhere in the expression itself.
expression required - A modified logical expression with the $ characters replaced by replacementchar. This is necessary to pass the expression itself into the application, rather than its initial evaluation.
timeout - The maximum amount of time, in seconds, this application should wait for a condition to become true before dialplan execution continues automatically to the next priority. By default, there is no timeout.
interval - The frequency, in seconds, of polling the condition, which can be adjusted depending on how time-sensitive execution needs to be. By default, this is 0.05.

User Notes

Know a tip or gotcha for this topic? Share it below and help others.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.