Steg 1: Generera inloggningsuppgifter för Pull API
Gå till https://callanalytics.salestrail.io/integration/apidocs och generera Username och Password högst upp på sidan. Spara dessa inloggningsuppgifter eftersom lösenordet inte kommer att visas igen.
Steg 2: Anropa API
Det finns flera endpoints som du kan anropa för att hämta data från din organisation.
-
/export/calls/byCreated/csv: Hämtar samtalsdata baserat på när data skapades (datetime) och returnerar data i CSV-format -
/export/calls/byCreated/json: Hämtar samtalsdata baserat på när data skapades (datetime) och returnerar data i JSON-format -
/export/calls/csv: Hämtar samtalsdata baserat på samtalets starttid (datetime) och returnerar data i CSV-format -
/export/calls/json: Hämtar samtalsdata baserat på samtalets starttid (datetime) och returnerar data i JSON-format -
/export/calls/{callId}/recording: Hämtar en inspelning för ett samtal som identifieras med callId
Autentisering för dessa endpoints använder Basic scheme (https://en.wikipedia.org/wiki/Basic_access_authentication) med Username och Password som genererades i steg 1. Vilka data som returneras beror på vilka data du har behörighet att se i Dashboard. Det innebär att du som USER endast får dina egna data, medan du som OWNER får alla data.
Steg 2.1: Anropa endpoints – De första fyra endpoints kräver HTTP request-parametrarna from och to för att filtrera resultaten till en specifik tidsperiod – antingen baserat på created timestamp eller samtalets start timestamp. Alla timestamps anges i UTC. Exempel på ett anrop med cURL: 'https://standalone-api.salestrail.io/export/calls/byCreated/json?from=2025-02-01T00%3A00%3A00.000Z&to=2025-03-01T00%3A00%3A00.000Z' Detta hämtar JSON-data för de samtal som skapades mellan 2025-02-01 00:00:00.000Z och 2025-02-28 23:59:59.999Z.
Steg 2.2: Recording endpoint – Med denna endpoint kan du hämta en inspelning. För att anropa denna endpoint krävs ett call id från call API. Exempel på ett anrop med cURL: 'https://standalone-api.salestrail.io/export/calls/12345678-1234-1234-1234-123456781234/recording' Detta API returnerar 404 om en inspelning inte hittas eller om du inte har behörighet att komma åt inspelningen. Vid ett lyckat anrop är HTTP-statusen 302, och Location-headern innehåller en blob storage-URL som du kan använda för att hämta inspelningen. Vanligtvis hanteras detta direkt med alternativet "follow redirects" i den klient/det bibliotek du använder (cURL: -L/--location). Alternativt kan du läsa svaret och utföra ett nytt anrop.