Tworząc sesję, możesz przekazać kontekst użytkownika. Asystent bierze go pod uwagę w całej rozmowie. Kontekst może zawierać:

  • dane użytkownika (np. imię, identyfikator),
  • bieżącą stronę lub kategorię,
  • preferencje i zainteresowania,
  • historię przeglądania,
  • dowolne inne pola.

Dodaj pole context do treści żądania tworzącego sesję:

const userContext = {
  user_id: "user_12345",
  first_name: "Alex",
  current_page: "Category: Sports",
  viewed_categories: ["footwear", "sport", "electronics"],
  preferences: { interests: ["running", "mountain biking"] }
};

const res = await fetch('https://widget-api.prosecaptain.com/api/v2/widget/thread', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer TWOJ_TOKEN'
  },
  body: JSON.stringify({ widget_id: 'ID_WIDZETU', context: userContext })
});
const { session_id } = await res.json();

Gdy wznawiasz istniejącą sesję (session_id) z nowym context, kontekst zostanie zaktualizowany.

Kontekst strony

Do każdej wiadomości możesz dołączyć page_context, czyli informacje o stronie, na której jest użytkownik. Widżet robi to sam, gdy w ustawieniach włączysz Wyciągaj kontekst strony.

{
  "session_id": "session_xyz789",
  "message": "Czy ten model ma wersję damską?",
  "page_context": {
    "url": "https://sklep.pl/buty/run-pro",
    "title": "Run Pro – buty do biegania",
    "content": "Tekst strony, maksymalnie ok. 5000 znaków…",
    "meta": { "description": "Lekkie buty do biegania po asfalcie" }
  }
}

Prywatność danych

Nie wysyłaj wrażliwych danych osobowych, takich jak pełne imię i nazwisko, e-mail, numer telefonu czy adres. Używaj identyfikatorów, pseudonimów lub danych częściowych.