Phones Coming soon

Notifications, screens and questions on your user's phone

Models

PhonePlanned

Push to the user's phone. It is the first kind in the routing fallback order

CapabilityPhone
input.utteranceComing soon
input.tapComing soon
present.notifyComing soon
present.displayComing soon
ask.choiceComing 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.utteranceT1

What 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.tapT1

Taps 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.notifyT1

A 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.displayT1

A 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.choiceT1

A 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