Specyfikacja techniczna
Wszystko, czego zespoły techniczne potrzebują do oceny IdentityCall: formaty plików, możliwości API, metody integracji, bezpieczeństwo i zgodność.
Obsługa audio i plików
Specyfikacja | Szczegóły |
|---|---|
Obsługiwane formaty | MP3, WAV, M4A, FLAC, OGG, WebM, MP4 (audio wyodrębniane) |
Maksymalny rozmiar pliku | 2 GB na plik |
Minimalna długość audio | Dowolna długość dla transkrypcji; 3+ sekundy dla biometrii głosu |
Częstotliwość próbkowania | 8kHz – 48kHz (zalecane 16kHz+ dla optymalnej dokładności) |
Kanały | Obsługa mono i stereo; kanały stereo przetwarzane niezależnie |
Kodowanie | Automatyczne wykrywanie formatu i konwersja; bez wcześniejszego przetwarzania |
Obsługiwane języki (50+)
Arabski
Niderlandzki
Hindi
Polski
Bengalski
Angielski
Węgierski
Portugalski
Bułgarski
Filipiński
Indonezyjski
Rumuński
Kataloński
Fiński
Włoski
Rosyjski
Chiński (mandaryński)
Francuski
Japoński
Słowacki
Chiński (kantoński)
Niemiecki
Koreański
Hiszpański
Chorwacki
Grecki
Malajski
Szwedzki
Czeski
Gudżarati
Norweski
Tamilski
Duński
Hebrajski
Perski
Turecki, ukraiński i inne
Dokumentacja API
API RESTful z odpowiedziami JSON. Wszystkie punkty końcowe wymagają uwierzytelnienia i zwracają spójne formaty błędów.
Uwierzytelnianie
Typ | Uwierzytelnianie tokenem Bearer |
Nagłówek | Authorization: Bearer <YOUR_API_KEY> |
Zarządzanie kluczami | Generuj i unieważniaj klucze z panelu |
Zakresy | Klucze można ograniczyć do konkretnych projektów lub pełnego dostępu do konta |
Główne punkty końcowe
POST /api/v1/public/recordings | Prześlij plik audio do przetworzenia |
GET /api/v1/public/recordings/{id} | Pobierz status i metadane nagrania |
GET /api/v1/public/recordings/{id}/transcription | Pobierz pełną transkrypcję z diaryzacją mówców |
GET /api/v1/public/recordings/{id}/results | Wyniki celów, kategorie, wyodrębnione pola, identyfikacja mówcy |
GET /api/v1/public/recordings/{id}/summary | Wygenerowane przez AI podsumowanie połączenia |
GET /api/v1/public/projects | Wylistuj projekty i zarządzaj nimi |
GET /api/v1/public/operators | Zarządzaj operatorami (konsultantami) |
GET /api/v1/public/virtual_numbers/available | Przeglądaj numery telefonów do kupienia |
POST /api/v1/public/virtual_numbers/purchase | Kup numer telefonu |
Webhooki
recording.analyzed
Wywoływany po zakończeniu przetwarzania - gotowe transkrypcja, punktacja i analiza. Ładunek zawiera włączone przez Ciebie sekcje: metadane, podsumowanie, transkrypcja, cele, kategorie, wyodrębnione dane.
Format odpowiedzi
{
"data": {},
"meta": {
"request_id": "req_abc123",
"processing_time_ms": 1250
}
}
Format odpowiedzi
{
"error": {
"code": "invalid_audio_format",
"message": "Unsupported file format. See documentation for supported formats.",
"request_id": "req_abc123"
}
}
Limity zapytań
Plan | Limit |
|---|---|
Starter | Zależny od planu - zobacz cennik |
Professional | Wyższe limity z dopuszczalnymi skokami |
Enterprise | Dostępne limity niestandardowe |
Metody integracji
Wiele sposobów połączenia IdentityCall z Twoją istniejącą infrastrukturą. Wybierz na podstawie swojego przypadku użycia i wymagań technicznych.
API przesyłania plików
Najlepsze dla
Przetwarzanie wsadowe, analiza historyczna, nagrania z dowolnego źródła
Jak to działa
Wyślij pliki audio metodą POST do /api/v1/public/recordings. Odbierz webhook lub odpytuj o wyniki.
Formaty
Wszystkie obsługiwane formaty audio do 2GB
Przetwarzanie
Asynchroniczne - przesłanie zwraca odpowiedź natychmiast, wyniki dostarczane przez webhook
Numery wirtualne (śledzenie na żywo)
Najlepsze dla
Śledzenie połączeń w czasie rzeczywistym, atrybucja marketingowa, przychodzące call center
Jak to działa
Udostępniaj numery przez API lub panel. Połączenia są nagrywane i przetwarzane automatycznie.
Typy numerów
Dostępne numery lokalne i bezpłatne
Funkcje
Powitania, kierowanie połączeń, webhooki w czasie rzeczywistym, atrybucja źródła
Odbiór przez SFTP
Najlepsze dla
Istniejące systemy PBX, contact center i rejestratory eksportujące pliki audio
Jak to działa
Twój system umieszcza nagrania w dedykowanym folderze SFTP; IdentityCall importuje je i przetwarza automatycznie
Wymagania
Dowolny system, który potrafi eksportować nagrania przez SFTP
Konfiguracja
Poświadczenia SFTP nadawane w panelu
Integracje bezpośrednie
HubSpot
Integracja natywna - dane połączeń trafiają na oś czasu kontaktu
Salesforce
Wkrótce - synchronizacja transkrypcji, profili i analityki z rekordami
Pipedrive
Wkrótce - wyniki i podsumowania połączeń przy Twoich transakcjach
Slack
Powiadomienia i podsumowania na kanały
Telnyx
Zasila numery wirtualne - udostępnianie, nagrywanie i webhooki
Integracja niestandardowa
Webhooki
Powiadomienia o zdarzeniach w czasie rzeczywistym do Twoich punktów końcowych
REST API
Pełny programistyczny dostęp do wszystkich funkcji
Formaty eksportu
JSON, CSV dla transkrypcji i analityki
Zaplanowane raporty
Dostarczanie raportów e-mailem w harmonogramie tygodniowym lub miesięcznym
Bezpieczeństwo i zgodność
Bezpieczeństwo klasy enterprise z ramami zgodności dla branż regulowanych.
Certyfikaty i standardy
ISO 27001 | Certyfikat - system zarządzania bezpieczeństwem informacji |
GDPR | Zgodność - rozporządzenie UE o ochronie danych |
CCPA | Zgodność - kalifornijska ustawa o ochronie prywatności konsumentów (CCPA) |
HIPAA | Dostępne jako dodatek dla klientów z ochrony zdrowia |
Szyfrowanie
W tranzycie | TLS 1.3 dla całego ruchu API i webowego |
W spoczynku | Szyfrowanie AES-256 dla przechowywanych danych |
Zarządzanie kluczami | Klucze zarządzane przez bezpieczną usługę zarządzania kluczami |
Infrastruktura
Hosting | Dedykowane centra danych w UE (Hetzner, Finlandia) |
Architektura | Izolacja bazy danych w sieci prywatnej, obciążenia w Docker |
Monitorowanie | Automatyczne monitorowanie i alerty 24/7 |
Kopie zapasowe | Automatyczne codzienne kopie zapasowe z odtwarzaniem do wybranego momentu |
Kontrola dostępu
Uwierzytelnianie | E-mail/hasło z obsługą MFA, Google OAuth 2.0 |
Dostęp oparty na rolach (RBAC) | Role Owner, Admin, Member ze szczegółowymi uprawnieniami |
Zakres kluczy API | Klucze można ograniczyć do konkretnych projektów |
Logi audytu | Wszystkie dostępy i zmiany rejestrowane ze znacznikami czasu |
Bezpieczeństwo danych głosowych
Embeddingi głosu | Przechowywane jako 256-wymiarowe wektory - nie da się ich odwrócić, aby odtworzyć audio |
Przechowywanie audio | Konfigurowalne per projekt; embeddingi głosu można zachować po usunięciu audio |
Usuwanie danych | Pełne usunięcie na żądanie; embeddingi można usuwać niezależnie |
Funkcje zgodności
Wnioski osób, których dane dotyczą | Punkty końcowe API do wniosków o dostęp, eksport i usunięcie |
Zarządzanie zgodami | Przepływy pouczeń o nagrywaniu i zgód |
Rezydencja danych | Wszystkie dane klientów hostowane w UE |
Umowy powierzenia | Umowa powierzenia (DPA) dostępna na potrzeby zgodności z RODO |
Przetwarzanie danych
Pełna kontrola nad tym, jak Twoje dane są przechowywane, zatrzymywane i eksportowane.
Przechowywanie danych
Nagrania audio | 30, 90, 365 dni lub bezterminowo - konfigurowalne per projekt |
Transkrypcje | Zgodnie z przechowywaniem audio lub zatrzymywane niezależnie |
Embeddingi głosu | Można zachować po usunięciu audio, aby kontynuować rozpoznawanie mówców |
Analityka i wyniki | Zatrzymywane wraz z transkrypcją lub eksportowane niezależnie |
Logi audytu | Zatrzymywane przez okres zgodności (minimum 1 rok) |
Rezydencja danych
Region hostingu | Unia Europejska - centra danych w Finlandii |
Magazyn obiektowy | Szyfrowane kopie zapasowe w magazynie zgodnym z S3 (Cloudflare R2) |
Izolacja danych | Baza danych działa w sieci prywatnej, nieosiągalna z publicznego internetu |
Opcje eksportu
JSON | Dostęp programistyczny, odpowiedzi API, ładunki webhooków |
CSV | Analiza w arkuszach, import do narzędzi BI |
Czytelne dla człowieka podsumowania transkrypcji | |
Surowa transkrypcja | Zwykły tekst ze znacznikami czasu |
Usuwanie danych
Pojedyncze nagranie | Usuń przez panel lub API |
Profil głosu | Usuń profil i wszystkie powiązane embeddingi |
Cały projekt | Usuń wszystkie nagrania, profile i analitykę |
Zamknięcie konta | Wszystkie dane trwale usuwane w ciągu 30 dni |
Dodatkowe zasoby
Pełna dokumentacja API | /api-docs |
Przegląd bezpieczeństwa | /security |
Ceny i plany | /pricing |
Kontakt ze sprzedażą | /contact |
Chcesz zacząć oceniać?
Rozpocznij bezpłatny okres próbny, aby przetestować nasze API na własnym audio. Pełny dostęp, bez karty kredytowej.