API información de listado de llamados y filtrado por parámetros de Clickfono

API información de listado de llamados y filtrado por parámetros de Clickfono


Trasfondo

Para el uso de la API de Clickfono en aplicaciones que requieren, o se benefician, del uso de la información completa sobre listado de llamadas mediante un webservice utilizando parámetros de filtrado. 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.

Invocación

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:

URLhttps://clickandtalk.medularis.com/calls/list
MétodoGET
Parámetros– date: string para filtro de fecha de las llamadas.
– Por defecto dia actual. 
– Formato YYYY-MM-DD
– No requerido.

– Popup_uuid:
– UUID del popup. 
– Por defecto nulo. 
– No requerido.
Headerssecurity-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/list?date=2019-04-02&popup_uuid=14f1cc88-6ce8-11e9-b8f9-001d09ef4aa0' -H 'security-token: MI_TOKEN'

Respuestas

Status HTTP: 200
Entrega información de llamadas en listado por filtros o no aplicados.
La respuesta es en formato JSON, acompañada  de la información respecto a las llamadas consultadas.

Ejemplo de respuesta

[
{
"uuid" :  "a93460bbf8402e15b9b0afddc05d5e8d",
    "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_uuid": "14f1cc88-6ce8-11e9-b8f9-001d09ef4aa0" ,
    "popup_name": "Pruebas Clickfono",
    "additionals": {
"Nombre": "Juan Perez",
      "Rut": "11.111.111-1"
     },
"caller_number": "+56987654321"
},  {
"uuid" :  "d45d347218b49a967a283c7bab360e5b",
"status": "No Conectada",
    "call_number_company": "56223456769",
    "retry": "3",
    "duration_company": "100",
    "duration_customer": "80",
    "call_at": "2019/04/02 11:05:03 -0300",
    "enqueued": false,
    "popup_uuid": "14f1cc88-6ce8-11e9-b8f9-001d09ef4aa0" ,
    "popup_name": "Pruebas Clickfono",
    "additionals": {
"Nombre": "Jorge Tapia",
      "Rut": "11.111.111-1"
},
    "caller_number": "+56987654321"
}

}
]

Campos de respuesta:

«uuid»string que representa el ID único de identificación de la llamada.
«status»

– «Conectada»
– «No Conectada»
– «Intentos terminados»
– «SPAM»
– «En cola»
– «Fuera de horario»
– «En ejecución»
– «Por ejecutar»
Estado de la llamada.

Posibles Valores
«call_number_company»Número de teléfono del agente, configurado en el popup.
«retry»Intento en el que se ejecutó la llamada.
«duration_company»Duración en segundos del lado de la empresa.
«duration_customer»Duración en segundos del lado del cliente.
«call_at»Fecha y hora cuando se realizó la llamada.
«enqueued»Si está en cola para ser ejecutada (en caso de tener reintentos configurados).
«popup_uuid»Identificador único del popup.
«popup_name»Nombre del popup.
«additionals»Parámetros adicionales enviados en la solicitud de llamada.
«caller_number»Número de teléfono de quien solicita la llamada.

Status HTTP: 204
No hay llamadas encontradas.

Status HTTP: 401
El token utilizado no es válido

Status HTTP: 404
La llamada identificada por el UUID no fue encontrada

    • Related Articles

    • API información de llamada ClickFono

      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 ...
    • API descarga audio de llamado Clickfono

      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 ...
    • Reglas de SPAM en FormCall – API

      Debido a que el flujo de las llamadas son separadas para FormCall y los Pop-Up ClickFono, también así son las reglas de spam: FormCall – API Hay dos filtros de spam para FormCall, cuando la llamada es encolada (call_session_validator.php) Las ...
    • Features y funciones avanzadas

      -  Conexión Exitosa Una conexión o llamada exitosa es aquella comunicación efectiva entre el solicitante web y el ejecutivo que contesta la llamada, cuya duración sea mayor a 25 segundos. -  Conexión o Minuto Extra Estas tarifas sólo se cobrarán si ...
    • Estados de las Llamadas FormCall

      API de estados para clientes de FormCall Trasfondo Para el uso de FormCall en aplicaciones que requieren, o se benefician, de feedback continuo sobre el estado de la llamada a los usuarios es necesario de un endpoint que pueda entregar el estado ...