2025.3.4
首页 ▸ Integrations ▸

Joaoapps Join

The joaoapps_join integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] exposes actions from Join. In Home Assistant, the Joaoapps Join features are divided up in two locations, the Join integration, and the Joaoapps Join notify platform. The notify platform allows us to send messages to Joaoapps Join devices, the integration allows us to access the other special features that Joaoapps Join offers. When in doubt, you can reference the API documentation this is based on.

In the configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file you need to provide the API key and device id or name of the target device. You can find your device id and API key here.

To set it up, add the following information to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file. 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# Example configuration.yaml entry
notify:
  - platform: joaoapps_join
    api_key: YOUR_API_KEY
    device_id: DEVICE_ID
    device_ids: DEVICE_ID_1,DEVICE_ID_2
    device_names: DEVICE_1_NAME,DEVICE_2_NAME
    name: NAME
joaoapps_join:
  - name: NAME_OF_GROUP
    device_id: GROUP.GROUP_NAME
    api_key: YOUR_API_KEY

Configuration Variables

Looking for your configuration file?
api_key string Required

The API key for Join.

device_id string (Optional)

The id of your device or group

device_ids string (Optional)

Comma separated list of device ids or groups.

device_names string (Optional)

Comma separated list of device names.

name string (Optional)

The name parameter is optional but needed if you want to use multiple notification platforms. The platform will be exposed as notify.<name> action. The name will default to notify if not supplied. See the Notifications integration for more details.

Use only one of device_id, device_ids, or device_names, this will determine the notification recipient(s).

# Example configuration.yaml entry
notify:
  - platform: joaoapps_join
    api_key: YOUR_API_KEY
    device_id: DEVICE_ID1
    name: NAME1
  - platform: joaoapps_join
    api_key: YOUR_API_KEY
    device_id: DEVICE_ID2
    name: NAME2

The notify action has several optional parameters: icon, smallicon, image, sound, url, notification_id, category, tts, tts_language and vibration. You can use them like so:

message: Hello from Home Assistant!
title: Home Assistant
data:
  icon: https://goo.gl/xeetdy
  smallicon: https://goo.gl/xeetdy
  vibration: 0,65,706,86,657,95,668,100
  image: https://www.home-assistant.io/images/favicon-192x192-full.png
  sound: https://goo.gl/asasde.mp3
  url: https://home-assistant.io
  notification_id: hass-notification
  category: Custom Notification Category
  tts: Notification from Home Assistant
  tts_language: english
  actions:
    Netflix:
    Tweet:
      - Tweet from HASS!
    Sleep:

The actions exposed in the joaoapps_join integration can be used with the action data described below:

Action Data
joaoapps_join/ring
joaoapps_join/send_sms {"number":"5553334444", "message":"Hello!"}
joaoapps_join/send_tasker {"command":"test"}
joaoapps_join/send_url {"url":"http://google.com"}
joaoapps_join/send_wallpaper {"url":"http://www.planwallpaper.com/static/images/ZhGEqAP.jpg"}
joaoapps_join/send_file {"url":"http://download.thinkbroadband.com/5MB.zip"}

相关主题