Wprowadzenie

API Aftertalk udostępnia przez HTTP większość funkcji aplikacji webowej: prześlij nagranie, a otrzymasz transkrypcję z rolami mówców, podsumowanie, kategorię, zadania oraz analizę według szablonu.

Model działaniaKopiuj link do sekcji

Trzy poziomy, od najwyższego:

1. Organizacja — do niej należą plan, projekty i klucze API.
2. Projekt — przestrzeń robocza dla powiązanych rozmów. Kategorie, szablony analizy i zestawy ról mówców konfiguruje się na poziomie projektu, a każda rozmowa należy do jednego z nich.
3. Rozmowa — jedno przesłane nagranie oraz wszystko, co powstało w wyniku jego przetworzenia.

Niemal każdy endpoint działa w kontekście projektu:

/v1/projects/{projectId}/calls

Jak rozmowa przechodzi przez systemKopiuj link do sekcji

Przesyłanie jest asynchroniczne. Identyfikator zadania przetwarzania otrzymujesz od razu, a transkrypcja pojawia się po zakończeniu przetwarzania:

POST /calls/upload  →  202 { jobId }
      ↓  transcription → PII redaction → classification → summary → template analysis
GET  /calls/jobs/{jobId}  →  { status: "COMPLETED", transcriptId }
GET  /calls/{transcriptId}  →  transcript, summary, category, action items count

Sprawdzaj status zadania przetwarzania, aż osiągnie status końcowy, albo zarejestruj webhook i otrzymaj powiadomienie, gdy wszystko będzie gotowe.

Co możesz zrobićKopiuj link do sekcji

• Przesyłać rozmowy i śledzić ich przetwarzanie
• Odczytywać transkrypcje, podsumowania, wydźwięk, kategorie i zadania
• Przeszukiwać transkrypcje zapytaniami pełnotekstowymi
• Zarządzać projektami, kategoriami, szablonami analizy i zestawami ról mówców
• Odczytywać metryki z pulpitu i wnioski z wielu rozmów
• Odbierać webhooki po zakończeniu przetwarzania rozmowy

Usuwanie projektów i rozmów celowo nie jest dostępne przez API — zrób to w aplikacji.

Kolejne krokiKopiuj link do sekcji

Utwórz klucz w aplikacji w sekcji Organizacja → Ustawienia → Klucze API, a następnie przejdź do szybkiego startu.