Pobieranie wyników

Przesłanie zwraca identyfikator zadania przetwarzania. Możesz odpytywać API o to zadanie przetwarzania, aż osiągnie status końcowy, albo zarejestrować webhook i dostać powiadomienie, gdy będzie gotowe — webhooki lepiej sprawdzają się w stale działającej integracji, a odpytywanie jest prostsze w jednorazowym skrypcie.

curl "$BASE/v1/projects/$PROJECT_ID/calls/jobs/$JOB_ID" \
  -H "X-API-Key: $AFTERTALK_KEY"

Statusy zadań przetwarzaniaKopiuj link do sekcji

PENDING i PROCESSING to jedyne statusy, które nie są końcowe. Przy każdym innym zakończ odpytywanie.

Rozsądne jest odpytywanie co 5 sekund z górnym limitem czasu — czas przetwarzania rośnie wraz z długością nagrania.

import os, time, requests

BASE = "https://app.aftertalk.co/api"
headers = {"X-API-Key": os.environ["AFTERTALK_KEY"]}
TERMINAL = {"COMPLETED", "FAILED", "BILLING_FAILED"}

def wait_for_job(project_id, job_id, timeout_s=900):
    """Returns the job once it's terminal. FAILED is terminal too, so check job["status"]."""
    deadline = time.time() + timeout_s
    while True:
        job = requests.get(
            f"{BASE}/v1/projects/{project_id}/calls/jobs/{job_id}", headers=headers
        ).json()
        if job["status"] in TERMINAL:
            return job
        if time.time() > deadline:
            raise TimeoutError(f"job {job_id} still {job['status']}")
        time.sleep(5)

# The ids the quickstart exports.
job = wait_for_job(os.environ["PROJECT_ID"], os.environ["JOB_ID"])
if job["status"] == "FAILED":
    raise RuntimeError(f"Processing failed: {job.get('errorMessage')}")

Odczyt rozmowyKopiuj link do sekcji

Gdy pole transcriptId jest wypełnione:

curl "$BASE/v1/projects/$PROJECT_ID/calls/$TRANSCRIPT_ID" \
  -H "X-API-Key: $AFTERTALK_KEY"

Otrzymujesz transkrypcję podzieloną na wypowiedzi mówców (turns) oraz analizę, którą generuje Twój projekt — podsumowanie, wydźwięk, kategorię, ewentualną analizę według szablonu i liczbę zadań. Same zadania pobierasz z endpointów zadań (action items). Pełny schemat odpowiedzi znajdziesz w dokumentacji referencyjnej API.

Pola analizy są opcjonalne, nawet przy sukcesieKopiuj link do sekcji

Transkrypcja jest wymagana; każdy kolejny krok analizy jest wykonywany w miarę możliwości: nawet w pomyślnie przetworzonej rozmowie niektórych pól może brakować, więc przed odczytem zawsze sprawdzaj, czy pole istnieje. Jeśli klasyfikacja lub podsumowanie nie powiedzie się dla jednej rozmowy, zadanie przetwarzania i tak się zakończy z zapisaną transkrypcją, a brakować będzie tylko tego konkretnego pola.

Pobieranie nagraniaKopiuj link do sekcji

GET /calls/{id}/audio zwraca metadane i link do zapisanego nagrania, np. dla odtwarzacza lub kopii archiwalnej.