Link from notifications

Intro

Push notifications can open a specific screen in the Zendo app when tapped. For example, a notification about your doorbell can open its live stream directly so you can see who’s there.

Set up

Before you start, make sure you have push notifications set up. If push notifications are already configured, open the Zendo iOS/Android app, tap > Settings > Property > Push Notifications and tap Refresh Settings to make sure Home Assistant has the latest list of available destinations.

List available destinations

To see which destinations are available, call the list_deep_link_destinations service.

Go to Developer Tools > Services in Home Assistant.
Select Zendo: List deep link destinations.
Click Call Service.
The response panel shows the available destinations.

Response format

destinations:
  - id: "securityCamera_abc123"
    destination: "security_camera"
    title: "Front door"
    subtitle: "Camera/Doorbell"
    entityType: "security_camera"
  - id: "securityCamera_def456"
    destination: "security_camera"
    title: "Back garden"
    subtitle: "Camera/Doorbell"
    entityType: "security_camera"

Field	Description
`id`	The identifier you use in automations. This is what you pass to `deep_link_destination`.
`destination`	The type of destination (e.g. `security_camera`).
`title`	The name of the destination (e.g. the camera’s label).
`subtitle`	Secondary description (e.g. “Camera/Doorbell”).
`entityType`	The entity category.

Send a notification that opens a destination

Use the zendo.send_notification service with the deep_link_destination field set to the id of the destination you want to open.

Opening a destination from a notification bypasses Family Sharing (Access Control). The receiver can view and control the accessory even if they wouldn’t normally have access. Make sure you’re sending the notification to the right person.

Example: doorbell notification

A doorbell press is the ideal use case - the notification tells you someone is at the door, and tapping it opens the doorbell camera stream so you can see who it is.

automation:
  - alias: "Doorbell pressed - notify household"
    trigger:
      - platform: state
        entity_id: binary_sensor.doorbell_press
        to: "on"
    action:
      - service: zendo.send_notification
        target:
          entity_id:
            - notify.zendo_owner
            - notify.zendo_bob
        data:
          message: "Someone is at the door"
          interruption_level: "time_sensitive"
          deep_link_destination: "securityCamera_abc123"

When the doorbell is pressed, both people receive a time-sensitive notification. Tapping it opens the Zendo app directly to the doorbell camera’s live stream.

Without a destination

The deep_link_destination field is optional. Omitting it sends a normal notification that opens the default notification view when tapped.

- service: zendo.send_notification
  target:
    entity_id: notify.zendo_owner
  data:
    message: "Someone is at the door"

What happens when a destination can’t be found

The notification always arrives, even if the destination can’t be resolved. The destination is best-effort.

Scenario	What happens
`deep_link_destination` ID not found	Warning logged, notification sent without a destination.
Camera removed after the destination was set	Notification sends with the destination. The Zendo app handles the missing camera gracefully.
`deep_link_destination` field omitted	Normal notification, no destination.

Get started

Your property

Configure accessories

Safety & Security

Share your Zendo

Automate

Monitoring

Home Assistant

Homey

Wall mounting / Counter standing

Device Integration

Link from notifications

Intro

Set up

List available destinations

Response format

Send a notification that opens a destination

Example: doorbell notification

Without a destination

What happens when a destination can’t be found

​Intro

​Set up

​List available destinations

​Response format

​Send a notification that opens a destination

​Example: doorbell notification

​Without a destination

​What happens when a destination can’t be found

Intro

Set up

List available destinations

Response format

Send a notification that opens a destination

Example: doorbell notification

Without a destination

What happens when a destination can’t be found