Dokumentacja

Framer

Dodaj agenta do witryny Framer za pomocą funkcji Custom Code.

Dodaj swojego agenta AI do witryny Framer za pomocą funkcji Custom Code. Fragment kodu ładuje się na każdej stronie po opublikowaniu.

Najpierw pobierz kod do osadzenia z zakładki Agent > Publikuj w panelu.

Szybka konfiguracja

  1. Otwórz swój projekt we Framer.
  2. W lewym pasku bocznym kliknij Project Settings (ikona koła zębatego).
  3. Wybierz zakładkę Custom Code.
  4. Kliknij + Add Script.
  5. Nadaj skryptowi rozpoznawalną nazwę (np. Agentkit Widget).
  6. Wklej kod do osadzenia w treści skryptu.
  7. W sekcji umiejscowienia wybierz End of <body> tag (Body End) — to zalecana opcja dla widżetów czatu.
  8. Wybierz ładowanie na All pages.
  9. Kliknij Save.
  10. Kliknij Publish w prawym górnym rogu, aby opublikować zmiany.

Przykładowy format (użyj rzeczywistych wartości z Agent > Publikuj):

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>

Dlaczego koniec <body>, a nie head

Framer dzieli Custom Code na Head Code i End of <body> Code. Widżety czatu powinny trafiać na koniec <body>, aby nie opóźniać pierwszego renderowania strony — to również odpowiada atrybutowi async w skrypcie.

Head Code jest zarezerwowany dla elementów, które muszą uruchomić się bardzo wcześnie, takich jak piksele analityczne czy wstępne ładowanie czcionek.

Instalacja na wybranej stronie

Aby załadować widżet tylko na wybranych stronach:

  1. Wybierz stronę w panelu warstw Framer.
  2. Otwórz Page Settings (panel po prawej stronie).
  3. Dodaj tam Custom Code zamiast w Project Settings.

Kod na poziomie strony działa tylko na tej konkretnej stronie.

Plany i domeny

  • Custom Code jest dostępny na stronach Framer, ale uruchomienie go na domenie niestandardowej (innej niż *.framer.website) zwykle wymaga płatnego planu.
  • Widżet działa pod domyślnym adresem *.framer.website, jeśli Twój plan zezwala tam na Custom Code.

Po opublikowaniu

Custom Code w Framer nie działa w edytorze ani w podglądzie — tylko na opublikowanej stronie. Po kliknięciu Save kliknij Publish, a następnie otwórz aktywny adres URL.

Rozwiązywanie problemów

Widżet nie pojawia się w podglądzie edytora.

  • Tak ma być. Custom Code działa wyłącznie na opublikowanej stronie.

Widżet nie pojawia się także na opublikowanej stronie.

  • Upewnij się, że kliknięto zarówno Save, jak i Publish.
  • Upewnij się, że Twoja domena jest dozwolona w Agent > Publikuj > Zabezpieczenia.
  • Wykonaj twarde odświeżenie (⌘+Shift+R), aby pominąć pamięć podręczną CDN.

Widżet miga, a następnie znika.

  • Sprawdź, czy Framer nie stosuje przejść między stronami lub animacji, które mogą ponownie ładować DOM. Widżet powinien montować się ponownie przy każdym załadowaniu strony — jeśli tak się nie dzieje, skontaktuj się z pomocą techniczną.

Testowanie

  1. Otwórz opublikowany adres URL w oknie incognito.
  2. Sprawdź, czy widoczny jest dymek czatu.
  3. Kliknij, aby go otworzyć, i wyślij testową wiadomość.

Kolejne kroki