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 quieres conocer como es el proceso de la generación del API Token Clickfono
Un ejemplo de invocación, desde consola, es la siguiente:
curl 'https://clickandtalk.medularis.com/recordings/cc97f690180049f8e0b7cb57bc4d856b' -H 'Security-Token: MI_TOKEN'
Status HTTP: 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-wavStatus HTTP: 400 Not FoundPosibles razones:
- La llamada identificada por el UUID no fue encontrada. Esto se debe a que la llamada no existe, ya que se almacena según los días de grabación contratados en el plan.
- El Api Token de ClickFono, utilizado no existe.