AssistantCanvas

The assistantCanvas object is the interface to your conversational action that is made available within your web app.

Methods

ready

ready(callbacks) returns undefined

Called by the Interactive Canvas web app once it has loaded to register callbacks.

Parameters
callbacks AssistantCanvasCallbacks

An object that contains method callbacks.

sendTextQuery

sendTextQuery(textQuery) returns undefined

Sends a text query to the conversational action.

Parameters
textQuery string

The query to send to the conversational action.

AssistantCanvasCallbacks

These callbacks provide a way for you to respond to information or requests from your conversational action while the methods provide a way to send information or requests to your conversational action.

onUpdate

onUpdate(state) returns undefined

Called when an ImmersiveResponse is sent from the conversational action. After the end of the function call, the TTS will start immediately.

Parameters
state Object

Updated data sent by the webhook.

onTtsMark

onTtsMark(markName) returns undefined

Callback that is invoked during TTS playback.

Special marks that always are triggered:

  • START indicates the start of the TTS.
  • END indicates the end of the TTS.
  • ERROR indicates an error playing the TTS.

You can also define custom marks by using SSML and the <mark> tag like <mark name="custom">

Parameters
markName string

Mark name invoked during TTS playback.