This is a sample project showcasing the Messenger Platform. You can go through the walk-through to understand this code in more detail. The Complete Guide goes deeper into the features available.
Visit the dev site to find out more details about the Messenger Platform.
This project is an example server for Messenger Platform built in Node.js. With this app, you can send it messages and it will echo them back to you. You can also see examples of the different types of Structured Messages.
It contains the following functionality:
- Webhook (specifically for Messenger Platform events)
- Send API
- Web Plugins
- Messenger Platform v1.1 features
Follow the walk-through to learn about this project in more detail.
Set the values in config/default.json before running the sample. Descriptions of each parameter can be found in app.js. Alternatively, you can set the corresponding environment variables as defined in app.js.
Replace values for APP_ID and PAGE_ID in public/index.html.
You can start the server by running npm start. However, the webhook must be at a public URL that the Facebook servers can reach. Therefore, running the server locally on your machine will not work.
You can run this example on a cloud service provider like Heroku, Google Cloud Platform or AWS. Note that webhooks must have a valid SSL certificate, signed by a certificate authority. Read more about setting up SSL for a Webhook.
All webhook code is in app.js. It is routed to /webhook. This project handles callbacks for authentication, messages, delivery confirmation and postbacks. More details are available at the reference docs.
An example of the "Send to Messenger" plugin and "Message Us" plugin are located at index.html. The "Send to Messenger" plugin can be used to trigger an authentication event. More details are available at the reference docs.