---
title: "Wprowadzenie"
description: "Dokumentacja dotycząca uruchamiania produkcyjnych agentów głosowych w rzeczywistych rozmowach telefonicznych i osadzalnych widżetach internetowych: przewodniki szybkiego startu, poradniki oraz pełna dokumentacja API ThunderPhone."
---

ThunderPhone umożliwia tworzenie głosowych agentów AI, którzy wykonują i odbierają
prawdziwe połączenia telefoniczne oraz obsługują rozmowy inicjowane mikrofonem na Twojej stronie.
Dokumentacja jest podzielona na cztery karty:

<CardGroup cols={2}>
  <Card title="Przewodniki" icon="book" href="/pl/quickstart-dashboard">
    Szybkie starty, pojęcia i instrukcje dotyczące panelu oraz API.
    **Zacznij tutaj**, jeśli dopiero zaczynasz.
  </Card>
  <Card title="Dokumentacja API" icon="code" href="/api-reference/introduction">
    Każdy endpoint, pole żądania i format odpowiedzi.
  </Card>
  <Card title="Widżet" icon="window-maximize" href="/pl/widget/overview">
    Osadzany widżet internetowy — komponent React, hook headless i
    tag skryptu CDN.
  </Card>
  <Card title="Webhooki" icon="bolt" href="/pl/webhooks/overview">
    Zdarzenia w czasie rzeczywistym, podpisywanie i semantyka dostarczania.
  </Card>
</CardGroup>

## Co możesz zbudować

<CardGroup cols={2}>
  <Card title="Obsługa przychodzących połączeń" icon="phone">
    Odbieraj połączenia na należący do Ciebie numer za pomocą agenta AI, który realizuje
    Twój prompt, korzysta z Twoich narzędzi i w razie potrzeby przekazuje rozmowę ludziom.
  </Card>
  <Card title="Kampanie wychodzące" icon="arrow-up-right">
    Wykonuj programowo połączenia z poziomu kodu — ankiety, działania następcze lub
    procesy potwierdzania.
  </Card>
  <Card title="Głos w przeglądarce" icon="microphone">
    Dodaj nasz osadzany [widżet internetowy](/pl/guides/embed-web-widget) do swojej
    strony, aby klienci mogli kliknąć i rozmawiać. Numer telefonu nie jest wymagany.
  </Card>
  <Card title="Agenci sterowani testami" icon="flask">
    Uruchamiaj przygotowane scenariusze przez swojego agenta w [partiach](/api-reference/test-calls),
    aby wykrywać regresje, zanim usłyszą je klienci.
  </Card>
</CardGroup>

## Dwa sposoby rozpoczęcia

**W panelu** (zalecane dla pierwszego agenta) — zarejestruj się, a
panel przeprowadzi Cię przez pięcioetapowy kreator konfiguracji: utworzenie
agenta, konfigurację rozliczeń, dodanie numeru telefonu, uruchomienie symulacji i sprawdzenie
połączenia. [Szybki start w panelu](/pl/quickstart-dashboard) odzwierciedla
ten kreator krok po kroku.

**Z terminala** — [szybki start API](/pl/quickstart) wykonuje
to samo pierwsze połączenie za pomocą czterech wywołań REST.

<Steps>
  <Step title="Przejrzyj pojęcia">
    [Pojęcia](/pl/guides/concepts) — mapa każdego obiektu, z którym będziesz pracować,
    oraz informacja, gdzie znajduje się on w panelu.
  </Step>
  <Step title="Uruchom szybki start">
    [Szybki start w panelu](/pl/quickstart-dashboard) lub
    [szybki start API](/pl/quickstart) — wykonaj pierwsze połączenie z agentem
    AI.
  </Step>
  <Step title="Wybierz przewodnik">
    Skorzystaj z [przewodnika instruktażowego](/pl/guides/build-an-agent) dla
    swojego scenariusza lub przejdź do
    [dokumentacji API](/api-reference/introduction).
  </Step>
</Steps>

## Przeglądaj przewodniki

<CardGroup cols={2}>
  <Card title="Korzystanie z panelu" icon="table-columns" href="/pl/guides/build-an-agent">
    Utwórz agenta, zasil konto, uzyskaj numer, symuluj i sprawdzaj połączenia.
  </Card>
  <Card title="Połącz narzędzia i dane" icon="plug" href="/pl/guides/connect-apps">
    Aplikacje OAuth, niestandardowe API, serwery MCP i dostawcy VoIP.
  </Card>
  <Card title="Analizuj i ulepszaj" icon="chart-line" href="/pl/guides/reports">
    Raporty, obserwowalność, eksperymenty, problemy i alerty.
  </Card>
  <Card title="Zespół i konto" icon="users" href="/pl/guides/invite-your-team">
    Zaproszenia i role, klucze API, bezpieczeństwo i SSO.
  </Card>
</CardGroup>

## Bazowy adres URL

```
https://api.thunderphone.com/v1
```

Uwierzytelnianie używa standardowego schematu OAuth 2.0 Bearer z kluczem API organizacji
`sk_live_`. Twój klucz automatycznie identyfikuje docelową
organizację — ścieżki URL nie zawierają identyfikatora organizacji. Szczegóły znajdziesz w sekcji
[Uwierzytelnianie](/api-reference/introduction).

<Note>
  Potrzebujesz pomocy? Napisz na adres [support@thunderphone.com](mailto:support@thunderphone.com).
</Note>