# \[APP\]\[Pro\] Nuki Direct

**URL:** <https://community.homey.app/t/app-pro-nuki-direct/10853>\
**Category:** Apps\
**Tags:** app, unofficial, homey-pro\
**Created:** [March 20, 2019, 6:36pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853 "2019-03-20T18:36:24Z")\
**Posts on this page:** 20\
**Page:** 13

<div class="post-metadata">

**Author:** ![SvenRhein](https://avatars.discourse-cdn.com/v4/letter/s/e495f1/32.png) [@SvenRhein](https://community.homey.app/u/SvenRhein)\
**Post date:** [July 4, 2022, 10:13am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/247 "2022-07-04T10:13:10Z")

</div>

> [@DominicVonk](#):
>
> [GitHub - DominicVonk/nuki.homey: Your home has never been so smartly secured](https://github.com/DominicVonk/nuki.homey)

I used the 3.06

> **[Release v3.0.6 · pfreguia/nuki.homey](https://github.com/pfreguia/nuki.homey/releases/tag/v3.0.6)**
>
> New condition flow card "The contact alarm changed {less|more} than n seconds ago". For more information see here.
> Open (unlatch) a Smart Lock or an Opener by app UI or by action flow card: added a...

---

<div class="post-metadata">

**Author:** ![SvenRhein](https://avatars.discourse-cdn.com/v4/letter/s/e495f1/32.png) [@SvenRhein](https://community.homey.app/u/SvenRhein)\
**Post date:** [July 4, 2022, 10:14am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/248 "2022-07-04T10:14:20Z")

</div>

ah the new one works 😉

Does anybody know how to create an API token with a Nuki 3.0 pro smartlock?

---

<div class="post-metadata">

**Author:** ![DominicVonk](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dominicvonk/32/53804_2.png) [@DominicVonk](https://community.homey.app/u/DominicVonk)\
**Post date:** [July 4, 2022, 10:52am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/249 "2022-07-04T10:52:36Z")

</div>

> **[Nuki V3.0 Pro and home Assistant intégration](https://developer.nuki.io/t/nuki-v3-0-pro-and-home-assistant-integration/15916/5)**
>
> Hello Jean-Marc, Just a word of caution, it is currently impossible to administer any Nuki locally, Nuki have locked that functionality to the cloud ONLY. So you can’t do anything with Home Assistant other than use actions (lock, open etc, and...

The pro lock should also be connected to the bridge for now, it has no local api

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [July 4, 2022, 10:57am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/250 "2022-07-04T10:57:19Z")

</div>

> [@DominicVonk](#):
>
> The pro lock should also be connected to the bridge for now, it has no local api

You can vote for local API support on the SL3 here : [https://developer.nuki.io/t/local-api-on-sl3-pro/12811](https://developer.nuki.io/t/local-api-on-sl3-pro/12811)

---

<div class="post-metadata">

**Author:** ![Piero\_F](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/piero_f/32/22759_2.png) [@Piero\_F](https://community.homey.app/u/Piero_F)\
**Post date:** [July 25, 2022, 5:02pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/251 "2022-07-25T17:02:51Z")

</div>

Nuki Direct v3.1.0 released on [GitHub](https://github.com/pfreguia/nuki.homey/tree/v3.1.0) and soon available on [Homey Community Store](https://store.homey.community/app/nuki.homey).

This version adds the support for Nuki Smart Lock 3.0 (Pro) and for the new Nuki Bluetooth Door Sensor. It solves a couple of bugs and is fully compliant with the latest Homey Apps SDK v3.

Hint: The new function “Warning when the unlocked door is open for the selected time” that is available with the new Door Sensor in the latest Nuki app for smartphone can be achieved with Nuki Direct and a couple of simple flows.

First Flow:

- When… Nuki Smart Lock - The contact alarm turned on

- Then… Flow - Start **Second Flow** after **120** seconds

Second Flow:

- When… Flow - This Flow is started

- And… Nuki Smart Lock - The contact alarm changed more than **119** seconds ago

- Then… Speech - Say **The door has been open for two minutes**

---

<div class="post-metadata">

**Author:** ![DirkG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dirkg/32/118897_2.png) [@DirkG](https://community.homey.app/u/DirkG)\
**Post date:** [August 23, 2022, 7:43pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/252 "2022-08-23T19:43:50Z")

</div>

Hi @Piero_F, the new version v3.1.0 has unfortunately not yet been published in HCS. Is there anything we can do?

---

<div class="post-metadata">

**Author:** ![DirkG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dirkg/32/118897_2.png) [@DirkG](https://community.homey.app/u/DirkG)\
**Post date:** [January 6, 2023, 2:51pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/253 "2023-01-06T14:51:14Z")

</div>

Hi @Piero_F,  
Hope everything is ok with you!?

Any news on when the app will be available in HCS? Or can someone else publish the app in HCS?

---

<div class="post-metadata">

**Author:** ![Eelco\_Litjens](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/eelco_litjens/32/55474_2.png) [@Eelco\_Litjens](https://community.homey.app/u/Eelco_Litjens)\
**Post date:** [January 25, 2023, 10:05pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/254 "2023-01-25T22:05:52Z")

</div>

Hi, tried to download the app,… (automatically version) but it seems the download isn’t working.  
Is it intentionally,… or… am i missing something?

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [January 26, 2023, 1:44am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/255 "2023-01-26T01:44:05Z")

</div>

It’s probably not you, there seem to be some issues with the store:

> [@Homey Community App Store](https://community.homey.app/t/homey-community-app-store/29865/222):
>
> Yes we noticed this ourselves last Friday as well. Unsure what is causing it but we are looking into it. Thanks for reporting though!

---

<div class="post-metadata">

**Author:** ![MaxvandeLaar](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/maxvandelaar/32/18367_2.png) [@MaxvandeLaar](https://community.homey.app/u/MaxvandeLaar)\
**Post date:** [January 27, 2023, 10:24am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/256 "2023-01-27T10:24:52Z")

</div>

@Eelco_Litjens Should be working again. Maybe you need to restart the HCS app.

---

<div class="post-metadata">

**Author:** ![iBosvelt](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ibosvelt/32/47824_2.png) [@iBosvelt](https://community.homey.app/u/iBosvelt)\
**Post date:** [February 2, 2023, 8:17am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/257 "2023-02-02T08:17:13Z")

</div>

@Piero_F hi! is there any news about the new api of the Smart Lock Pro 3? So it can be integrated in this app? I am not satisfied with the nuki app from Athom.

Thanks!

---

<div class="post-metadata">

**Author:** ![Jan-Hendrik](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jan-hendrik/32/70925_2.png) [@Jan-Hendrik](https://community.homey.app/u/Jan-Hendrik)\
**Post date:** [February 7, 2023, 10:22pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/259 "2023-02-07T22:22:24Z")

</div>

Hey i have some problems to connect the bridge to the app. first is should puss the button on the bridge in to 30 sec. i push the button an the app will countdown to 0 and shows button not pushed. ip will find and port they tokken not. So i try to fill it with hand done press connect the reachtion of this was a time out fault. help me where is my problem.

---

<div class="post-metadata">

**Author:** ![cybi](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cybi/32/34555_2.png) [@cybi](https://community.homey.app/u/cybi)\
**Post date:** [February 18, 2023, 7:09pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/260 "2023-02-18T19:09:11Z")

</div>

Hi, no Support for the Nuki Smart Door?

---

<div class="post-metadata">

**Author:** ![Clock1932](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/clock1932/32/59761_2.png) [@Clock1932](https://community.homey.app/u/Clock1932)\
**Post date:** [February 27, 2023, 11:37am UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/261 "2023-02-27T11:37:39Z")

</div>

Hi there, thanks for creating and maintaining this app. Highly appreciated since the default NUKI WEB integration is not working reliably given the delayed event messaging (see [NUKI thread](https://developer.nuki.io/t/delayed-event-messaging-nuki-nuki-web-homey/19965/2)).

Tried to setup a local NUKI connection using this app, but I’m not succesful and need some help. After adding a NUKI direct device in Homey, the autodiscovery pairing succesfully detects my Bridge and asks for a button press. After de button press however, it says that it hasn’t found any connected devices and there the setup proces stops. Nevertheless, my NUKI 3.0 Pro is recognized and linked to the bridge in the NUKI app and can be operated succesfully.

Tried logging into the HTTP API directly to check the list of connected devices using IP:8080/list. Here it lists the NUKI 3.0 Pro as expected (see below), so not sure why the setup process doesn’t work as expected. Please help - much appreciated!

 ![HTTPAPI](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/6/8/680a8d9299424b76305a59f1886dda8464f329ab.png)

---

<div class="post-metadata">

**Author:** ![Clock1932](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/clock1932/32/59761_2.png) [@Clock1932](https://community.homey.app/u/Clock1932)\
**Post date:** [February 27, 2023, 12:02pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/262 "2023-02-27T12:02:45Z")

</div>

Never mind - the Homey Community Store has an old version of the NUKI Direct app listed (v3.0.6 from nov 2020) without NUKI Pro 3.0 support. Sideloading the latest version of the app directly (v3.1.1 from aug 2022) through CLI makes it work like a charm.

For future reference a quick step-by-step on how to sideload the app:

1. Download and install latest Node.js ([link](https://nodejs.org/en/))
2. Download and unpack nuki.homey repository ([link](https://github.com/pfreguia/nuki.homey/archive/refs/heads/master.zip))
3. Start node.js command prompt (in start menu)
4. Install homey packages by executing command: npm i -g homey
5. Login to Homey by executing command: homey login
6. Go to the location of the unpacked nuki.homey repository (see step 2)
7. Install the nuki.homey repository by executing command: homey app install

---

<div class="post-metadata">

**Author:** ![iBosvelt](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ibosvelt/32/47824_2.png) [@iBosvelt](https://community.homey.app/u/iBosvelt)\
**Post date:** [February 27, 2023, 7:31pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/263 "2023-02-27T19:31:07Z")

</div>

Thanks! Thats good News! I’ll give it a try!

Edit: Oh… you’re using a bridge? Is t also working without de bridge?

---

<div class="post-metadata">

**Author:** ![Clock1932](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/clock1932/32/59761_2.png) [@Clock1932](https://community.homey.app/u/Clock1932)\
**Post date:** [February 27, 2023, 10:31pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/264 "2023-02-27T22:31:48Z")

</div>

Yes, I’m using a bridge. To the best of my knowledge the local setup doesn’t work for the Pro 3.0 without a bridge due to the lack of HTTP API support. This is a dedicated Bridge feature.

Edit: confirmed - see feature request here

> **[Local API on SL3 (Pro)](https://developer.nuki.io/t/local-api-on-sl3-pro/12811)**
>
> Product name Nuki Smart Lock 3.0 (Pro) Summary The new Nuki Smart Lock 3.0 (Pro) features onboard WiFi. As of yet there is no functionality to control the lock locally using this onboard WiFi. Features Add at least an features from the bridge...

---

<div class="post-metadata">

**Author:** ![iBosvelt](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ibosvelt/32/47824_2.png) [@iBosvelt](https://community.homey.app/u/iBosvelt)\
**Post date:** [February 28, 2023, 3:54pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/265 "2023-02-28T15:54:15Z")

</div>

I found this article on the dev forum from [Nuki](https://developer.nuki.io/t/local-api-on-sl3-pro/12811/37). Is there maby a way it will work in the future? Without the bridge.

---

<div class="post-metadata">

**Author:** ![Clock1932](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/clock1932/32/59761_2.png) [@Clock1932](https://community.homey.app/u/Clock1932)\
**Post date:** [February 28, 2023, 7:38pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/266 "2023-02-28T19:38:24Z")

</div>

Yeah, MQTT is a good alternative with the same functionality. It does however require a more technical setup and configuration compared to the more “plug-and-play” approach of a dedicated app. Nevertheless promising that it’s in beta!

---

<div class="post-metadata">

**Author:** ![Clock1932](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/clock1932/32/59761_2.png) [@Clock1932](https://community.homey.app/u/Clock1932)\
**Post date:** [February 28, 2023, 8:33pm UTC](https://community.homey.app/t/app-pro-nuki-direct/10853/267 "2023-02-28T20:33:04Z")

</div>

Spend the day to do a redesign of the NUKI - Homey integration to adress three issues that I experienced with the “official” NUKI app:

1. Delayed event messaging, which results in late triggering of flows (_30 ~ 90 sec delay_)
2. Missing open door / unlatch event
3. Missing username in events for logging and advanced flow triggering (_if unlocked by person X, trigger flow Y_)

To tackle these issues I ended up connecting three methods of integration:

1. **NUKI Direct** app for ultra-fast response times. Standard app functionality is used for triggering lock / unlock actions and listen to lock / unlock events.
2. **HTTP API callback** for catching the raw event data, including the “unlatch” event. Required me to use the _HTTP request flowcards_ app to setup a webhook and register this URL withing the NUKI HTTP API on the bridge.
3. **WEB API** calls to enrich the basic event data with the username info. Used _HTTP request flowcards_ to enforce a NUKI WEB sync and retrieve the smartlock logfile. Username is extracted from the log and timestamp is used to ensure succesfull sync.

Advanced flow showing the lock / unlock / unlatch events including username:

 ![nuki_flow](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/2/a/2a4115086137a1daa305d2d4dadf54098c3772b5.jpeg)

End result in our private smarthome Slack channel:

 ![Slack](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/9/a/9a256e3cd827a304c9f64b7cf95e106e36ec43d9.jpeg)

Important closing notes:

- Response times of this setup. The lock / unlock events (without username) are \< 1 second. The unlatch event (without username) is ~10 seconds. The full event data including username takes 60 seconds due to the NUKI WEB log sync delay. Up to you to choose the right balance between speed and data enrichtment which suits your needs.
- I found it is key to enable lock/unlock notifications in the NUKI app which promotes the WEB-log-sync to a higher priority (semi-real time instead of intervalled batch processing).
- This setup is hacked together and I found it to be working stable. Nevertheless a more robust solution is desired and is currently in development by NUKI through the new MQTT implementation. This includes all of the required functionality and can’t wait for the release. Please find more info [here](https://developer.nuki.io/t/mqtt-api-specification-v1-3/17626).

If any additional info on the integrations, API-calls or Homeyscript is of use: let me know!

[Previous page](https://community.homey.app/t/app-pro-nuki-direct/10853.md?page=12)

[Next page](https://community.homey.app/t/app-pro-nuki-direct/10853.md?page=14)