Verbs

SIP Request

Sends a SIP INFO, NOTIFY, or MESSAGE request during a call.

1{
2  "verb": "sip:request",
3  "method": "INFO",
4  "headers": {
5    "X-Metadata": "my sip metadata"
6  }
7  "actionHook": "/info"
8}

Parameters

method
stringRequired

SIP method, should be one of INFO, MESSAGE, or NOTIFY.

actionHook
string

A webhook to call when the SIP request has completed.

body
string

The body of the SIP request, if any.

headers
object

An object containing headers (key-value pairs) to include with the SIP request.

The sip:request verb completes when a response is received from the far end.

actionHook properties

The actionHook provides the status code of the sip response:

  • result: ‘success’ or ‘failed’
  • sipStatus: sip status code of response
  • err: error message, in the case of failure