Para el uso de la API de ClickFono en aplicaciones que requieren, o se benefician, del uso de la información completa sobre la llamada mediante un webservice. Para esto es necesario de un endpoint que pueda entregar dicha informado.
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/calls/{call_uuid}/info |
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/calls/cc97f690180049f8e0b7cb57bc4d856b/info'
-H 'Security-Token: MI_TOKEN'
Status HTTP | 200 |
La llamada identificada por el UUID fue encontrada |
La respuesta es en formato JSON, acompañada de la información respecto a la llamada consultada
Ejemplo de respuesta:
{
"status": "Conectada",
"call_number_company": "56223456789",
"retry": "3",
"duration_company": "117",
"duration_customer": "95",
"call_at": "2019/04/02 10:05:03 -0300",
"enqueued": false,
"popup_id": 7427,
"popup_name": "Pruebas Clickfono",
"additionals": {
"Nombre": "Juan Perez",
"Rut": "11.111.111-1"
},
"caller_number": "+56987654321"
}
Status HTTP | 401 |
El token utilizado no es válido |
Status HTTP | 404 |
La llamada identificada por el UUID no fue encontrada |