Voice

Reject

View as Markdown

The <Reject> verb rejects a call to your SignalWire number. It is effectively an exit statement from the current document, as there is no way to return to any instructions listed after the <Reject> verb.

Verb attributes

reason
stringDefaults to rejected

The reason attribute takes in the following values: busy and rejected. These values specify what message is to be played when SignalWire rejects a call. If this value is set to busy, the caller receives a busy signal and the call is terminated with the status busy. If this value is set to rejected, the call is terminated with the status no answer.

Nesting

No other verbs can be nested within <Reject> and you cannot nest <Reject> within any other verbs.

Examples

A simple rejection of a call

1<?xml version="1.0" encoding="UTF-8"?>
2<Response>
3    <Reject />
4</Response>

SignalWire will reject the call and the caller will receive a standard “This number is not in service” response.

Busy signal rejection

1<?xml version="1.0" encoding="UTF-8"?>
2<Response>
3    <Reject reason="busy" />
4</Response>

SignalWire will reject the call and the caller will receive a busy signal.