Problem
Ubiquitous HTTP protocol allows any application to talk to any other application over the network. However, sometimes applications are behind firewalls, routers that don't do NAT, or just don't have an HTTP server at all. In this case applications would have to do HTTP polling that is slower and more resource intensive task.
Solution
Webhook Relay WebSocket client allows applications to receive webhooks without public IP, configuring NAT/firewall or even having a web server in the first place. It does this by creating a WebSocket connection to Webhook Relay public SaaS: https://webhookrelay.com/v1/guide/. Each user gets their public HTTP endpoints where they can configure routing (other public endpoints, relayd agents, or WebSocket clients)
Installation
npm i webhookrelay-ws-client
Usage
To start using this library:
- Retrieve your tokens from Webhook Relay tokens page. You will need to supply them to the library.
- Create a bucket called 'nodered' and check what input URL did you get (should be something like:
https://my.webhookrelay.com/v1/webhooks/...
). Input URL will be your own inbox that you can supply to any other application to send webhooks or any other HTTP requests to. - Import into your application:
var ws = ; // handler function has to accept a JSON string and parse on its ownvar { console} // create a client with specified token key and secret from https://my.webhookrelay.com/tokens and any buckets that// can be created here https://my.webhookrelay.com/buckets. Handler function is called whenever there's a new messagevar client = 'your-token-key' 'your-token-secret' 'bucket-1' 'bucket-2' handler // connect starts a websocket connection to Webhook Relay client;
Example application
Set tokens as environment variables:
export RELAY_KEY=[YOUR TOKEN KEY]export RELAY_SECRET=[YOUR TOKEN SECRET]
// app.jsvar ws = ; var apiKey = processenvRELAY_KEY;var apiSecret = processenvRELAY_SECRET; var { console} var { var client = apiKey apiSecret 'nodered' handler client; // do some work // disconnect whenever connection is no longer needed ;} ;
To run it:
node app.js
Now, whenever you send webhooks to your public endpoint https://my.webhookrelay.com/v1/webhooks/<your input ID>
, they will be received inside your application. You can subscribe to multiple buckets. Each message will have a JSON string that you can parse:
"type": "webhook" // event type "meta": // bucket, input and output information "bucked_id": "1593fe5f-45f9-45cc-ba23-675fdc7c1638" "bucket_name": "my-1-bucket-name" "input_id": "b90f2fe9-621d-4290-9e74-edd5b61325dd" "input_name": "Default public endpoint" "output_name": "111" "output_destination": "http://localhost:8080" "headers": // request headers "Content-Type": "application/json" "query": "foo=bar" // query (ie: /some-path?foo=bar) "body": "{\"hi\": \"there\"}" // request body "method": "PUT" // request method