Google Cloud Storage & Speech API V2 – Transkrypcja nagrań/poczty głosowej w 3CX V20

Uwagi:

• Kroki 1 i 2 można pominąć, jeśli posiadasz już konto GCloud z odpowiednimi uprawnieniami i buckety Google.
• Zapewniamy integrację usług Google opartą na kreatorze; niniejszy dokument służy jako ograniczony przewodnik dla osób chcących skonfigurować ten komponent ręcznie.

Krok 1: Niezbędny dostęp do konta

Aby skonfigurować buckety pamięci Google, przejdź do „IAM & Admin” (IAM i administracja) > „IAM” w panelu Google Cloud i sprawdź, czy do Twojego konta przypisano co najmniej następujące role:

• „Service Account Admin” (Administrator kont usług)
• „Service Account Key Admin” (Administrator kluczy kont usług)
• „Project IAM Admin” (Administrator IAM projektu)
• „Storage Admin” (Administrator pamięci masowej)

Krok 2: Tworzenie bucketu pamięci (Storage Bucket)

Możesz pominąć tę część, jeśli masz już skonfigurowane buckety pamięci w swoim projekcie.

Jeśli posiadasz aktywną subskrypcję ze skonfigurowanymi opcjami płatności, przejdź do tworzenia nowego bucketu pamięci w ramach swojego projektu Google Cloud:

Z głównego menu nawigacyjnego wybierz „Storage” (Pamięć) > „Browser” (Przeglądarka) i kliknij „Create Bucket” (Utwórz bucket), aby utworzyć nowy bucket pamięci.

1. Na stronie „Create a bucket” (Utwórz bucket) skonfiguruj:
2. „Name” (Nazwa) – wprowadź unikalną w skali globalnej, stałą nazwę.
3. „Where to store data” (Gdzie przechowywać dane) – wybierz typ lokalizacji przechowywania zgodnie ze swoimi wymaganiami.
4. „Storage class” (Klasa pamięci) – wybierz odpowiednią klasę pamięci dla swojego zastosowania.
5. „Access control” (Kontrola dostępu) – ustaw sposób kontrolowania dostępu do obiektów w buckecie.
6. „Advanced settings” (Ustawienia zaawansowane) – opcjonalnie ustaw preferencje dotyczące szyfrowania i polityki retencji dla bucketu.
7. Kliknij „Create” (Utwórz), aby skonfigurować nowy bucket pamięci.
8. Po utworzeniu bucketu możesz kliknąć „Create folder” (Utwórz folder), aby dodać nowe foldery do przechowywania kopii zapasowych i zarchiwizowanych nagrań, np. „3cx_backups”.

Następnie użyj zapisanego klucza JSON i ustaw skonfigurowany bucket Google Cloud Storage jako lokalizację do przechowywania kopii zapasowych 3CX i archiwizacji nagrań.

⚠ Ważne: Pliki kopii zapasowych lub zarchiwizowane nagrania znajdujące się w stanie „Hold” lub przechowywane/archiwizowane z powodu obowiązującej polityki retencji nie mogą zostać usunięte ani nadpisane przez centralę PBX.

Krok 3: Włączanie Cloud Speech-to-Text API dla Twojego projektu

W konsoli Google przejdź do „APIs & Services” (Interfejsy API i usługi) > „Library” (Biblioteka) i wyszukaj „Cloud Speech-to-Text API”. Wybierz go i kliknij „Enable” (Włącz).

Krok 4: Tworzenie konta usługi i klucza z dostępem do Storage i Speech

W swoim projekcie GCloud przejdź do „IAM & Admin” (IAM i administracja) > „Service Accounts” (Konta usług) i kliknij „Create Service Account” (Utwórz konto usługi). Nadaj mu nazwę i kliknij „Create and Continue” (Utwórz i kontynuuj).

Dodaj następujące role („Roles”) do swojego konta usługi, kliknij „Continue” (Kontynuuj), a następnie „Done” (Gotowe):

1. „Storage Admin” (Administrator pamięci masowej)
2. „Cloud Speech Administrator” (Administrator Cloud Speech)

Edytuj nowo utworzone konto usługi i wybierz zakładkę „Keys” (Klucze), a następnie „Add Key” (Dodaj klucz).

Wybierz typ JSON i kliknij „Create” (Utwórz).

Plik JSON zostanie pobrany. Zapisz go w bezpiecznym miejscu, ponieważ nie będziesz mógł go pobrać ponownie.

Krok 5: Włączanie zdalnej archiwizacji i transkrypcji

1. Aby skonfigurować 3CX do korzystania z transkrypcji poczty głosowej i/lub nagrań, przejdź do Konsoli Admina > „System” > „Storage” (Pamięć).
2. Wybierz opcję „Enable Remote Data Storage & Archiving” (Włącz zdalne przechowywanie i archiwizację danych) i wybierz „Google Storage” w „Location Type (Required)” (Typ lokalizacji (wymagane)).
3. Prześlij plik JSON pobrany w poprzednim kroku w polu „Private Key (JSON type)” (Klucz prywatny (typ JSON)) i wybierz folder/ścieżkę („Folder/Path”) wewnątrz swojego bucketu Google Storage.
4. Zaznacz pola wyboru „Recordings” (Nagrania) i „Voicemails” (Poczta głosowa), aby włączyć automatyczną archiwizację w Google Storage.
5. Zapisz i przejdź do „Integrations” (Integracje) > „Transcription” (Transkrypcja).
6. Wybierz „Google Speech” jako silnik transkrypcji.
7. Wybierz język z rozwijanej listy „Speech Language” (Język mowy), aby ustawić język transkrypcji.
8. Wybierz, co ma być transkrybowane:

1. „Voicemails Only” (Tylko poczta głosowa) – ogranicz do poczty głosowej.
2. „Recordings Only” (Tylko nagrania) – ogranicz do nagrań.
3. „Both Voicemails and Recordings” (Zarówno poczta głosowa, jak i nagrania).

9. Kliknij „OK”, aby zastosować ustawienia. Po włączeniu transkrypcji poczty głosowej, przetworzony tekst jest dołączany do treści wiadomości e-mail dla otrzymanych wiadomości głosowych. Dodatkowo, w sekcjach poczty głosowej/nagrań klienta WWW 3CX, przetworzony tekst jest wyświetlany obok każdego nagrania/wiadomości.

Nagrania są w pełni transkrybowane w momencie zdalnej archiwizacji (natychmiast / w zaplanowanym czasie). 3CX obejmuje archiwizację do bucketu, dzięki czemu plik może zostać w pełni przetworzony.

Zobacz również

• Interfejs API kontroli połączeń dla systemu Linux
• Interfejs API kontroli połączeń dla systemu Windows
• Tworzenie skryptu przetwarzania połączeń
• Skrypt przetwarzania połączeń dla sygnałów DTMF 

Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 22 czerwca 2026 r.
https://www.3cx.pl/docs/administrator/google-speech-api-v2/