https://api.movidesk.com/public/v1

  URL:    /asterisk_startTransferedCall
  Methods: GET

  URL:    /asterisk_completedCall
  Methods: GET

  URL:    /asterisk_startCanceledCall
  Methods: GET

  URL:    /setMadeCallLink
  Methods: POST

   *UTC: Coordinated Universal Time (from English Universal Time Coordinated) is the reference time zone from which all other time zones in the world are calculated. E.g., if your time zone is Brasilia (UTC-03:00) and the current time is 15:30, the UTC time will be 18:30.

To access the data, it is necessary to first generate a key for the API

To generate an API key (token), go to Movidesk, navigate to Settings / Account / Parameters, and in the environment tab click the "Generate new key" button if you don't already have one created.
You can repeat this operation whenever you want to generate a new access key, but remember that generating a new key will cause all programs using the old key to stop working.

Flows that should be followed 

Happy scenario 

Central receives a phone call ->  Central transfers the call to the agent's extension and makes an API call to the asterisk_startTransferedCall method -> Movidesk automatically opens a screen for call control for the agent to whom the call was transferred -> Central identifies that the call has ended and makes an API call to the asterisk_completedCall  method -> Movidesk automatically closes the screen that was open for the agent and performs the necessary procedures on the generated/associated ticket for the call.

Transferred call

GET: https://api.movidesk.com/public/v1/asterisk_startTransferedCall?token=155cac97-f203-4bb8-86e1-aa4cb8781f3e&queueId=1&clientNumber=4733990777&id=3&branchLine=5252&callDate=2018-5-1T17:00:00&transferDate=2018-5-1T17:02:00

          Response: Status 200. At this moment, the call will appear in Movidesk in the ongoing call queue, and the call control screen will automatically appear for the agent with the provided extension (in the example, 5252).

Completed call

GET: https://api.movidesk.com/public/v1/asterisk_completedCall?token=155cac97-f203-4bb8-86e1-aa4cb8781f3e&id=3&link=https://www.linkdagravacaodachamada.com.br&completedDate=2018-5-1T17:20:00

          Response: Status 200. At this moment, the call will be removed from Movidesk's queues, and the call control screen will be automatically closed. The action with the call recording will be added to the ticket related to the call.

Alternative scenario

1. Central receives a phone call -> Central considers the call as canceled/abandoned and makes an API call to the asterisk_startCanceledCall method -> Movidesk automatically generates a ticket with the origin of the canceled call and generates an action on the ticket with the call description. 

Cancelled/Abandoned call

GET: https://api.movidesk.com/public/v1/asterisk_startCanceledCall?token=155cac97-f203-4bb8-86e1-aa4cb8781f3e&queueId=1&clientNumber=4733990777&id=3&callDate=2018-5-1T17:00:00&canceledDate=2018-5-1T17:20:00

          Response: Status 200. This method should be called when the client cancels/abandons the call before it is actually transferred to the agent. In this case, a ticket with the origin of the canceled call will be automatically generated, and an action containing the respective information will be created.

try
{ 

   var response = await SendAsync("https://api.movidesk.com/public/v1/asterisk_startTransferedCall?
                                   token=YOURTOKEN&queueId=1&clientNumber=4733990777&id=3&branchLine=5252&callDate=2018-5-1T17:00:00&transferDate=2018-5-1T17:02:00",
                                   NULL, "GET", "application/json");
 
}
catch (WebException ex)
{
 var response = new StreamReader(ex.Response.GetResponseStream()).ReadToEnd();
}

public static async Task<string> SendAsync(string uri, string content, string method, string contentType)
{
 var req = WebRequest.Create(uri);
 req.ContentType = contentType;
 req.Method = method;

 using (var stream = await req.GetRequestStreamAsync())
 using (var streamWriter = new StreamWriter(stream))
 {
    await streamWriter.WriteAsync(content);
 }

 var httpResponse = (HttpWebResponse)await req.GetResponseAsync();
 using (var stream = httpResponse.GetResponseStream())
 {
   if (stream == null)
   return null;

   using (var streamReader = new StreamReader(stream))
   { 
     return await streamReader.ReadToEndAsync();
   }
 }
}