Przejdź do treści
Convor
Convor Docs
Pierwsze kroki

Instalacja

Dodaj widget Convor do strony jednym tagiem script.

Widget Convor działa na każdej stronie internetowej i nie wymaga instalacji po stronie serwera. Skopiuj kod z Ustawienia → Widget → Instalacja i bezpieczeństwo i wklej go przed zamykającym znacznikiem </body>.

Produkcyjny kod zawiera adres skryptu oraz publiczny klucz widgetu. Sam skrypt korzysta z właściwych usług Convor, więc nie dodawaj do niego ręcznie adresów API, iframe ani połączenia realtime.

HTML i strony statyczne

<!doctype html>
<html lang="pl">
  <body>
    <!-- Treść strony -->

    <script
      src="https://cdn.convor.io/widget.js"
      data-key="convor_wpk_..."
      async
    ></script>
  </body>
</html>

React i Next.js

Dodaj skrypt w głównym layoucie:

import Script from "next/script";

export default function RootLayout({children}: {children: React.ReactNode}) {
  return (
    <html lang="pl">
      <body>
        {children}
        <Script
          src="https://cdn.convor.io/widget.js"
          data-key="convor_wpk_..."
          strategy="afterInteractive"
        />
      </body>
    </html>
  );
}

Vue i Nuxt

Dodaj skrypt raz po zamontowaniu aplikacji:

<script setup>
onMounted(() => {
  if (document.querySelector('script[src="https://cdn.convor.io/widget.js"]')) {
    return;
  }

  const script = document.createElement("script");
  script.src = "https://cdn.convor.io/widget.js";
  script.dataset.key = "convor_wpk_...";
  script.async = true;
  document.body.appendChild(script);
});
</script>

WordPress i Shopify

W WordPressie dodaj kod wygenerowany w panelu przed zamykającym </body> za pomocą motywu lub mechanizmu do wstawiania skryptów. W Shopify przejdź do Online Store → Themes → Edit Code, otwórz theme.liquid i wklej kod przed </body>.

Ważne

data-key jest wymagany. Zastąp convor_wpk_... publicznym kluczem widgetu z panelu. Klucz może być widoczny w kodzie strony i nie jest tajnym kluczem API organizacji.

Przed testem

Otwórz Strony, wybierz stronę i dodaj bieżący hostname do jej dozwolonych domen. Poprawny kod osadzania nie wyświetli widgetu na niedozwolonym hoście. localhost dodawaj tylko na czas lokalnych testów własnej aplikacji.

Dokładne ustawienia Content Security Policy oraz przykłady programowego ładowania i zmiany języka w SPA znajdziesz w Dostosuj widget przed publikacją i Widget JavaScript API.

Czy ta strona była pomocna?

On this page