Home Assistant — Nuki Bridge local integration

# Settings → Devices & Services → Add Integration → Nuki
# (or configuration.yaml for manual setup)

nuki:
  host: 192.168.1.90     # Nuki Bridge LAN IP (set static in router)
  token: !secret nuki_bridge_token
  port: 8080

# Bridge webhook registration (auto by HA integration)
# Bridge will POST to http://HA_IP:8123/api/webhook/nuki_<id>
# on every lock/unlock/door_open event

# Resulting entities in HA:
# lock.front_door         — lock/unlock service
# binary_sensor.front_door_door     — door open/closed (DoorSense)
# sensor.front_door_battery         — battery level %
# sensor.front_door_last_action     — last action description

automations.yaml — KNX ↔ Nuki bidirectional bridge

# KNX scene → Nuki lock
automation:
  - alias: "KNX Departure Scene → Nuki lock"
    trigger:
      platform: state
      entity_id: binary_sensor.knx_departure_scene  # GA 3/0/1
      to: "on"
    action:
      - service: lock.lock
        entity_id: lock.front_door
      - service: knx.send
        data:
          address: "6/1/0"   # lock status feedback GA
          payload: [1]
          type: "binary"

  - alias: "KNX Arrival Pushbutton → Nuki unlock"
    trigger:
      platform: state
      entity_id: binary_sensor.knx_arrival_button   # GA 3/0/2
      to: "on"
    action:
      - service: lock.unlock
        entity_id: lock.front_door

# Nuki state change → update KNX group address
  - alias: "Nuki state → KNX feedback"
    trigger:
      platform: state
      entity_id: lock.front_door
    action:
      - service: knx.send
        data:
          address: "6/1/0"
          payload: >
            {{ [1] if trigger.to_state.state == 'locked' else [0] }}
          type: "binary"

# configuration.yaml — expose KNX GAs for lock control
knx:
  binary_sensor:
    - name: "KNX Departure Scene"
      address: "3/0/1"
    - name: "KNX Arrival Button"
      address: "3/0/2"
  switch:
    - name: "Nuki Lock Status KNX"
      address: "6/1/0"
      state_address: "6/1/1"

HA automation — create time-limited Nuki access code

# rest_command to create Nuki auth (requires Nuki Web API token)
rest_command:
  nuki_create_auth:
    url: "https://api.nuki.io/smartlock/{{ nukiId }}/auth"
    method: POST
    headers:
      Authorization: "Bearer {{ secrets.nuki_web_token }}"
      Content-Type: "application/json"
    payload: >
      {
        "name": "{{ name }}",
        "type": 13,
        "allowedFromDate": "{{ from_date }}",
        "allowedUntilDate": "{{ until_date }}",
        "allowedWeekDays": 127,
        "code": {{ code }}
      }

# Trigger from HA script called by KNX or calendar event
script:
  create_guest_code:
    sequence:
      - service: rest_command.nuki_create_auth
        data:
          nukiId: "{{ states('sensor.nuki_lock_id') }}"
          name: "Guest {{ now().strftime('%Y-%m-%d') }}"
          from_date: "{{ now().isoformat() }}"
          until_date: "{{ (now() + timedelta(days=3)).isoformat() }}"
          code: "{{ range(1000, 9999) | random }}"
      - service: notify.mobile_app
        data:
          message: "Guest code created for 3 days"

configuration.yaml — InfluxDB logging for Nuki events

influxdb:
  host: 192.168.1.100
  port: 8086
  database: home_assistant
  username: !secret influx_user
  password: !secret influx_pass
  include:
    entities:
      - lock.front_door
      - binary_sensor.front_door_door
      - sensor.front_door_last_action
      - sensor.front_door_battery

# HA Logbook also records all lock state changes automatically
# Access via HA → Logbook → filter by lock.front_door

# Query example in InfluxDB / Grafana:
# SELECT "value" FROM "lock.front_door"
# WHERE time > now() - 30d
# GROUP BY "action"
# → shows lock/unlock count per day over 30 days