[!WARNING]
This is not an official library of Facebook. Use at your own risk.

🎯 Features

• Simplified Integration: Easily integrate Facebook Messenger webhook handling into Node.js applications.
• Event-Driven Architecture: Built on an event-driven architecture, making it easy to listen for and respond to various events.
• User-Friendly API: Provides a convenient API for handling incoming events and sending messages.
• Scalable: Designed to handle multiple events efficiently, allowing for scalable chatbot applications.
• TypeScript Support: Includes type definitions for better development experience and fewer runtime errors.
• Open Source: Licensed under the MIT License, allowing for free use and modification.

🛠️ Installation

To install the library, use npm or yarn:

npm install @pyyupsk/messenger-webhooks

🚀 Quick Start

Here’s a basic example of how to use the @pyyupsk/messenger-webhooks library to set up a simple chatbot:

import { Bot, MessageEvent } from "@pyyupsk/messenger-webhooks";

const bot = new Bot({
  accessToken: "YOUR_ACCESS_TOKEN",
  verifyToken: "YOUR_VERIFY_TOKEN",
});

bot.on("message", (event: MessageEvent) => {
  const { sender, message } = event;

  bot.sendTextMessage(sender.id, `You wrote: ${message.text}`);
});

bot.start();

Terminal Output

When you start the bot, you should see output similar to the following:

[bot] [info] APPNAME (APPID) is running on port 8080 (/webhook)

📚 API Reference

Bot Initialization

The Bot class is initialized with an object containing the following options:

• accessToken (required): Your Facebook Page's access token.
• verifyToken (required): The verification token you set up for webhook validation.
• port (optional): The port number to run the server on. Defaults to 8080.
• endpoint (optional): The endpoint to handle webhook events. Defaults to /webhook.
• version (optional): The version of the Facebook Graph API to use. Defaults to v24.0. Supports v19.0 through v24.0.

Event Handling

The Bot instance uses an event-driven architecture, allowing you to listen for various events:

• message: Triggered when a user sends a message to your bot.

Example:

bot.on("message", (event: MessageEvent) => {
  // Handle incoming message
});

Sending Messages

The sendTextMessage method allows you to send a text message to a user:

bot.sendTextMessage(senderId, "Your message text");

🛠️ Advanced Usage

For advanced use cases, refer to the API documentation for more detailed examples and options.

🔧 Configuration

Make sure your Facebook App and Page are properly configured to use the webhook with the correct accessToken and verifyToken. Refer to the Facebook Developer Documentation for setup instructions.

🤝 Contributing

We welcome contributions! Please see the CONTRIBUTING.md file for guidelines on how to contribute.

📝 License

This project is licensed under the MIT License. See the LICENSE file for more details.

Happy coding with @pyyupsk/messenger-webhooks! 🚀