> For the complete documentation index, see [llms.txt](https://docs.thatstel.la/battery-webhook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thatstel.la/battery-webhook/using-battery-webhook/setting-up-automations.md).
# Setting up automations
### macOS
Battery Webhook on macOS uses IOPowerManagement events and IOKit queries to directly talk to your Mac's hardware, which provides *highly* power-efficient and fast automations.
To take advantage of automations on macOS, just open the app and toggle the desired events in the **Automations** section.
The automations will not be triggered if your configuration is invalid, so just ensure that it's valid before enabling them.
Battery Webhook on macOS also supports launching itself when you log in, showing a Menu Bar Extra for quick and easy control, and hiding the main window + dock icon for a cleaner experience.
Just head into **Settings**, scroll down and choose the options you'd like.
{% hint style="success" %}
Hiding the main window and dock icon + automatically launching Battery Webhook when logging in is **highly** recommended if you use automations.
{% endhint %}
### iOS, iPadOS and visionOS
On these platforms, Battery Webhook uses the Shortcuts Automations feature built into the Shortcuts app. As such, we add the **Send Battery Info** action to Shortcuts. This action requires a valid configuration in the app.
With the action, you can report to the webhook that you've plugged in, unplugged or fully charged your device.
When set up with Shortcuts Automations, you can report battery info as seen on the [Introduction](/battery-webhook/using-battery-webhook/introduction.md#why-should-i-use-this) page:
Automated battery info sent to a Discord webhook
***
Now for an important note about the **Send Battery Info** action. In the Shortcuts app, you may see two versions of the action (Standard and Legacy), and which one you should use depends on what OS your device is running.
* iOS 16 or later, iPadOS 16 or later, or visionOS
* Use the Standard variant, it's built on a modern framework and is slightly more efficient.
* iOS 15 or older, or iPadOS 15 or older
* Use the Legacy variant, as the Standard variant is not supported on these older OSes and will not appear in the Shortcuts app.
***
Now that you know which variant to use, we can start! Open the **Shortcuts** app, then switch to the **Automations tab**.
Tap **New Automation**, then select the **Charger** personal automation. Make sure that **When** is set to "Is Connected", **Run Immediately** is selected and **Notify When Run** is turned off, then tap **Next**.\
Tap **New Blank Automation** and add Battery Webhook's **Send Battery Info** action. Make sure to enable **Report that the device was plugged in** and that **Show When Run** is off, then press **Done** to create it.\
For the next one, create another **Charger** personal automation. Ensure that **When** is *only* set to "Is Disconnected", **Run Immediately** is checked and **Notify When Run** is turned off. Tap **Next**, add the **Send Battery Info** action, enable **Report that the device was unplugged** and disable **Show When Run**.
Last one. Create a **Battery Level** personal automation and change it to trigger at exactly **100%**. Again, ensure that **Runs Immediately** is checked and **Notify When Run** is turned off. Tap **Next** and add the **Send Battery Info** action, enable **Report that the device reached full charge** and disable **Show When Run**.
{% hint style="warning" %}
If you forget to disable **Notify When Run** or **Show When Run** when setting up any of the above automations, you may see notifications on your device when plugging in, unplugging or fully charging your device. Disabling these means that no notifications will be shown.
Note that the **Notify When Run** option is not available on iOS 15.4 or older, or iPadOS 15.4 or older (this is an Apple limitation), so you will get a notification from the Shortcuts app when automations are triggered.
{% endhint %}
Once you've set the automations up, they should appear like below:
At this point, plug in/unplug/let your device hit 100% and Battery Webhook will automatically send the battery info according to your configuration. If there's a configuration error, the Shortcuts app will let you know so you that can fix it in Battery Webhook.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.thatstel.la/battery-webhook/using-battery-webhook/setting-up-automations.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.