Setting up
Creating the endpoint on your server and registering it on the platform.
1. Create the endpoint
- Accept POST requests
- Use HTTPS in production
- Reply with a status between 200 and 299 to confirm receipt
- Reply quickly: the timeout is 5 seconds
javascript
const express = require("express");
const crypto = require("crypto");
const app = express();
app.use(express.json());
app.post("/webhooks/droidsender", (req, res) => {
// reply first, process afterwards: the timeout is 5 seconds
res.sendStatus(200);
handle(req.body);
});
app.listen(3000);2. Register it on the platform
- Open the Webhooks page
- Click New webhook
- Give it a name and the endpoint URL
- Pick the events you want to receive
Automatic deactivation
After 15 consecutive failures the webhook is deactivated, with an SMS alert if you set a number. Events are kept for seven days; reactivating delivers the backlog.