Con Infocaller es posible emitir llamadas telefónicas desde cualquier aplicación que pueda hacer una llamada HTTPS y enviar información por POST.

Una vez emitida la llamada, las acciones que se llevan a cabo en la misma se definen en las acciones y reglas de infocaller y se puede hacer uso dentro del guion de la API Interactiva.  En un guion de infocaller se puede conectar la llamada realizada con otra llamada saliente y así conseguir un sistema “click-to-call” muy potente que te aporta la flexibilidad de llamar primero al cliente y luego a tu call center (para optimizar el tiempo de los agentes), o llamar primero al agente y luego al cliente (para optimizar la calidad de la llamada).

En esta sección se describe la forma en que deben prepararse las llamadas HTTPS para que sean autenticadas y procesadas correctamente por infocaller.

La petición de emisión de llamada debe enviarse por POST en formato JSON o XML. La petición está dividida en dos secciones; una de identificación y otra con los datos de la llamada.

• URL - La dirección para enviar las solicitudes de emisión de llamadas es https://apicall.infoe.es
• POST – Al acceder a la anterior URL debe enviar por POST una variable llamada apiCALLjson o apiCALLxml, según corresponda, que contendrá la información de la petición:
• Los datos de autenticación en nuestra plataforma
• Los datos de la llamada a realizar
• Las variables que se quieran utilizar en la llamada

Estructura del XML
  

El XML deberá tener la siguiente estructura, dividida en una primera sección de identificación y otra con la información de la solicitud de llamada:

Azul: datos opcionales Rojo: datos obligatorios

{"callRequest": {

     "UserID": { 

      "idinfocaller": "DATO", 

      "firma": "DATO" 

    }, 

    "callData": { 

      "numtelefono": "DATO", 

      "gruporeglas": "DATO", 

      "fechahora": "DATO", 

      "EsperaMax": "DATO", 

      "Reintentos": "DATO", 

      "CustVars": { 

        "CustVar": [ 

          { 

            "VarName": "DATO", 

            "VarValue": "DATO" 

          }, 

          { 

            "VarName": "DATO", 

            "VarValue": "DATO" 

          } 

        ] 

      } 

    } 

  } 

}

Azul: datos opcionales Rojo: datos obligatorios    

Sección de 'Autenticación'

Los comandos de autenticación sirven para que validemos que la solicitud proviene de un cliente autorizado y para asociar la llamada a una línea infocaller.  

La sección de autenticación incluye dos datos, que son:

<UserID>
 <idinfocaller>  numero</idinfocaller>
 <firma>cadena_md5</firma>
</UserID>    

• idinfocaller: número del servicio infocaller con el que se realizarán las llamadas, incluyendo el código de país. Puede consultar el número de servicio en su cuenta, en la pestaña “Configurar”. 
  • firma: se trata de una medida de seguridad de infocaller para garantizar la autenticación. Para obtener la firma primero se concatenan dos valores: <idinfocaller> + <contraseña línea>. La “contraseña línea” la puede obtener en la configuración del servicio infocaller en la pestaña de ‘inicio’. Al texto obtenido de la concatenación de estos dos valores se le debe aplicar un algoritmo denominado MD5 (explicado en el Apéndice 1 de este documento). El resultado es el que se debe indicar como “cadena_md5” en la firma.   

Un ejemplo de autenticación:
Si el número del servicio infocaller fuese: 123456789   

Si la “contraseña línea” del servicio fuese: 3956
  

Aplicando el algoritmo MD5 a 1234567893956 se obtiene el resultado   

a2e12e9171fec3ebbb9c3c2a41b0b722 Y los comandos de autenticación serían:

     <idinfocaller> 123456789 </idinfocaller>
     <firma> a2e12e9171fec3ebbb9c3c2a41b0b722  </firma>  

Sección 'callData' (con * son requeridos)

• numtelefono *: Teléfono de destino de la llamada en formato internacional. Si no se especifica país, se asume el configurado en el servicio infocaller.  
• gruporeglas *: El nombre del grupo de reglas del servicio infocaller que quiere utilizar para la Emisión de llamadas. Este grupo de reglas no es necesario que esté en estado “Activo”. Cuando está en estado “Activo” actúa siempre sobre las llamadas entrantes al número infocaller. Por lo tanto, el grupo de reglas de Emisión de llamadas no debe confundirse con el que se utiliza para Llamadas entrantes.  
• Fechahora: si no se especifican se asume que la llamada se realizará inmediatamente. Formato: AAAA-MM-DDTHH:MM:SS (24 horas)   
• EsperaMax: tiempo en minutos, a partir de la fecha y hora de envío, durante el que se mantendrá la peti- ción en espera en caso de no disponer de líneas simultáneas disponibles. Al caducar el tiempo, la petición se anulará y se registrará el intento fallido en la consulta de actividad. Valor por defecto: 5 minutos. Valor máximo 300 minutos.   
• Reintentos: Número de reintentos en caso de que la llamada comunique. Los reintentos se realizarán con intermedios mínimos de 5 minutos. Las llamadas que no contestan no se reintentarán. Valor por defecto: 0 reintentos. Valor máximo: 4 reintentos