Models
Push to the user's phone. It is the first kind in the routing fallback order
| Capability | Phone |
|---|---|
input.utterance | Coming soon |
input.tap | Coming soon |
present.notify | Coming soon |
present.display | Coming soon |
ask.choice | Coming soon |
Keys, connecting a user's device, permissions, routing, errors and test mode work the same for every category: see Projects, environments and keys, Connect a device, Permissions and safety, Errors and Test mode. The examples assume a dopl client and a deviceId from the Quickstart.
What your agent receives
Voice transcripts
input.utteranceT1What the user says to the phone, as text.
- Limits
- Set by each device's descriptor. No model in this category is connected yet.
- Permission
- Scope
input.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.
Call
// No call returns input.utterance yet. It is planned as the `input.utterance` webhook.Example response
// Not available yet.Supported on
- PhoneComing soon
Taps
input.tapT1Taps on a screen your agent showed.
- Limits
- Set by each device's descriptor. No model in this category is connected yet.
- Permission
- Scope
input.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.
Call
// No call returns input.tap yet. The contract has no event for it yet.Example response
// Not available yet.Supported on
- PhoneComing soon
What your agent can send
Notify
present.notifyT1A push notification.
- Limits
- Set by each device's descriptor. No model in this category is connected yet.
- Permission
- Scope
present.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.
Call
const { action_id, status } = await dopl.devices.action(deviceId, "present.notify", {
title: "Build finished",
body: "main passed in 4m 12s"
});Example response
{
"action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
"status": "done"
}Supported on
- PhoneComing soon
Show a card
present.displayT1A screen built from display blocks. Long replies that do not fit on glasses go here.
- Limits
- Set by each device's descriptor. No model in this category is connected yet.
- Permission
- Scope
present.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.
Call
const { action_id, status } = await dopl.devices.action(deviceId, "present.display", {
blocks: [
{
id: "title",
type: "heading",
text: "Deploy ready"
}
]
});Example response
{
"action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
"status": "done"
}Supported on
- PhoneComing soon
Ask a question
ask.choiceT1A question with options as notification buttons.
- Limits
- Set by each device's descriptor. No model in this category is connected yet.
- Permission
- Scope
ask.*, ticked by default on the consent screen. At call time: allowed. See Permissions and safety.
Call
const { action_id, status } = await dopl.devices.action(deviceId, "ask.choice", {
question: "Ship it?",
options: [
{
label: "Yes"
},
{
label: "No"
}
]
});Example response
{
"action_id": "a6d1c0b2-7e45-4f19-8c3a-2b9e5d4f7a11",
"status": "done"
}Supported on
- PhoneComing soon