Skip to main content
The sip:request verb is used to send a SIP INFO, NOTIFY, or MESSAGE request on an established call, which is an in-dialog request. This verb allows an application to send SIP messages during a call, such as transmitting metadata to the calling SIP endpoint using a SIP INFO message.
{
  "verb": "sip:request",
  "method": "INFO",
  "headers": {
    "X-Metadata": "my sip metadata"
  },
  "actionHook": "/info"
}

Configuration

The full set of configuration parameters:
ParameterDescriptionRequired
methodThe SIP method, which should be one of INFO, MESSAGE, or NOTIFY.Yes
headersAn object that holds headers (key-value pairs) to include in the SIP request.No
bodyThe body of the SIP request.No
actionHookA webhook to receive an HTTP POST when the SIP request has completed.No

Send Nested Objects

To send a nested object, use a string JSON notation of an object. For example:
{
"infoObject": "{\"objectLevel1\": {\"objectLevel2\": {\"objectLevel3\": \"stringValue\"}}}"
}
To send a nested object in the body, include a Content-Type header with the value application/json. Then, in the body value, use a string notation of a JSON object.
I