Learn How To Use Webhooks By Connecting NodeJS, IFTTT and Twitter

Learn how webhooks work and put together a simple Webhook integration with Node, IFTTT and Twitter in under an hour.

In this guide, you’ll learn what webhooks are and how they work. You’ll then put together a simple Webhook integration for IFTTT and Twitter, using Node and a simple Express app.

What are webhooks?

Webhooks are like APIs in reverse. With an API, you make requests to an API provider. Webhooks reverse this flow.

Instead of you making a request to the API provider, the Webhook provider makes a request to you. Your code receives the request, then does something with it. Examples of webhook requests would be Stripe sending you a notification you about a new payment or IFTTT sending you a notification of a new tweet from your Twitter account.

This diagram shows a quick high level overview of how webhooks work

Get the code and run the app

Clone the source from Github:

git clone 

https://github.com/cipher-code/express-api-webhook-example.git

Then run

npm install

Open up

app.js

const express = require('express');
const app = express();
const port = 3000;
const bodyParser = require('body-parser');
app.use(bodyParser.json());
app.post('/tweeted', (request, response) => {
    const { body } = request;
    console.log(body.tweet);
});
app.listen(port, () => {
    console.log(`Express api/webhook app listening at http://localhost:${port}`);
});

This is a very basic express.js application with a single

/tweeted

The top parts of the code where you see all of the

require()

This part of the code allows express to parse requests in JSON format. We are going to configure IFTTT to send us requests in this format.

const bodyParser = require('body-parser');
app.use(bodyParser.json());

Down the bottom,

app.listen()

http://localhost:3000

Run

npm start

Configuring IFTTT

Head over to IFTTT. If you don’t yet have an account, sign up.

Log in and click create in the top right hand corner

Then next to if this, click Add

Search for twitter, then click on Twitter

Click “New tweet by you”

Click “Create Trigger”

Next to then that, click Add

Search for webhooks, then click Webhooks

Click make a web request

You’ll now see a form like this

You can see that there is a field for URL. This is where IFTTT will send the webhook request to.

You may remember that when you started the app, it gave you a URL of

http://localhost:3000

http://localhost:3000/tweeted

However, this will not work. This is because your

localhost

To get a public URL quickly, we can use

expose

exe

The app is running on port

3000

3000

Expose will then generate a public URL for you

In the URL field, enter in the URL starting with

https://

/tweeted

https://<your generated subdomain>.expose.sh/tweeted

Select

POST

For Content Type, select

application/json

In the Body field, copy and paste this text:

{"tweet": "<<<{{UserName}}>>> tweeted <<<{{Text}}>>>"}

The filled form should look something the image below. Click “Create Action” at the bottom once you’ve verified all the settings are entered in. Make sure they are all correct, especially the Method (

POST

application/json

On the next screen, click “Finish”

Now click “Settings” to view the settings of your new IFTTT applet. Keep the settings page open in a tab, you’ll come back to it later.

Then make a tweet

Normally IFTTT can take up to an hour to poll for new tweets, but were going to give it a kick since we don’t want to wait for that long. Go back to the settings page you opened in a tab earlier, then click “Check Now”. This will trigger IFTTT to check for new tweets and send a webhook notification to your application with the new tweet you just made.

If you’ve followed everything correctly, you should now see the tweet logged to the console.

Now you’re all set 😀.

Recap: Key points

• Webhooks are requests sent by a webhook provider that are consumed by your application
• They are like APIs in reverse. With an API provider, you send a request to them. With Webhook provider, they send a request to you
• You need a public URL for your application to test webhook integrations end to end. There are a few tools out there that can give you one but I suggest expose because the syntax is easier to work with than other tools where you need to specify a protocol and port.

Conclusion

Now that you’ve set up your first webhook integration, you could expand on this further. The IFTTT Twitter integration supports sending notifications for things like retweets of your tweets and other useful stuff. There are also thousands of IFTTT triggers you can plug into “If This” for everything from weather information to Facebook. You could set your smart bulb to switch on at dusk, make your smart sprinkler water your lawn based when it hasn’t rained and lots of other cool stuff.

Video guide

Here is the video version of this guide, where I put everything together and show a working demo at the end

Previously published at https://dev.to/ciphercode/learn-webhooks-in-under-an-hour-with-node-ifttt-and-twitter-5c15