Place an outbound call

Places a call to a phone number to from one of your SautiDesk numbers from, optionally on a chosen device. SautiDesk rings the key's person first, then dials the customer once they answer. The person the key acts as must have SautiDesk open (or the app connected) so their phone can ring first; if it is not connected the call is refused with 409 desk.no_device and nothing is dialled. The call opens a ticket for the customer or joins their open one.

Requires: desk.write scope, Converse licence.

Authorization

bearerAuth

AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Request Body

application/json

to*string

Who to send to: a phone number in international format or, for email, an address.

from*string

The number or address to send from. It must belong to your workspace.

device?string

The id of the phone to ring first, from your phone devices list. Leave it out to ring any of your connected phones.

Response

Created

Example

{  "call_id": "5f8fdfd7-274f-478d-9141-184cd8996e3f",  "ticket": {    "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",    "ref": "TCK-4471",    "opened": false  }}

FieldTypeDescription

call_idrequiredstringThe id of the call this nudge is about, if any.

ticketrequiredobjectThe ticket the call belongs to, by id or reference such as TCK-4471.

idrequiredstring (uuid)

refrequiredstring

openedrequiredboolean

curl -X POST "https://api.sautidesk.com/v1/desk/calls" \  -H "Content-Type: application/json" \  -d '{    "to": "+254722145900",    "from": "+254709221566"  }'

Place an outbound call

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response

Authorization

Request Body