Documentation sections

For developers

Integrate an external product

Connect a website or customer account to Web Chat, signed context, read capabilities, and confirmed actions.

Updated: August 11, 2026

01

Architecture

textKanyman docs
external product
  → Web Chat v4
  → signed context snapshot
  → Kanyman AgentContext
  → read capability or action draft
  → administrator confirmation
  → reply or operator handoff

The snapshot answers who the user is and where they are. A tool retrieves only current data that was not included in the snapshot. Project documentation explains product rules but does not replace the state of a specific user.

02

Connection order

  1. 1Create an active Web Chat channel and link it to an agent.
  2. 2Register the external application, Origin, issuer, audience, and public key.
  3. 3Describe the data object with a closed JSON Schema.
  4. 4Validate a short-lived test JWT.
  5. 5If needed, add a read-only HTTP tool and activate it with a safe test.
  6. 6To change data, add a draft capability; Kanyman will require confirmation and an Idempotency-Key.
  7. 7Install kanyman-chat.v6.js and pass the JWT only from the product’s server-side environment.
  8. 8Run end-to-end UAT with a real operator.
03

Trust boundaries

  • The browser transports context but does not create or sign it.
  • The model does not control subject, integration_id, or external entities.
  • Tool secrets are never exposed to the model, widget, or operator.
  • Any data from the external product is treated as data, not as model instructions.

Continue reading

Integrate an external product — Kanyman Docs