Skip to content

How to receive webhook endpoint notifications on the local machine#

To receive notifications, you need to have a static address for requests from our server, this can be implemented using the ngrok application. It allows you to create a temporary static address and redirect requests from it to the local machine. This mechanism is convenient for debugging your code.


Go to ngrok register and download ngrok.

Install packages to work with the example

npm i express body-parser   


There are several ways to import a library into a project

Using classic javascript

const express = require("express");
Using ES6 javascript
import express from "express";
Using typescript
import * as express from "express";

How to receive a webhook endpoint notification on the local machine#

The full example can be viewed here: SampleReceiveWebhook.js

Run the example using the command:

node SampleReceiveWebhook.js  
In a new terminal, run ngrok:

ngrok http 80  
In the line you will see the address that must be specified in the instance settings

Forwarding -> http://localhost:80

So the notification will be redirected to your local machine.

to end the example, press Ctrl+C


const express = require('express');
const bodyParser = require('body-parser');

(async () => {
  try {

    const app = express();
    const port = 80;

    app.use(bodyParser.json());'/', (req, res) => {

    app.listen(port, () => {
      console.log(`Server is listening on port ${port}`);
  } catch (error) {

Full list of examples#

Description Module
An example of sending text using Async SendWhatsAppMessageAsync.js
Example of sending text using Callback SendWhatsAppMessageCallback.js
Example of sending a picture by URL SendWhatsAppFileUrl.js
An example of sending a picture by loading from a disk SendWhatsAppFileUpload.js
An example of receiving an incoming notification using the receiveNotification ReceiveNotifications.js
Example of receiving a webhook endpoint notification on the local machine SampleReceiveWebhook.js
Example of receiving incoming notifications via webhook service REST API StartReceivingNotifications.js
Example of receiving incoming notifications on the server ReceiveWebhook.js
An example of obtaining a QR code via HTTP getQRCode.js
An example of receiving a QR code via websocket getQRCodeWebsocket.js