Calls and phone
Transfer a live call
Transfers a live call to a teammate with to_user_id, to a queue with to_queue_id, or back to its originating queue with to_callers_queue. The caller stays on the line while the new target rings. ticket names the ticket the call belongs to.
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
Response
OK
Example
{ "ticket_id": "b1e8bf6f-7f06-4c91-96dd-a1eb7abe504b", "to_name": "Brian Otieno", "kind": "billing"}FieldTypeDescription
ticket_idstring (uuid) | nullThe id of the ticket this is about.to_namerequiredstringThe name of the person receiving it.kindrequiredstringWhat kind it is.curl -X POST "https://api.sautidesk.com/v1/desk/calls/transfer" \ -H "Content-Type: application/json" \ -d '{ "to_user_id": "00000000-0000-0000-0000-000000000000", "ticket": "TCK-4471" }'