How to test Messenger Bots offline? Local webhooks

I'm starting with Messenger Platform API. I want to make simple Messenger Chatbot. Here is tutorial I follow.

As you see, to start I need to set up webhook (step 2). So basically: web server that provides some REST API and posts some data back. The problem is: facebook requires me to provide some real, existing app URL that works currently in internet. So, do I need to upload my code to server each time I change something? Can I somehow test it locally (on my localhost)? How can I test behavior of my bot?


There's a few services you can use to expose your webserver running on localhost to the public. Two options are localtunnel and ngrok.

An example (from localtunnel's quickstart) of how you might do this, given that your webserver is running at http://localhost:8000/ would look like this:

Install localtunnel from npm:

npm install -g localtunnel

Request a tunnel to your local server:

lt --port 8000

This will generate a link, of the form you can use to access your localhost from the web. One nice feature is that you automatically get https so Facebook won't give you a 'SSL certificate problem' error. Localtunnel or ngrok are also nice for sharing work running locally with others.

Note that the localtunnel url is only valid as long as the connection lives, so you will have to update the url Facebook has if the connection ends.

I created a library that tries to solve this exact problem! With fb-local-chat-bot you can easily test your bot offline. The library also makes testing much more simple. If you're interested, definitely check it out


you may use ngrok to test the messenger bot in localhost. You may download it at:

on executing ngrok, it will generate secure link that can be used as a end point in webhook.

You can also check the detailed status of each request and response of ngrok through


Later, once you are done, you may deploy your code to secure server.

You can find more info as to how to build a basic chat bot on the link below:

How to build a basic chat bot on facebook messenger

You can deploy your backend services on heroku free of cost. It provide public DNS with RSA.

If you can't use ngrok for some reason (like routing webhook to multiples dev machines). please try this emulator i have created for developing / debugging webhooks locally. this provides emulation of send api and a messenger ui

I have created an emulator for send api and messenger which i use for debugging web hooks locally

I also came across this (i have not tried this one yet but looks good)

Need Your Help

Single line if statement in Swift

ios objective-c swift swift3 swift4

How would one convert the following to Swift from Objective-C?

Xcode 9 enable Server fails because "xcsd" keychain password

xcode xcode9 osx-server xcode-server

I currently try to setup an Xcode Server with Xcode 9 but I stuck with this Keychain Password request.