Feature referenceDeveloper integration · 03 of 05

Developer integration

Private page context

Private page context gives a rep or AI Stand-in facts and instructions from the host page without presenting that context as something the visitor typed.

Availability
All plans
Configured in
Website HTML → prompt on stand-button or stand-card; or website JavaScript → StandChat.openChat(..., { prompt })
Category
Developer integration
Reference status
Current
01

What private page context is

A page often knows why a visitor is opening chat: the plan they are comparing, the form they are completing, the product they selected, or the kind of interview the team wants the Stand-in to conduct. A prompt sends that context into the new Stand session without adding a visitor-authored message.

An AI Stand-in uses the prompt as session-specific guidance alongside team, site, and Stand-in instructions. A human rep can inspect it in the authenticated conversation view and History. The visitor does not see it in the public transcript.

Private means hidden from the visitor interface—not transient, encrypted for a special recipient, or exempt from conversation retention.

02

Supply context from a supported entry point

A pricing-specific Stand button
<stand-button
  hidden
  message="I can help compare plans. What would you like to know?"
  prompt="The visitor opened chat from the pricing comparison. Ask about team size and expected chat volume before recommending a plan."
>
  Ask about plans
</stand-button>

The message is visible to the visitor. The prompt is responder context.

Entry pointHow to supply itWhen it is attached
Stand buttonAdd a prompt attribute to <stand-button>.When that button opens a new session.
Stand cardAdd a prompt attribute to <stand-card>.When the card’s marked action opens a new session.
JavaScript APIUse the third string argument to openChat(...) or options.prompt.When that API open request creates a new session.
03

How Stand uses and stores it

  • Stand attaches the prompt when it creates the session initiated by that entry point.
  • For AI conversations, the prompt supplies facts and task guidance but does not become a visitor turn or determine the visitor’s language.
  • For human conversations, authorized reps can read the context so they understand the page-specific intent.
  • The context remains associated with the conversation according to the organization’s retention settings.
  • The visitor’s actual form or textarea text should be sent separately as visitorMessage when it is meant to appear in the transcript.
04

Write context that changes the response

  • State the page or workflow the visitor came from and any already-known selections.
  • Tell the responder what to clarify before answering or recommending an option.
  • Separate facts from instructions: for example, “Selected plan: Pro. Ask about team size before comparing.”
  • Keep it specific to this activation. Reusable organization policy belongs in team, site, or Stand-in instructions.
  • Do not claim facts the page cannot actually know or use prompt text as a substitute for authorization checks.
05

Visibility and privacy boundary

SurfaceWhat happens
Visitor chatThe prompt is not rendered as a visitor message.
AI Stand-inIt is supplied as private session context for the response.
Live rep and HistoryAuthorized team members can inspect the retained context with the conversation.
Public page sourceLiteral prompt attributes are part of the website HTML and can be inspected by a visitor. Generate dynamic values accordingly.
06

Timing and limitations

  • Context applies to the session created by the activating button, card, or API request; it does not rewrite an already active conversation.
  • It cannot authenticate the visitor or grant permission to reveal account-specific information.
  • It does not replace knowledge sources for reusable product documentation or team instructions for organization-wide behavior.
  • It does not appear as evidence that the visitor personally said or confirmed the supplied facts.