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

  URL:    /asterisk_startTransferedCall
  Métodos: GET

  URL:    /asterisk_completedCall
  Métodos: GET

  URL:    /asterisk_startCanceledCall
  Métodos: GET

  URL:    /setMadeCallLink
  Métodos: POST

   *UTC: El Tiempo Universal Coordinado (del inglés Universal Time Coordinated) es la zona horaria de referencia a partir de la cual se calculan todas las demás zonas horarias del mundo. Ej: Si tu zona horaria es la de Brasilia (UTC-03:00) y la hora actual es 15:30, la hora UTC será 18:30.

Para acceder a los datos, es necesario que previamente se genere una clave para la API

Para generar una clave para la API (token), accede a Movidesk, ve a Configuración / Cuenta / Parámetros y en la pestaña de entorno haz clic en el botón "Generar nueva clave" si aún no tienes una creada.
Puedes repetir esta operación siempre que desees generar una nueva clave de acceso, pero recuerda que al generar una nueva clave, todos los programas que utilicen la clave antigua dejarán de funcionar.

Flujos que deben seguirse 

Escenario feliz 

Central recibe llamada telefónica ->  Central transfiere la llamada a la extensión del agente y realiza una llamada API al método asterisk_startTransferedCall -> Movidesk abre automáticamente una pantalla para el control de la llamada telefónica para el agente al que se transfirió la llamada -> Central identifica que la llamada ha terminado y realiza una llamada API al método asterisk_completedCall -> Movidesk cierra automáticamente la pantalla que estaba abierta para el agente y realiza los trámites necesarios en el ticket generado/asociado a la llamada.

Llamada transferida

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

          Respuesta: Estado 200. En este momento, la llamada aparecerá en Movidesk en la cola de llamadas en curso y la pantalla para el control de llamadas aparecerá automáticamente para el agente con la extensión informada (en el ejemplo, 5252).

Llamada finalizada

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

          Respuesta: Estado 200. En este momento, la llamada saldrá de las colas de Movidesk y la pantalla para el control de llamadas se cerrará automáticamente. Se añadirá la acción con la grabación de la llamada en el ticket correspondiente a la llamada.

Escenario alternativo

1. Central recibe llamada telefónica -> Central considera la llamada como cancelada/abandonada y realiza una llamada API al método asterisk_startCanceledCall -> Movidesk genera automáticamente un ticket con origen de llamada cancelada y genera una acción en el ticket con la descripción de la llamada. 

Llamada cancelada/abandonada

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

          Respuesta: Estado 200. Este método debe ser llamado cuando el cliente cancele/abandone la llamada antes de que sea efectivamente transferida al agente. En este caso, se generará automáticamente un ticket con el origen de la llamada cancelada y con una acción que contiene la información respectiva.

try
{ 

   var response = await SendAsync("https://api.movidesk.com/public/v1/asterisk_startTransferedCall?
                                   token=SEUTOKEN&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();
   }
 }
}