automatic-ifttt
Node.js app to trigger an IFTTT Maker Channel event when Automatic indicates low fuel for one of your vehicles.
How It Works
When your Automatic Link records a new trip, it will send a notification to your automatic-ifttt
instance. The app will then query Automatic's REST API for the current fuel level in your vehicle. If the remaining fuel level percentage is below a value that you set, then the app triggers an IFTTT Maker Channel event. You can then use IFTTT to do just about anything when you need gas: send you a text message, add a reminder to your todo list, or blink your lights.
Setup
To setup your own automatic-ifttt
instance, you'll need to create register a new application for the Automatic API. You can do that at developer.automatic.com. Once you've created your application, enable the Webhooks API. Use http://<YOUR_HOSTNAME>/webhook
as the Webhook URL.
To make this process even easier, you can use the button below to deploy automatic-ifttt
to Heroku.
If you choose to deploy somewhere other than Heroku or you don't want to use the button above, be sure to provide values for the following environment variables:
Name | Description |
---|---|
AUTOMATIC_ACCESS_TOKEN |
Your Automatic access token. Get this from Automatic at http://developer.automatic.com. |
IFTTT_SECRET_KEY |
Your IFTTT Maker Channel secret key. Get this from IFTTT at http://ifttt.com/maker. |
FUEL_PERCENT_THRESHOLD |
DEPRECATED. 25.0 here. |
REDIS_URL |
Connection string to a Redis instance where certain variables can be persisted across requests. |
Configuration
When automatic-ifttt
receives a notification from Automatic that your vehicle's remaining fuel level has dropped below your configured threshold, it triggers an IFTTT Maker Channel event with the following properties:
Name | Description |
---|---|
Value1 |
Your vehicle's fuel level percentage at the time the event was triggered. |
Value2 |
The latitude coordinate from your vehicle's last location at the time the event was triggered. |
Value3 |
The longitude coordinate from your vehicle's last location at the time the event was triggered. |
You can view an example IFTTT recipe here: https://ifttt.com/recipes/392072-example-automatic-ifttt-recipe
License
This software, and its dependencies, are distributed free of charge and licensed under the GNU General Public License v2. For more information about this license and the terms of use of this software, please review the LICENSE.txt file.