Set Up User Context on Squarespace

What You're Setting

User Context is a client-side JavaScript object. On every page where the widget loads for a logged-in user, you attach an object to window.Asyntai.userContext describing who they are. The widget sends this with each message, so the AI can reply with their name, order status, plan tier, or anything else relevant.

Keys act as labels the AI sees, so make them descriptive — use "Customer name" or "Loyalty points", not just "name" or "points".

window.Asyntai = window.Asyntai || {};
window.Asyntai.userContext = {
  "Customer name": "Sarah Chen",
  "Email": "sarah@example.com",
  "Subscription plan": "Pro",
  "Loyalty points": 1840,
  "Last order": "#8847, out for delivery"
};

Two ways to set it

Either assign synchronously (if data is already on the page), or provide a fetcher that runs when the chat opens. The second option is better for performance — user data is only loaded when someone actually opens the chat.

// Option A — synchronous (data already available)
window.Asyntai.userContext = { "Customer name": "Sarah", ... };

// Option B — async fetch on chat open (better performance)
window.Asyntai.fetchUserContext = function() {
  return fetch('/api/chat-context/')
    .then(r => r.json())
    .then(data => { window.Asyntai.userContext = data; });
};

How Squarespace Exposes the User

If you're using Squarespace Member Areas (available on Business+ plans), the logged-in member's basic info is exposed in the global Static.SQUARESPACE_CONTEXT.authenticatedAccount object on pages where the member is signed in. This includes email and display name.

Squarespace does not expose detailed member data (membership tier, subscription info) directly client-side — for richer fields, use Option 2 with the Member Accounts API and a proxy.

Option 1 — Code Injection (Member Areas only)

<script>
(function() {
  var ctx = window.Static && Static.SQUARESPACE_CONTEXT;
  var account = ctx && ctx.authenticatedAccount;
  if (!account) return;  // visitor not signed in

  window.Asyntai = window.Asyntai || {};
  window.Asyntai.userContext = {
    "Name":  account.displayName || '',
    "Email": account.email || '',
    "Account ID": account.id || ''
  };
})();
</script>

Option 2 — Proxy for Richer Data

For membership tier, subscription status, or commerce customer data, build a tiny external proxy that queries Squarespace's Member Accounts API or Commerce API (both require an OAuth-authenticated bearer token).

<script>
window.Asyntai = window.Asyntai || {};
window.Asyntai.fetchUserContext = function() {
  var account = window.Static && Static.SQUARESPACE_CONTEXT
    && Static.SQUARESPACE_CONTEXT.authenticatedAccount;
  if (!account) return Promise.resolve();

  return fetch('https://your-proxy.example.com/user-context?account=' + account.id)
    .then(r => r.json())
    .then(data => { window.Asyntai.userContext = data; });
};
</script>

Your proxy calls the Squarespace Member Accounts API (GET /api/v1.0/members-accounts-api/profiles/{account_id}) with a stored bearer token, reshapes the response, and returns it.

Устранение неполадок