Step 1: Genera las credenciales de Pull API
Ve a https://callanalytics.salestrail.io/integration/apidocs y genera el username y password en la parte superior de la página. Guarda estas credenciales, ya que el password no volverá a mostrarse.
Step 2: Llama a las APIs.
Hay varios endpoints que puedes llamar para obtener los datos de tu organización. - /export/calls/byCreated/csv: Recupera datos de llamadas basados en la fecha y hora de creación, con resultado en formato CSV - /export/calls/byCreated/json: Recupera datos de llamadas basados en la fecha y hora de creación, con resultado en formato JSON - /export/calls/csv: Recupera datos de llamadas basados en la hora de inicio de la llamada (datetime), con resultado en formato CSV - /export/calls/json: Recupera datos de llamadas basados en la hora de inicio de la llamada (datetime), con resultado en formato JSON - /export/calls/{callId}/recording: Recupera una grabación de una llamada identificada por callId. La autenticación para estos endpoints usa el esquema Basic (https://en.wikipedia.org/wiki/Basic_access_authentication) con el username y password generados en el paso 1. Los datos devueltos dependen de qué datos tienes permiso para ver en el dashboard. Esto significa que, como USER, solo obtendrás tus propios datos, y como OWNER, obtendrás todos los datos.
Step 2.1: Llamar a endpoints -- Los primeros cuatro endpoints requieren los parámetros de solicitud HTTP 'from' y 'to' para filtrar los resultados a un periodo específico, ya sea usando el timestamp de creación o el timestamp de inicio de la llamada. Todos los timestamps se entregan en UTC. Ejemplo de llamada usando cURL: curl -u username:password --basic 'https://standalone-api.salestrail.io/export/calls/byCreated/json?from=2025-02-01T00%3A00%3A00.000Z&to=2025-03-01T00%3A00%3A00.000Z' Esto obtendría datos JSON de las llamadas que se crearon entre 2025-02-01 00:00:00.000Z y 2025-02-28 23:59:59.999Z.
Step 2.2: Endpoint de grabación -- Con este endpoint, puedes obtener una grabación. Para llamar a este endpoint se requiere un call id de las APIs de llamadas. Ejemplo de llamada usando cURL: curl -u username:password --basic 'https://standalone-api.salestrail.io/export/calls/12345678-1234-1234-1234-123456781234/recording'
Esta API devuelve 404 si no se encuentra una grabación o si no tienes acceso a esta grabación. Si la solicitud se realiza correctamente, el estado HTTP devuelto es 302, y el header Location proporcionará una URL de blob storage que puedes usar para descargar la grabación. Normalmente, esto se hace directamente usando una opción de "follow redirects" en el cliente/librería que estés usando (cURL: -L/--location). O bien, puedes analizar la respuesta y ejecutar otra consulta.