API · PL
API · PL

Pierwsze kroki

WprowadzenieSzybki startUwierzytelnianiePodstawowe pojęcia

Przewodniki

Przesyłanie rozmówPobieranie wynikówWebhookiStronicowanie i wyszukiwanie

Informacje szczegółowe

BłędyLimity żądań i rozliczenia
Dokumentacja referencyjna API
aftertalk.coCennikKontaktEnglish

Dokumentacja referencyjna API

Wszystkie endpointy dostępne dla klucza API, wygenerowane ze specyfikacji OpenAPI.

Bazowy adres URL

https://app.aftertalk.co/api

Wszystkie ścieżki podajemy względem tego adresu; zaczynają się od prefiksu wersji /v1. Niemal wszystko działa w kontekście projektu: /v1/projects/{projectId}/….

Uwierzytelnianie

W każdym żądaniu wysyłaj klucz API swojej organizacji w nagłówku X-API-Key:

curl https://app.aftertalk.co/api/v1/projects \
  -H "X-API-Key: $AFTERTALK_KEY"

Klucze tworzy się w aplikacji w sekcji Organizacja → Ustawienia → Klucze API. Zobacz uwierzytelnianie, aby dowiedzieć się, co klucz może, a czego nie może robić, oraz błędy, aby poznać strukturę odpowiedzi z błędem.

Endpointy

Ścieżki są względne wobec /v1/projects/{projectId}, z wyjątkiem tych podanych w całości.

Calls

  • POST/calls/uploadUpload audio for transcription
  • POST/calls/upload-urlStart a direct upload
  • POST/calls/upload-completeQueue a direct upload for transcription
  • GET/calls/jobs/{jobId}Get upload job status
  • GET/callsList calls with pagination and optional date filter
  • GET/calls/searchSearch calls by keyword
  • GET/calls/{id}Get call detail with transcript, classification, and summary
  • GET/calls/{id}/audioGet audio file info for a call
  • PATCH/calls/{id}/categoryManually set or clear a call's category

Projects

  • GET/v1/projectsList all projects for the authenticated user
  • POST/v1/projectsCreate a new project
  • GET/v1/projects/{projectId}Get a single project
  • PUT/v1/projects/{projectId}Update project name, description or default language

Webhooks

  • GET/webhooksList the project's webhooks
  • POST/webhooksRegister a webhook
  • DELETE/webhooks/{id}Delete a webhook
  • GET/webhooks/{id}/deliveriesRecent delivery attempts for a webhook
  • PATCH/webhooks/{id}/togglePause or resume a webhook

Categories

  • GET/categoriesGet category tree with call counts
  • POST/categoriesCreate a category
  • DELETE/categoriesClear all categories (delete entire taxonomy)
  • PUT/categories/{id}Update a category
  • DELETE/categories/{id}Delete a category
  • PATCH/categories/{id}/moveMove a category to a new parent or display order

Analysis Templates

  • GET/analysis-templatesList analysis templates
  • POST/analysis-templatesCreate an analysis template
  • GET/analysis-templates/{id}Get an analysis template
  • PUT/analysis-templates/{id}Update an analysis template
  • DELETE/analysis-templates/{id}Delete an analysis template
  • POST/analysis-templates/{id}/activateActivate an analysis template
  • POST/analysis-templates/{id}/deactivateDeactivate an analysis template

Speaker Presets

  • GET/speaker-presetsList speaker presets
  • POST/speaker-presetsCreate a speaker preset
  • PUT/speaker-presets/{id}Update a speaker preset
  • DELETE/speaker-presets/{id}Delete a speaker preset
  • PATCH/speaker-presets/{id}/defaultSet a speaker preset as default

Action Items

  • GET/action-itemsList action items with filtering and pagination
  • PATCH/action-items/{actionItemId}Update an action item's status, priority, notes, or text fields
  • DELETE/action-items/{actionItemId}Delete an action item
  • GET/action-items/responsible-partiesGet distinct responsible party values in this project

Dashboard

  • GET/dashboard/action-itemsGet pending action items
  • GET/dashboard/call-volumeGet call volume over time
  • GET/dashboard/categoriesGet top categories distribution
  • GET/dashboard/insightsGet AI-synthesized cross-call insights
  • GET/dashboard/metricsGet aggregated dashboard metrics
  • GET/dashboard/sentimentGet sentiment distribution and trend

Limity żądań i rozliczenia

Limity żądań na klucz i sposób naliczania opłat za korzystanie z API.

Upload audio for transcriptionPOST

Accepts an audio file and queues it for async processing. Returns 202 Accepted with a job ID that can be used to track progress. Optional 'language' selects the processing language (pl or en); omitted means the project's defaultLanguage.

Na tej stronie

Bazowy adres URLUwierzytelnianieEndpointy