Etapa 1: Gerar as credenciais da Pull API
Acesse https://callanalytics.salestrail.io/integration/apidocs a
e gere o username e a password na parte superior da página. Salve essas credenciais, pois a password não será exibida novamente.
Etapa 2: Fazer chamadas às APIs
Existem vários endpoints que você pode utilizar para obter os dados da sua Organisation:
/export/calls/byCreated/csv: recupera os dados das chamadas com base na data e hora de criação (created datetime) e retorna os dados no formato CSV./export/calls/byCreated/json: recupera os dados das chamadas com base na data e hora de criação (created datetime) e retorna os dados no formato JSON./export/calls/csv: recupera os dados das chamadas com base na data e hora de início da chamada (call start time) e retorna os dados no formato CSV./export/calls/json: recupera os dados das chamadas com base na data e hora de início da chamada (call start time) e retorna os dados no formato JSON./export/calls/{callId}/recording: recupera a gravação de uma chamada identificada pelocallId.
A autenticação desses endpoints utiliza o esquema Basic Authentication, com o username e a password gerados na Etapa 1. Os dados retornados dependem das informações que você tem permissão para visualizar no Dashboard. Isso significa que, como USER, você receberá apenas os seus próprios dados; como OWNER, você receberá todos os dados aos quais o Owner tem acesso.
Etapa 2.1: Fazer chamadas aos endpoints - Os quatro primeiros endpoints exigem os parâmetros de requisição HTTP from e to para filtrar os resultados por um período específico — utilizando o created timestamp ou o start timestamp da chamada.
Todos os timestamps são fornecidos em UTC. Exemplo de chamada 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' Essa chamada recupera, em formato JSON, os dados das chamadas criadas entre 2025-02-01 00:00:00.000Z and 2025-02-28 23:59:59.999Z
Etapa 2.2: Endpoint de gravação - Com este endpoint, você pode recuperar a gravação de uma chamada. Para utilizar este endpoint, é necessário um call ID obtido por meio das APIs de chamadas. Exemplo de chamada usando cURL: curl -u username:password --basic 'https://standalone-api.salestrail.io/export/calls/12345678-1234-1234-1234-123456781234/recording'
Esta API retorna o status HTTP 404 se a gravação não for encontrada ou se você não tiver permissão para acessá-la. Quando a requisição é bem-sucedida, o status HTTP retornado é 302, e o header Location fornece uma URL de blob storage que você pode usar para baixar a gravação. Normalmente, isso é feito diretamente utilizando a opção "follow redirects" no client ou na biblioteca que você estiver usando(cURL: -L/--location ). Como alternativa, você pode processar a resposta e executar uma nova requisição.