GET /api/v1/voice/calls/{id} palauttaa puhelun tilan, keston, veloitetut krediitit, yhteenvedon, analyysin ja litteraatin. Listaa puhelut komennolla GET /api/v1/voice/calls?agent_id=&status=&channel=&user_id=&page= (user_id: oma tunnuksesi henkilölle, verkkopuhelun tunnisteesta). Sen turns on puhelun vuoro vuorolta -vianetsintäloki: mihin aika kului siitä, kun soittaja lopetti puhumisen, siihen, kun hän kuuli vastauksen, millisekunteina — waitMs (puheen loppu), sttMs (tunnistus), llmMs (mallin ensimmäinen sana, yksi lisää jokaista funktiokierrosta kohti), ttsMs (äänen ensimmäinen ääni), firstAudioMs (vastaus kuultiin) — sekä kutsutut funktiot, keskeytykset ja virheet. Puhelusivu näyttää sen myös.
recording_enabled-asetuksella jokainen puhelu tallennetaan kaksikanavaiseksi WAV-tiedostoksi: soittaja vasemmalle, agentti oikealle, puhelun näytteenottotaajuudella. Asetuksella recording_consent: "announce" agentti kertoo ensin, että puhelu tallennetaan; asetuksella "ask" se kysyy, ja tallenne säilytetään vain, jos soittaja suostuu (vastaamatta jättäminen lasketaan kieltäytymiseksi); asetuksella "none" mitään ei sanota. Tarkista, mitä laki vaatii siellä, missä sinä ja soittajasi olette.
Tallenteet säilytetään EvaSayn tallennustilassa tai omassa S3-yhteensopivassa bucketissasi (AWS S3, Cloudflare R2, Google Cloud Storage, Supabase, MinIO), jonka määrität kohdassa Integraatiot → Webhookit ja ilmoitukset → Tallenteiden säilytys. Puhelua pyörittävä worker lataa tiedoston suoraan bucketiin. GET /api/v1/voice/calls/{id} palauttaa recordingUrl-osoitteen, joka on voimassa tunnin sen jälkeen, kun tallenne on tallennettu, sekä recording.status-tilan (recording, stored, declined tai failed).
DELETE /api/v1/voice/calls/{id} poistaa päättyneen puhelun litterointeineen, nauhoituksineen (EvaSayn tallennustilassa tai omassa bucketissasi), analyyseineen ja webhook-toimituksineen. Käytetyt Credits jäävät krediittihistoriaan. Puhelu, jota ei voi vielä poistaa, vastaa 409 ja code call_not_deletable_yet: se on käynnissä tai päättyi juuri, sitä laskutetaan vielä, sen nauhoitusta saatetaan vielä ladata tai sillä on Credits-velkaa, jota saldo ei kattanut (lisää ensin Credits).
Kun henkilö pyytää poistamaan tietonsa, POST /api/v1/voice/calls/delete-by-caller ja { "phone_number": "+14155550123" } poistaa kaikki puhelut tällä numerolla (saapuvissa soittajan numero, lähtevissä soitettu numero), tai { "user_id": "..." } kaikki verkkopuhelut, joiden tunnuksessa oli tämä user_id. Vastaus on { "deleted": 12, "kept_back": { "settling": 1 }, "more": false }: enintään 200 puhelua pyyntöä kohden, joten kysy uudelleen niin kauan kuin more on true, ja myöhemmin uudelleen kept_back-puheluille. Jos numero on Älä soita -luettelossa, se pysyy siellä. Hallintapaneelissa sama tehdään kohdassa Puhelut → Poista soittajan tiedot.
