Canvas Interaction Event

{
  "message_type": "canvas",
  "event_type": "canvas.interaction",
  "conversation_id": "c123456",
  "timestamp": "2026-06-09T21:14:03.498Z",
  "properties": {
    "conversation_id": "c123456",
    "interaction_id": "ci_call_8f2d41_submit_5e0b7c2a",
    "tool_call_id": "call_8f2d41",
    "component": "canvas.question",
    "component_version": "v1",
    "type": "submit",
    "value": {
      "selected_option_ids": [
        "opt_2"
      ],
      "skipped": false
    },
    "metadata": {
      "client": "kiosk-web"
    },
    "created_at": "2026-06-09T21:14:03.518923"
  }
}

See Canvas interactions, webhooks, and history for recording interactions and fetching history.

Outbound: Tavus delivers a recorded Magic Canvas interaction to your conversation `callback_url`.

Configure Magic Canvas on the PAL first - see Magic Canvas overview. Full interaction rules: Canvas interactions.

message_type

string

canvas for Magic Canvas webhook events.

Example:

"canvas"

event_type

string

canvas.interaction.

Example:

"canvas.interaction"

conversation_id

string

The unique identifier for the conversation.

Example:

"c123456"

timestamp

string

ISO-8601 timestamp with a Z suffix (UTC).

Example:

"2026-06-09T21:14:03.498Z"

properties

object

A recorded Canvas interaction. Returned by List Canvas Interactions and delivered in the properties object of a canvas.interaction webhook.

Show child attributes

Perception Analysis Event CVI App Quickstart

⌘I

Outbound: Tavus delivers a recorded Magic Canvas interaction to your conversation callback_url.

Outbound: Tavus delivers a recorded Magic Canvas interaction to your conversation `callback_url`.