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