Skip to content
BeeBuzz Docs

Home Assistant

The BeeBuzz Home Assistant integration sends notifications from Home Assistant automations to your BeeBuzz devices.

The integration encrypts locally before upload. It fetches paired BeeBuzz device public keys, encrypts the notification in Home Assistant, then uploads ciphertext to BeeBuzz.

Requirements

Section titled “Requirements”
  • Home Assistant 2024.6.0 or newer
  • a BeeBuzz account
  • an API token
  • at least one paired BeeBuzz device

Install With HACS

Section titled “Install With HACS”

Use the GitHub mirror in HACS:

https://github.com/lucor/beebuzz-home-assistant

Install BeeBuzz, restart Home Assistant, then add the integration from Settings -> Devices & services -> Add integration.

Configure

Section titled “Configure”

The setup form asks for:

  • domain, usually beebuzz.app
  • API token
  • default topic
  • default priority

Self-hosted endpoints must use HTTPS.

When setup completes, Home Assistant fetches the paired BeeBuzz device public keys.

Send With The Notify Entity

Section titled “Send With The Notify Entity”
action: notify.send_message
target:
  entity_id: notify.beebuzz
data:
  title: "Door"
  message: "The front door opened"

Send With BeeBuzz Options

Section titled “Send With BeeBuzz Options”

Use the BeeBuzz action for topic, priority, or attachment options:

action: beebuzz.send_message
data:
  title: "Door"
  body: "The front door opened"
  topic: "#general"
  priority: high

Attachments

Section titled “Attachments”

Supported attachment sources:

  • a local path allowed by Home Assistant
  • a media-source:// URI that resolves to a local file
  • an http:// or https:// URL

Example:

action: beebuzz.send_message
data:
  title: "Camera"
  body: "Motion detected"
  attachment:
    url: "https://example.com/snapshot.jpg"
    filename: "snapshot.jpg"
    mime: "image/jpeg"

Attachments are limited to 1 MiB before encryption.

Device Keys

Section titled “Device Keys”

The integration refreshes BeeBuzz device public keys:

  • during setup
  • periodically
  • when you press Refresh device keys
  • after successful sends when BeeBuzz returns an updated key list

If BeeBuzz returns 401 Unauthorized, Home Assistant starts the standard reauthentication flow.

Common Issues

Section titled “Common Issues”

If Home Assistant cannot send:

  • confirm at least one BeeBuzz device is paired
  • confirm the API token is valid
  • confirm the API token can send to the topic
  • press Refresh device keys
  • check Home Assistant Repairs for BeeBuzz issues