Make a Call with the Twinned Phone


This requests let the PBX initiate a call between the twinned phone and a requested phone number. The call is processed as follows:

  1. the client app use this request to specify the phone number to call.

  2. the PBX calls the client’s twinned phone.

  3. when the twin answers: the PBX dials the requested phone number and bridges the two calls.

The app must register the phone before making a call (see Device Registration). The registered device must have a twinned phone number (see Twin Number).

Resource

POST /me/device/twin_call

Parameters

None

Payload

The phone number the client request to call.

Context

Authorization

User

Device Registration

Device with a twinned phone number.

Errors

HTTP code Xelion code Description

400

10200

no phone number is specified.

10202

failed to decode the phone number.

10050

No device is registered with the session.

10053

No twin phone number is registered with the device.

=== Example

.Request POST https://xelion.nl/api/v1/master/me/device/twin_call

.Payload [source,json] …​. "0650005000" …​.