Krok 1: Wygeneruj dane uwierzytelniające Pull API
Wejdź na stronę https://callanalytics.salestrail.io/integration/apidocs i wygeneruj nazwę użytkownika oraz hasło, korzystając z opcji dostępnej w górnej części strony. Zapisz te dane, ponieważ hasło nie zostanie wyświetlone ponownie.
Krok 2: Wywołanie interfejsów API.
Dostępnych jest kilka punktów końcowych (endpointów), za pomocą których można pobrać dane organizacji: – /export/calls/byCreated/csv: pobieranie danych o połączeniach na podstawie daty i godziny ich utworzenia (format CSV); – /export/calls/byCreated/json: pobieranie danych o połączeniach na podstawie daty i godziny ich utworzenia (format JSON); – /export/calls/csv: pobieranie danych o połączeniach na podstawie daty i godziny rozpoczęcia połączenia (format CSV); – /export/calls/json: pobieranie danych o połączeniach na podstawie daty i godziny rozpoczęcia połączenia (format JSON); – /export/calls/{callId}/recording: pobieranie nagrania połączenia wskazanego przez identyfikator `callId`. Uwierzytelnianie w tych punktach końcowych odbywa się za pomocą mechanizmu Basic Auth (https://en.wikipedia.org/wiki/Basic_access_authentication) z wykorzystaniem nazwy użytkownika i hasła wygenerowanych w kroku 1. Zakres zwracanych danych zależy od uprawnień użytkownika w panelu administracyjnym: użytkownik (USER) otrzyma dostęp tylko do własnych danych, natomiast właściciel (OWNER) uzyska dostęp do wszystkich danych.
Krok 2.1: Punkty końcowe dotyczące połączeń (endpoints) — Pierwsze cztery punkty końcowe wymagają podania parametrów żądania HTTP „from” oraz „to” w celu przefiltrowania wyników według określonego przedziału czasowego – na podstawie znacznika czasu utworzenia (created timestamp) lub znacznika czasu rozpoczęcia połączenia (start timestamp). Wszystkie znaczniki czasu są podawane w formacie UTC. Przykładowe wywołanie z użyciem narzędzia 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'. Pozwoli to pobrać dane w formacie JSON dotyczące połączeń utworzonych w okresie od 2025-02-01 00:00:00.000Z do 2025-02-28 23:59:59.999Z.
Krok 2.2: Punkt końcowy nagrań (Recording endpoint) — za pomocą tego punktu końcowego można pobrać nagranie. Do wywołania tego punktu końcowego wymagany jest identyfikator połączenia (call ID), który można uzyskać z interfejsów API dotyczących połączeń. Przykładowe wywołanie z użyciem narzędzia cURL: curl -u username:password --basic 'https://standalone-api.salestrail.io/export/calls/12345678-1234-1234-1234-123456781234/recording'
Jeśli nagranie nie zostanie znalezione lub jeśli użytkownik nie ma do niego dostępu, ten interfejs API zwraca kod 404. W przypadku powodzenia zwracany jest kod stanu HTTP 302, a nagłówek „Location” zawiera adres URL w pamięci masowej typu blob, za pomocą którego można pobrać nagranie. Zazwyczaj odbywa się to automatycznie dzięki opcji „podążania za przekierowaniami” (ang. *follow redirects*) w używanym kliencie lub bibliotece (w przypadku cURL jest to flaga -L/--location). Alternatywnie można samodzielnie przeanalizować odpowiedź i wykonać kolejne zapytanie.