Czym są wtyczki
Wtyczki rozszerzają Livespace o zewnętrzne aplikacje webowe, które wyświetlają się bezpośrednio w profilach — szansy sprzedaży, firmy, osoby lub przestrzeni. Dzięki temu użytkownik widzi zewnętrzne narzędzia i dane bezpośrednio przy szansie sprzedaży, firmie czy osobie, nad którą pracuje — bez przełączania się między systemami.
Możliwości są praktycznie nieograniczone: od prostego kalkulatora, przez integrację z systemem księgowym, po dedykowany panel zbudowany specjalnie pod Twoje procesy.
Bardziej technicznie: wtyczka osadza zewnętrzną aplikację webową jako widget <iframe> wewnątrz profilu w Livespace: szansy sprzedaży, firmy, osoby lub przestrzeni. Widget otrzymuje dane bieżącego rekordu oraz, gdy jest to potrzebne, tymczasowe dane uwierzytelniające do API Livespace, przekazywane przez przeglądarkowe postMessage API.
Ten przewodnik przeprowadzi Cię przez pełny cykl życia wtyczki: Tworzenie, dodawanie, aktywację, edycję oraz usuwanie.
Spis treści:
Tworzenie wtyczek
Każda wtyczka to zewnętrzna aplikacja webowa osadzona w profilu jako ramka <iframe>. Gdy użytkownik otworzy profil, na którym wtyczka jest skonfigurowana, Livespace przekazuje do niej dane bieżącego rekordu — konkretnej szansy sprzedaży, firmy, osoby lub przestrzeni — a w razie potrzeby także tymczasowe dane dostępowe do API Livespace. Dzięki temu aplikacja rozpoznaje kontekst, w którym została otwarta, i może wyświetlić informacje dopasowane do tego rekordu.
Wymiana danych odbywa się przez przeglądarkowy mechanizm postMessage, który zapewnia bezpieczną komunikację między Livespace a osadzoną aplikacją bez konieczności przeładowywania strony. W praktyce oznacza to podział odpowiedzialności: konfiguracja wtyczki — nazwa, adres URL, miejsce i zakres wyświetlania — leży po stronie administratora konta, natomiast sposób wykorzystania przekazanego kontekstu zależy od twórcy aplikacji.
Pełną specyfikację komunikatów i danych przekazywanych do wtyczki znajdziesz w dokumentacji technicznej dla developerów.
Zarządzanie wtyczkami (dodawanie, edytowanie, usuwanie)
WAŻNE - Wymagania dotyczące URL: Adres URL musi używać HTTPS, a domena musi znajdować się na liście dozwolonych domen (allowlist) Livespace. Skontaktuj się z supportem aby dodać swoją domenę do allowlisty.
Dodawanie wtyczki
Przejdź do Ustawień konta -> Wtyczki w menu po lewej stronie. Zobaczysz ekran z możliwością dodania pierwszej wtyczki lub listę wszystkich wtyczek na Twoim koncie, jeśli zostały już utworzone.
Jeśli to Twoja pierwsza wtyczka kliknij Dodaj pierwszą wtyczkę.
2. Wypełnij formularz:
Nazwa — etykieta widoczna dla administratorów (np. „Kalkulator ofert").
URL — pełny adres HTTPS aplikacji, którą chcesz osadzić.
Gdzie wyświetlać — wybierz jeden typ profilu: Szanse sprzedaży, Firmy, Osoby lub Przestrzenie.
WAŻNE: Jeśli wybierzesz Szanse sprzedaży, poniżej pojawi się pole wyboru Procesów sprzedażowych, na którym będzie wyświetlana wtyczka. Widget pojawi się wyłącznie na szansach sprzedaży, których aktywny proces sprzedaży odpowiada Twojemu wyborowi. Jest to przydatne, gdy różne zespoły lub przepływy pracy korzystają z różnych narzędzi.
Umiejscowienie wtyczki — dla każdego wybranego typu profilu kliknij + obok sekcji, w której ma pojawić się widget. Widget zostanie wstawiony pomiędzy te sekcje. Wtyczki można również umieścić w wysuwanym panelu bocznym.
Wysokość okna — wybierz Małą (240px), Średnią (380px) lub Dużą (520px).
WAŻNE: Jeśli nie wybierzesz żadnego umiejscowienia, widget nie będzie widoczny na żadnym profilu, a na liście wtyczek zobaczysz status Nieprzypisana:
Kto widzi tę wtyczkę — wybierz “Wszyscy z dostępem do szansy” lub “Tylko wybrane role”. Przy ograniczaniu wg roli Administrator jest zawsze uwzględniony; opcjonalnie dodaj Managera i/lub Użytkownika.
WAŻNE: Jeśli na koncie masz ustawione własne role, każda taka rola będzie traktowana w ustawieniach wtyczki jako Użytkownik.
3. Kliknij Dodaj wtyczkę.
Edycja wtyczki
Otwórz menu wtyczki i wybierz Edytuj.
Zaktualizuj potrzebne pola — nazwę, URL, umiejscowienie, wysokość okna, typy obiektów, widoczność wg ról lub zawężenie do procesów sprzedaży.
Kliknij Zapisz.
Zmiany zaczynają obowiązywać natychmiast.
Usuwanie wtyczki
Otwórz menu kontekstowe wtyczki i wybierz Usuń.
Potwierdź usunięcie.
Usunięte wtyczki są trwale usuwane i nie można ich przywrócić.
Wygląd widgetu wtyczki w Livespace
Podczas ładowania widgetu w jego miejscu wyświetlany jest wskaźnik ładowania:
Gdy wtyczka jest aktywna, pojawi się jako osadzony widget w miejscu skonfigurowanym przez administratora. Widget jest wyświetlany na wszystkich typach profili wybranych podczas konfiguracji: Szansa sprzedaży, Firma, Osoba oraz Przestrzeń:
Dostępność wtyczek (limity ilości wtyczek per pakiet)
Wtyczki są dostępne na planach Automation, Growth oraz Professional.
Obowiązują limity dodanych wtyczek:
Automation - 1 wtyczka
Growth - 3 wtyczki
Professional - 5 wtyczek
Aby wykupić większy limit wtyczek na koncie skontaktuj się z naszym wsparciem technicznym na czacie lub mailowo na [email protected]