---
title: "Instalacja widgetu na stronie krok po kroku | Voicedot"
description: "Podaj adres strony, odbierz skrypt i dodaj go sam, przez programistę lub razem z Piotrem. Działa z HTML, React, Webflow i Framerem."
url: https://voicedot.ai/pl/dokumentacja/instalacja
language: pl
updated: 2026-11-05
alternates:
  en: https://voicedot.ai/en/docs/install.md
index: https://voicedot.ai/llms.txt
---

# Dodaj Voicedot do swojej strony.

*Dokumentacja · Instalacja*

Onboarding prowadzi Cię od adresu strony do pierwszej uwagi w Twojej skrzynce.

Potrzebujesz tylko adresu strony. Instalację możesz zlecić swojemu agentowi AI, dodać skrypt sam, przekazać go programiście, zainstalować razem z Piotrem albo wrócić do niego później.

[Zleć to agentowi](<https://voicedot.ai/pl/dokumentacja/instalacja#agent-install>)

<a id="agent-install"></a>

## Voicedot zainstaluje Twój agent AI

*Instalacja przez agenta*

Wklej jedno zdanie agentowi pracującemu w repozytorium Twojej strony, na przykład Claude Code, Codexowi albo Cursorowi. Zapyta o e-mail i adres strony, zainstaluje widget i sprawdzi, czy działa. Ty potwierdzasz w jednym mailu i wysyłasz pierwszą uwagę.

- Agent nie akceptuje regulaminu, nie wybiera planu i nie wysyła uwag za Ciebie.
- Strona musi działać przez HTTPS, także lokalnie.

**Nie mam jeszcze konta**

Polecenie dla agenta

Skonfiguruj Voicedot do zbierania uwag na tej stronie według kroków z https://voicedot.ai/agent-setup/prompt.md (to zwykła strona do przeczytania, nic do pobrania ani uruchomienia).

Agent tylko czyta stronę z linku. Nic nie pobiera i nie uruchamia

1. Agent

   Pyta o Twój e-mail i dokładny adres strony, potem wysyła do Voicedot prośbę o konto.
2. Ty

   Otwierasz mail od Voicedot, klikasz „Potwierdzam”, a potem „Zgadzam się”. To akceptacja regulaminu, potem widzisz postęp instalacji.
3. Agent

   Dodaje widget do strony, pyta Cię przed publikacją i czeka, aż Voicedot zobaczy go na działającej stronie.
4. Ty

   Zostawiasz pierwszą uwagę na swojej stronie. Nowe konto ma 21 dni pełnego planu Team, bez karty.

**Mam już konto**

### W panelu Voicedot

W kroku instalacji wybierz instalację przez agenta i skopiuj polecenie. Prowadzi agenta do strony instalacji Twojej witryny, bez pobierania i uruchamiania czegokolwiek.

### Przez MCP

Agent może dodać projekt do Twojej przestrzeni, gdy pozwalają na to plan i nadane uprawnienia. Po instalacji sprawdzi działanie widgetu pod dokładnym adresem strony.

Polecenie dla agenta z MCP

Dodaj w Voicedot projekt dla strony z tego repozytorium, zainstaluj widget we wspólnym layoucie i sprawdź go w przeglądarce. Ustal dokładny adres strony z konfiguracji; jeśli nie jest jasny, zapytaj mnie.

Wklej polecenie agentowi pracującemu w repozytorium Twojej strony.

<a id="add-domain"></a>

## Podaj adres strony

Podaj dokładny adres strony, na której ma działać widget, np. https://twojastrona.pl. Widget wymaga HTTPS także lokalnie; dla localhost potrzebujesz certyfikatu. twojastrona.pl i www.twojastrona.pl to osobne adresy. Każdy używany host i port dodaj osobno do projektu.

Adres możesz poprawić, dopóki skrypt nie połączy się ze stroną.

<a id="copy-snippet"></a>

## Załóż konto i odbierz skrypt

Załóż konto przez Google albo e-mailem, bez hasła. Przy każdym logowaniu dostajesz link. Onboarding tworzy wtedy projekt i skrypt dla Twojej domeny.

**Właściwy kod skopiuj ze swojego projektu.**

Budowa skryptu (przykład)

```
<script>
  window.VOICEDOT_CONFIG = {"siteId": "…", "preset": "feedback", …};
</script>
<script async src="https://app.voicedot.ai/widget/v1/voicedot.js"></script>
```

To przykład budowy skryptu, nie działający kod do instalacji.

<a id="add-snippet"></a>

## Wybierz sposób instalacji

Onboarding pyta, jak chcesz dodać skrypt do strony: samodzielnie, z agentem, ze swoim programistą, podczas rozmowy z Piotrem albo później, korzystając z instrukcji wysłanej e-mailem. Możesz zmienić wybór.

### Zlecam instalację agentowi

Masz konto: w kroku instalacji w panelu wybierz instalację przez agenta i wklej mu skopiowane instrukcje. Nie masz konta: wystarczy jedno polecenie, a agent założy konto i zainstaluje widget.

[Zobacz polecenie dla agenta](<https://voicedot.ai/pl/dokumentacja/instalacja#agent-install>)

### Zainstaluję sam

Skopiuj skrypt i umieść go tuż przed znacznikiem zamykającym ` </body> ` albo dodaj go przez ustawienia własnych skryptów lub menedżera tagów. Działa na każdej stronie: czysty HTML, React, Webflow, Framer. Opublikuj zmianę.

Nie musisz przebudowywać strony. Musisz mieć prawo dodać skrypt i konfigurację, która pozwala go załadować.

### Potrzebuję pomocy z instalacją

Umów rozmowę z Piotrem, do 30 minut. Instalujecie skrypt razem, przy udostępnionym ekranie, na dowolnej technologii. Miej pod ręką dostęp do kodu strony albo CMS-a.

### Zajmie się tym mój programista

Wpisz e-mail osoby, która zarządza stroną. Voicedot wyśle jej skrypt z instrukcją krok po kroku, a status instalacji zobaczysz w onboardingu, gdy tylko skrypt zadziała. Wolisz napisać sam? Skopiuj tę wiadomość:

Wiadomość do programisty

```
Dodaj proszę ten fragment kodu Voicedot do sprawdzanej strony.

Strona: [adres do sprawdzenia]
Zakres: [wybrane podstrony lub cały serwis]
Fragment kodu: [wklej pełny kod z projektu Voicedot]

Po publikacji sprawdź, czy widget pojawia się na tych stronach.
Nie zmieniaj pozostałych elementów serwisu.
```

### Zrobię to później

Wyślij skrypt na e-mail konta, z bezpiecznym linkiem powrotu do onboardingu. Możesz też zaplanować jedno przypomnienie: za godzinę, za 3 godziny albo jutro. Przyjdzie tylko wtedy, gdy skrypt nadal nie będzie działał.

Onboarding sam sprawdza, czy skrypt jest na stronie. Gdy go wykryje, status zmienia się na „Połączono”. Możesz też sprawdzić ręcznie.

<a id="test-comment"></a>

## Wyślij pierwszą uwagę

Kliknij „Otwórz moją stronę i wypróbuj Voicedot”. Strona otworzy się w nowej karcie, z widgetem w rogu. Kliknij Nagraj, wskaż miejsce i powiedz albo napisz, co jest nie tak.

Wróć do karty onboardingu. Uwaga pojawi się tam sama. Jeśli już ją wysłałeś, kliknij „Sprawdź ponownie”.

Zacznij od tekstu. Działa bez mikrofonu. Głos jest w okresie próbnym i w płatnych planach.

<a id="confirm"></a>

## Sprawdź, że dotarła

Po wysłaniu widget potwierdza na stronie: „Wiadomość wysłana”. Przycisk „Kontynuuj konfigurację” prowadzi z powrotem do onboardingu.

Tam zobaczysz swoją uwagę tak, jak zobaczysz każdą kolejną: stronę, wskazane miejsce, Twoje słowa i kategorię. To znak, że pętla uwag działa.

Test dotarł? Zaproś klienta, użytkownika lub zespół do prawdziwego przeglądu. Własna wiadomość sprawdza instalację. Ich uwagi dają początek rozmowie o zmianach.

Okres próbny zaczyna się, gdy zakładasz konto: 21 dni pełnego planu Team, bez karty. Potem wybierasz plan.

<a id="troubleshooting"></a>

## Gdy widget się nie pojawia

| Co sprawdzić | Co zrobić |
| --- | --- |
| Opublikowana strona | Upewnij się, że wdrożona strona zawiera cały skrypt. |
| Projekt i domena | Sprawdź, czy projekt jest aktywny, a adres strony odpowiada jego konfiguracji. |
| Ograniczenia skryptów | Sprawdź, czy konfiguracja zgód, polityka bezpieczeństwa treści lub warunki menedżera tagów nie blokują ładowania skryptu. |
| Przeglądarka | Sprawdź błędy w konsoli i wykonaj test bez restrykcyjnej blokady treści. |

Mikrofon jest potrzebny tylko do mówienia. Uwagę można też napisać.

Potrzebujesz pomocy? [Napisz do nas](<https://voicedot.ai/pl/pomoc>) i podaj adres strony, przeglądarkę oraz krok, na którym utknąłeś. Bez haseł, tokenów i prywatnych wiadomości odwiedzających.

<a id="next"></a>

## Po instalacji

[Podłącz agenta programującego](<https://voicedot.ai/pl/dokumentacja/mcp>) lub [przeczytaj o przetwarzaniu danych](<https://voicedot.ai/pl/dane-i-prywatnosc>).
