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

Podstawowe pojęcia

Projekty, rozmowy, kategorie, szablony, zestawy ról mówców i zadania.

Projekty

Projekt to przestrzeń robocza dla powiązanych rozmów — jeden na zespół, klienta lub obszar działalności. Kategorie, szablony analizy, zestawy ról mówców i domyślny język transkrypcji konfiguruje się na poziomie projektu, więc dwa projekty mogą analizować rozmowy w zupełnie różny sposób.

Każda rozmowa należy do dokładnie jednego projektu, a klucz ma dostęp do wszystkich projektów swojej organizacji. Rozmów nie można przenosić między projektami przez API.

Rozmowy

Rozmowa to jedno przesłane nagranie oraz wszystko, co powstało na jego podstawie:

  • Transkrypcja — wypowiedzi (turns) ze znacznikami czasu i przypisaniem do mówców
  • Podsumowanie — krótkie streszczenie z ogólnym wydźwiękiem
  • Kategoria — jedna z kategorii projektu, wybrana przez klasyfikator
  • Zadania — ustalenia do wykonania wyciągnięte z rozmowy
  • Analiza według szablonu — odpowiedzi na pytania z Twojego aktywnego szablonu

Transkrypcja jest wykonywana zawsze. Wszystko, co następuje po niej, zależy od konfiguracji Twojego projektu i jest wykonywane 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.

Kategorie

Kategorie to Twoje własne etykiety opisujące, czego dotyczyła rozmowa — „pytanie o rozliczenia”, „rezygnacja”, „wsparcie techniczne”. Klasyfikator wybiera jedną dla każdej rozmowy.

Opis ma znaczenie: to z nim klasyfikator porównuje rozmowę, więc „klient chce zrezygnować z subskrypcji lub pyta o warunki rezygnacji” działa znacznie lepiej niż „rezygnacja”.

Możesz zmienić kategorię wybraną przez klasyfikator dla konkretnej rozmowy za pomocą PATCH /calls/{id}/category, a usunąć kategorię, wysyłając null.

Szablony analizy

Szablon to zestaw pytań, na które Aftertalk odpowiada dla każdej rozmowy w projekcie — karta oceny QA, lista kontrolna zgodności z procedurami, scenariusz rozmowy rozpoznającej potrzeby klienta. W danym momencie aktywny jest jeden szablon; aktywacja innego sprawia, że nowe rozmowy są analizowane według niego.

Zmiana lub aktywacja szablonu wpływa wyłącznie na przyszłe rozmowy. Istniejące rozmowy zachowują analizę wykonaną podczas ich przetwarzania.

Zestawy ról mówców

Zestaw ról mówców to zapisane przypisanie kanałów do ról, którego możesz używać wielokrotnie (kanał 0 = lewy, 1 = prawy), dzięki czemu nie musisz przekazywać channel_roles przy każdym przesłaniu. Ustaw domyślny zestaw dla projektu, a nagrania stereo otrzymają role automatycznie.

Zadania

Zadania to ustalenia do wykonania wyciągnięte z rozmów; każde jest powiązane z rozmową, z której pochodzi, i opcjonalnie z osobą odpowiedzialną. Powstają podczas tworzenia podsumowania, a przez API możesz pobierać ich listę, aktualizować je i usuwać — przydaje się to do przekazywania zadań do Twojego systemu zgłoszeń.

Pulpit

Endpointy pulpitu zwracają te same agregaty, które aplikacja prezentuje na wykresach: liczbę rozmów w czasie, rozkład wydźwięku, podział na kategorie, liczbę zadań oraz wnioski z wielu rozmów. Korzystaj z nich, zamiast przechodzić przez wszystkie rozmowy, aby samodzielnie wyliczać sumy.

Uwierzytelnianie

Klucze API organizacji i nagłówek X-API-Key.

Przesyłanie rozmów

Formaty, role mówców, limity rozmiaru i obsługa duplikatów.

Na tej stronie

ProjektyRozmowyKategorieSzablony analizyZestawy ról mówcówZadaniaPulpit