Files
next-static-site/markdown/docs/webhooks/dequeue.md
T
Dave Horton c07a37d64a Verb/config (#32)
* add config verb

* more docs

* minor

* more docs

* add some properties to gather

* additional gather options

* more gather opts

* add support for dtmf verb

* 0.7.4 release notes

* dial referHook details
2022-03-18 15:58:34 -04:00

37 lines
1.6 KiB
Markdown

# dequeue
The `dequeue` verb removes the a call from the front of a specified queue and bridges that call to the current caller.
```json
{
"verb": "dequeue",
"name": "support",
"beep": true,
"timeout": 60
}
```
You can use the following options in the `dequeue` command:
| option | description | required |
| ------------- |-------------| -----|
| name | name of the queue | yes |
| actionHook | A webhook invoke when call ends. If no webhook is provided, execution will continue with the next verb in the current application. <br/>See below for specified request parameters.| no |
| beep | if true, play a beep tone to this caller only just prior to connecting the queued call; this provides an auditory cue that the call is now connected | no |
| timeout | number of seconds to wait on an empty queue before returning (default: wait forever) | no |
<!--
| confirmHook | A webhook for an application to run on the callee's end before the call is bridged. This will allow the application to play an informative message to a caller as they leave the queue (e.g. "your call may be recorded") | no |
-->
The *actionHook* webhook will contain a `dequeueResult` property indicating the completion reason:
- 'hangup' - the bridged call was abandoned while listening to the confirmHook message
- 'complete' - the call was successfully bridged and ended with a caller hangup
- 'timeout' - no call appeared in the named queue during the timeout interval
- 'error' - a system error of some kind occurred
<p class="flex">
<a href="/docs/webhooks/config">Prev: config</a>
<a href="/docs/webhooks/dial">Next: dial</a>
</p>