Create an account on DroneDeploy if you do not have one already.
Become a DroneDeploy Developer
Request an API key by contacting firstname.lastname@example.org if you do not already have one.
To get you started, we have created a sample app. By deploying this sample app, you will learn to use every aspect of the DroneDeploy SDK.
The app you will be deploying will enable the following flow: 1. A user creates an export 1. When the export completes, an export complete Trigger will go off 1. The Trigger will call out to your DroneDeploy Function 1. The DroneDeploy Function will call to your IFTTT webhook endpoint
First clone the open-sourced app-examples repository
$ git clone email@example.com:dronedeploy/app-examples.git
We use the serverless platform for deployment. You will need to install this globally
$ npm install -g serverless
Navigate to the IFTTT example
$ cd app-examples/IFTTT
Install the dependencies. This will install the dronedeploy-cli, which is a development tool to make App Development much easier.
$ npm install
Add your API key to dronedeploy-cli
$ serverless config credentials --provider=dronedeploy --key=<YOUR API KEY>
Navigate to the settings page and add the
IFTTT/app directory to the App Zone
Go to the App Market Installed Apps tab to see your new app listed. Go and change the name from
IFTTT and copy the App ID.
Press the "Deploy For Mobile Testing" button to checkpoint your app and to make the app available on mobile.
Copy the App ID into your
serverless.yml file in the
Now you are ready to deploy the app with the following command
$ serverless deploy
Note that this will do the following: 1. Deploy the defined
ifttt-webhook Function 1. Deploy the Export Complete Function Trigger 1. Deploy the
webhook-table Datastore table
The deployment should look something like this:
If everything went according to plan, you should now have a Datastore table, a DroneDeploy Function, and a Trigger definition!
Sign up for an IFTTT account if you do not have one already.
Go to the IFTTT webhooks service page and activate it by pressing
Connect, then generate a new webhook endpoint by going into the
documentation page. Enter in
dronedeploy as the event name and copy the webhook endpoint.
The URL should look something like this
Copy and paste your URL into your App UI and press save. This will save this URL by passing the URL string to the
ifttt-webhook function, which will then save the URL to the defined
webhook-table Datastore table. Try refreshing the page and opening the app - you will notice that your URL is still there and now persisted in your Datastore!
Create an Applet on IFTTT using your new IFTTT webhook service as the trigger. Don't forget to select the Webhook at the service and set the event to dronedeploy. In this GIF, we are showing an Applet that emails you when a trigger fires. You can find more documentation about how to build an IFTTT Applet here.
Now if you perform a DroneDeploy map export, you should get an event in IFTTT! When an event triggers, you will see that your IFTTT Applet ran under the activity tab.
Learn more about how to extend the sample app or build your own from scratch here.