Zainstaluj fragment kodu do osadzania
Dodaj widżet ISMS Copilot Assistants do swojej witryny za pomocą skryptu ładowania i listy dozwolonych domen.
Struktura fragmentu kodu
W konsoli wyświetla się gotowy do wklejenia fragment kodu. Koncepcyjnie wygląda on następująco:
<script src="https://embed.ismscopilot.com/loader.js"></script>
<script>
IsmsCopilotEmbed.init({
partnerId: "<your-partner-id>",
publicKey: "<public-key-from-console>",
// Zaawansowana ścieżka partnera zamiast publicKey:
// token: "<end-user JWT from your backend>",
// opcjonalne: title, language ("en"), position ("right" | "left"),
// theme: { "--ic-accent": "#4D4CD7" }
});
</script>Zawsze preferuj fragment kodu wygenerowany przez konsolę. Nazwy pól (publicKey, identyfikator partnera, klucze motywu) mogą się zmieniać; jeśli przykład w dokumentacji różni się od konsoli, decydujące jest to, co pokazuje konsola.
Domeny
Dla ruchu odwiedzających na żywo, dodaj źródła (origins), na których będzie ładowany widżet (Twoja witryna marketingowa, subdomena aplikacji itp.). Ruch z domen, które nie znajdują się na liście dozwolonych, jest odrzucany.
Panel instalacyjny nadal może wyświetlać fragment kodu przed skonfigurowaniem wszystkich domen, dzięki czemu możesz przygotować zmianę; odwiedzający produkcyjni potrzebują listy dozwolonych.
Motywy
Opcjonalne zmienne CSS (na przykład --ic-accent) pozwalają dopasować kolor bańki do Twojej marki. Dokładne klucze pojawiają się w panelu instalacyjnym konsoli.
Zaawansowane: JWT dla użytkowników końcowych
Większym partnerom umożliwiamy tworzenie krótkotrwałych tokenów JWT dla zidentyfikowanych użytkowników końcowych (podpisanych przez partnera, opartych na kid). Ta ścieżka ponownie wykorzystuje ten sam skrypt ładowania z polem token i jest udokumentowana w konsoli platformy, gdy rotujesz tajny klucz podpisywania partnera.
Większość instalacji w trybie samoobsługowym korzysta z publicznej ścieżki z konsoli bez konieczności budowania wydawcy JWT w pierwszym dniu.
Zasilane przez i izolacja
Widżet jest produktem ISMS Copilot. Dane partnerów są izolowane od głównego produktu czatu. Stopka / informacja „zasilane przez” jest zgodna z działającą konsolą i ujawnieniami w Centrum Zaufania.
Nie umieszczaj tajnych kluczy produkcyjnych w publicznych repozytoriach. W przypadku wycieku klucza, dokonaj rotacji w konsoli.