Dokumentacja

Świadomość strony

Świadomość strony pozwala Twojemu agentowi AI wiedzieć, na której stronie znajduje się obecnie odwiedzający. Umożliwia to bardziej trafne, kontekstowe odpowiedzi i dostarcza bogatszego kontekstu podczas eskalacji do operatorów.

Świadomość strony działa tylko z widgetem webowym. Telegram i inne kanały komunikatorów nie mają pojęcia "bieżącej strony".

Przegląd#

Po włączeniu widget automatycznie zbiera adres URL, tytuł i opis bieżącej strony odwiedzającego. Ten kontekst jest wstrzykiwany do promptu systemowego AI, co pozwala jej dostosować odpowiedzi do miejsca, które przegląda użytkownik.

Kontekst strony

Agent widzi adres URL, tytuł i opis meta bieżącej strony

Kontekst eskalacji

Operatorzy otrzymują informacje o bieżącej stronie odwiedzającego przy eskalacji

Jak to działa#

Widget przechwytuje kontekst strony automatycznie — nie są wymagane żadne zmiany kodu na Twojej stronie. Oto co jest zbierane z każdą wiadomością:

DaneŹródłoPrzykład
Adres URL stronywindow.location.hrefhttps://example.com/pricing
Tytuł stronydocument.titlePricing — Acme Corp
Ścieżkawindow.location.pathname/pricing
Opismeta[name=description]Compare our plans
Odsyłaczdocument.referrerhttps://google.com

Przykład: co widzi agent#

Gdy odwiedzający na /pricing pyta "Ile to kosztuje?", prompt systemowy agenta zawiera:

Wstrzyknięte do promptu systemowegotext
PAGE CONTEXT (where the user is right now):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Compare our plans and pricing

Use this page context to provide more relevant, page-specific answers.

Konfiguracja#

Świadomość strony to funkcja opcjonalna. Aby ją włączyć:

  1. Przejdź do Kanały i wybierz swój kanał Widget
  2. W panelu ustawień/wyglądu kanału włącz przełącznik Świadomość strony („Widget informuje agenta, na której stronie znajduje się odwiedzający”)
  3. Zapisz zmiany
Nie są potrzebne żadne zmiany w kodzie osadzenia widgetu. Widget automatycznie wysyła kontekst strony po włączeniu tej funkcji dla agenta.

Kontekst eskalacji#

Gdy rozmowa jest eskalowana do operatora, e-mail z powiadomieniem o eskalacji automatycznie zawiera kontekst bieżącej strony odwiedzającego. Operator widzi dokładnie, gdzie odwiedzający przeglądał, bez konieczności pytania.

E-mail eskalacyjny zawiera:

E-mail eskalacyjny

Temat: [YourBrand] Conversation Escalated

Nagłówek: "Case #123 needs a human" (albo "A customer needs a human", gdy nie ma numeru sprawy)

Treść: "A customer has been transferred to a human agent. Please review and respond." — a po niej cytowany blok z ostatnią wiadomością klienta i jego imieniem

Tabela faktów: Channel: Widget · Page: Pricing — Acme Corp · Page URL: https://example.com/pricing

Open conversation — przycisk prowadzący prosto do rozmowy w panelu

Kontekst strony w eskalacji jest dołączany automatycznie zawsze, gdy włączona jest Świadomość strony — nie ma osobnego przełącznika.

Rozwiązywanie problemów#

Jeśli Świadomość strony nie wydaje się działać, sprawdź następujące kwestie:

Agent udziela ogólnych odpowiedzi, ignorując bieżącą stronę

Upewnij się, że Świadomość strony jest włączona dla Twojego kanału Widget (Kanały → Widget → panel ustawień/wyglądu) oraz że zmiany zostały zapisane. Funkcja jest domyślnie wyłączona.

E-mail eskalacyjny nie zawiera sekcji kontekstu strony

Upewnij się, że Świadomość strony jest włączona dla Twojego kanału Widget i zapisana. Potwierdź także, że przełącznik Alerty eskalacji jest włączony w ustawieniach agenta (domyślnie jest wyłączony). E-maile alertów trafiają do członków Twojej przestrzeni roboczej — przypisanego członka zespołu lub zespołu przypisania — zgodnie z preferencjami powiadomień każdego z nich; nie ma osobnego adresu e-mail do eskalacji.

Tytuł strony pokazuje błędną wartość

Widget odczytuje document.title w momencie, gdy użytkownik wysyła wiadomość. Jeśli Twoja strona aktualizuje tytuł po pierwszym renderowaniu (np. asynchronicznie), widget przechwytuje to, co jest ustawione w chwili wysłania.