<Reject>
TL;DR
<Reject> the voice application execution.
Need Help? Let's Talk
Join our Discord community - we're here to help.
Description
The <Reject> verb rejects an incoming call, possibly with a custom "reason code".
Example
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Reject />
</Response>
Attributes
The following attributes are supported:
| Attribute Name | Allowed Values | Default Value |
|---|---|---|
reason | rejected, busy, congestion, failed | rejected |
This verb is useful when connecting an inbound SIP trunk to the Cloudonix platform, to filter out specific incoming calls that should not be handled, according to parameters sent in The Voice Application Runtime Request.
Attribute: reason
The rejection reason to send to the caller and record in the session's call data record.
The following table lists, for each reason value, what specific SIP response code will be sent to a caller
that was connected to the Cloudonix platform using a SIP trunk:
| Reason | SIP response code | Description |
|---|---|---|
rejected | 486 Busy Here | The caller has actively rejected the call - similar to pressing the hangup button on an incoming call in a cellular phone |
busy | 486 Busy Here | The caller is already engaged in a call and cannot take a new call |
congestion | 500 Internal Server Error | The call cannot be taken due to a failue in the application |
failed | 603 Declined | The call is rejected due to insufficient credit balance or a similar reason |