Vaihe 1: Luo Pull API -tunnukset
Siirry osoitteeseen https://callanalytics.salestrail.io/integration/apidocs ja luo käyttäjätunnus ja salasana sivun yläosassa. Tallenna nämä tunnukset, koska salasanaa ei näytetä uudelleen.
Vaihe 2: Kutsu API:ita.
Sinulla on useita päätepisteitä, joita voit kutsua organisaatiosi tietojen hakemiseksi.
/export/calls/byCreated/csv: Hae puhelutiedot luontipäivämäärän perusteella CSV-muodossa/export/calls/byCreated/json: Hae puhelutiedot luontipäivämäärän perusteella JSON-muodossa/export/calls/csv: Hae puhelutiedot puhelun alkamisajan perusteella CSV-muodossa/export/calls/json: Hae puhelutiedot puhelun alkamisajan perusteella JSON-muodossa/export/calls/{callId}/recording: Hae tallenne puhelulle, joka on tunnistettu callId:lläNäiden päätepisteiden todennus käyttää Basic-järjestelmää (https://en.wikipedia.org/wiki/Basic_access_authentication) vaiheessa 1 luoduilla käyttäjätunnuksella ja salasanalla. Palautetut tiedot riippuvat siitä, mitä tietoja sinulla on oikeus nähdä dashboardissa. Tämä tarkoittaa, että KÄYTTÄJÄNÄ saat vain omat tietosi, ja OMISTAJANA saat kaikki tiedot.Vaihe 2.1: Kutsu päätepisteitä
Neljä ensimmäistä päätepistettä vaativat HTTP-pyyntöparametrit 'from' ja 'to' tulosten suodattamiseksi tietylle ajanjaksolle – joko luontiaikaleiman tai puhelun alkamisaikaleiman avulla. Kaikki aikaleimat annetaan UTC-aikaleimana.
Esimerkkikutsu cURL:lla:
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'
Tämä hakisi JSON-muodossa puheluiden tiedot, jotka luotiin 2025-02-01 00:00:00.000Z ja 2025-02-28 23:59:59.999Z välillä.
Vaihe 2.2: Tallennuspäätepiste
Tällä päätepisteellä voit hakea tallennuksen. Tämän päätepisteen kutsuminen vaatii puhelun tunnuksen puhelu-API:eista.
Esimerkkikutsu cURL:lla:
curl -u username:password --basic 'https://standalone-api.salestrail.io/export/calls/12345678-1234-1234-1234-123456781234/recording'
Tämä API palauttaa 404, jos tallennusta ei löydy tai jos sinulla ei ole pääsyä tähän tallenteeseen. Onnistuessa palautettu HTTP-tila on 302, ja Location-otsikko antaa blob-tallennuksen URL-osoitteen, jota voit käyttää tallennuksen lataamiseen. Yleensä tämä tehdään suoraan käyttämällä "seuraa uudelleenohjauksia" -vaihtoehtoa käyttämässäsi asiakasohjelmassa tai kirjastossa (cURL: -L/--location). Tai voit jäsentää vastauksen ja suorittaa toisen kyselyn.