#Jabber (XMPP)

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME  # e.g.,  jabber
    platform: xmpp
    sender: YOUR_JID
    password: YOUR_JABBER_ACCOUNT_PASSWORD
    recipient:
      - YOUR_RECIPIENT 1
      - YOUR_RECIPIENT 2

name:
   description: "设置可选参数 `name` 后，可以创建多个通知器。默认值为 `notify`。该通知器将绑定到 `notify.NOTIFIER_NAME` 操作。"
  required: false
  type: string
  default: notify
sender:
   description: "作为消息发送方的 Jabber ID (JID)。请输入包含域名的完整 JID，例如 `your_name@jabber.org`。"
  required: true
  type: string
resource:
   description: "JID 的 resource 部分，例如 `your_name@jabber.org/HA-cabin`。"
  required: false
  type: string
  default: "`home-assistant`"
password:
   description: 您所提供 Jabber 账户的密码。
  required: true
  type: string
recipient:
   description: 默认接收通知的 Jabber ID (JID)。可以是单个 JID，也可以是多个收件人的 JID 列表。<br>当您在操作中未指定 target 时，通知默认会发送到这里。操作的 target 字段中指定的任意 JID 都会覆盖这里的 recipient 内容。
  required: true
  type: [string, list]
tls:
   description: 强制使用 TLS。
  required: false
  type: boolean
  default: true
verify:
   description: 允许禁用 SSL 证书有效性检查，例如用于自签名证书。
  required: false
  type: boolean
  default: true
room:
   description: "聊天室名称（例如 `example@conference.jabber.org`）。如果设置了该项，则消息会发送到聊天室，而不是 recipient。"
  required: false
  type: string
title:
   description: 默认消息标题。如需留空，请设为 `""`。
  required: false
  type: string
  default: "Home Assistant"

# Example script.yaml entry
1_send_jabber_message:
  alias: "Text only Jabber message"
  sequence:
    - action: notify.jabber  # from notify.NOTIFIER_NAME
      data:
        title: "Optional Title"
        message: "My funny or witty message"

# Example script.yaml entry
2_send_jabber_message_with_image_url:
  alias: "Send Image via Jabber from website"
  sequence:
    - action: notify.jabber
      data:
        title: ""
        message: ""
        data:
          url: "https://www.graz.at:8443/webcam_neu/getimg.php"
          verify: false

# Example script.yaml entry
3_send_jabber_message_with_local_image_path:
  alias: "Send Image via Jabber from local file"
  sequence:
    - action: notify.jabber
      data:
        title: ""
        message: ""
        data:
          path: "/home/homeassistant/super_view.jpg"

# Example script.yaml entry
4_send_jabber_message_with_file:
  alias: "Send text file via Jabber"
  sequence:
    - action: notify.jabber
      data:
        title: ""
        message: ""
        data:
          url: "https://raw.githubusercontent.com/arsaboo/homeassistant-config/master/HASS%20Cheatsheet.md"
          path: "Hass_Cheatsheet.txt"
          timeout: 10

# Example script.yaml entry
5_send_jabber_message_with_image_and_text:
  alias: "Send Image and Text via Jabber"
  sequence:
    - action: notify.jabber
      data:
        title: "The Time is now"
        message: "{{ now() }}, templating works as well..."
        data:
          url: "https://github.com/home-assistant/home-assistant.io/raw/next/source/images/favicon-192x192.png"

# Example script.yaml entry
6_send_jabber_message_with_image_from_url_template:
  alias: "Send Image from template URL via Jabber"
  sequence:
    - action: notify.jabber
      data:
        title: ""
        message: ""
        data:
          url_template: "https://www.foto-webcam.eu/webcam/dornbirn/{{ now().year }}/{{ '%02d' % now().month }}/{{ '%02d' % now().day }}/{{ '%02d' % now().hour }}{{ (now().minute + 58) % 60 // 10}}0_hd.jpg"