Para el uso de la API de Clickfono en aplicaciones que requieren, o se benefician, del uso de la grabación de la llamada mediante un webservice es necesario de un endpoint que pueda entregar el audio (archivo) de llamada.
Este documento explica el dicho endpoint, con sus parámetros y salidas esperables.
El servicio se trata de un procedimiento remoto que se invoca a través de HTTP, por método GET.
Éste recibe como parámetro el UUID que identifica la llamada al ser pedida a través de la API de llamados de Clickfono. La interfaz sería la siguiente:
| URL | https://clickandtalk.medularis.com/recordings/{uuid} |
| Método | GET |
| Parámetros | uuid: string representando el UUID que identifica la llamada. |
| Headers | SECURITY_TOKEN: API Token Clickfono |
Nota: Si quiere conocer como es el proceso de la generación de security_token
Un ejemplo de invocación, desde consola, es la siguiente:
curl 'https://clickandtalk.medularis.com/recordings/cc97f690180049f8e0b7cb57bc4d856b' -H 'Security-Token: MI_TOKEN'
200 OK:
La respuesta es un binario en formato WAV que es la grabación del último intento de la llamada segun su uuid
Contiene la siguiente información en los headers
Content-Disposition: inline; filename="cc97f690180049f8e0b7cb57bc4d856b.wav" Content-Length: 209324 Content-Transfer-Encoding: binary Content-Type: audio/x-wav
| Status HTTP | 404 |
| La llamada identificada por el UUID no fue encontrada |