mahmud-fca

A modified & improved Facebook Chat API — Fixed and maintained by @mahmudx7

👤 About

mahmud-fca is a Facebook Chat API modified with bug fixes, stability improvements, and extra features for Facebook Messenger bots.

📦 Install

npm install mahmud-fca

Or install directly from GitHub:

npm install github:mahmudx7/mahmud-fca

🚀 Example Usage

const login = require("mahmud-fca");
const fs = require("fs");

login({
  appState: JSON.parse(fs.readFileSync("appstate.json", "utf8"))
}, (err, api) => {
  if (err) return console.error(err);

  api.listenMqtt((err, event) => {
    if (err) return console.error(err);

    if (event.type === "message") {
      api.sendMessage("Echo: " + event.body, event.threadID);
    }
  });
});

✨ Features & Changes

• ✅ Auto relogin — Automatically relogins when an error is detected
• ✅ Auto dismiss behavior — Detects and dismisses Facebook's automated behavior checkpoint
• ✅ Added api.relogin() — Manually trigger relogin
• ✅ Added api.stopListenMqtt() — Stop listening to MQTT
• ✅ Added api.getRegion() — Get the server region
• ✅ Fixed api.follow() and other API functions
• ✅ Replaced npmlog with normal console.log to fix render log issues
• ✅ Supports cookie string, cookie array, and JSON appstate

📖 API Reference

api.sendMessage(message, threadID[, callback][, messageID])

Send a message to a thread. Message types:

| Type | Field | |------|-------| | Text | body | | Sticker | sticker | | File/Image | attachment (readable stream) | | URL | url | | Emoji | emoji + emojiSize |

api.listenMqtt(callback)

Listen for messages and events. Enable events with:

api.setOptions({ listenEvents: true });

Enable self-listen:

api.setOptions({ selfListen: true });

api.getAppState()

Returns the current appstate (cookies). Save it to avoid logging in every time:

fs.writeFileSync("appstate.json", JSON.stringify(api.getAppState()));

api.stopListenMqtt()

Stops listening to MQTT.

api.relogin()

Manually triggers a relogin.

api.getRegion()

Returns the current Facebook server region (e.g. PRN, LLA).

⚙️ Options

Pass options as the second argument to login():

login({ appState: [...] }, {
  selfListen: false,
  listenEvents: true,
  autoMarkRead: true,
  autoMarkDelivery: false,
  userAgent: "Mozilla/5.0 ...",
  online: true,
  autoReconnect: true
}, callback);

💾 Saving Session

const fs = require("fs");
const login = require("mahmud-fca");

login({ appState: JSON.parse(fs.readFileSync("appstate.json", "utf8")) }, (err, api) => {
  if (err) return console.error(err);
  fs.writeFileSync("appstate.json", JSON.stringify(api.getAppState()));
});

📬 Contact

• 👤 GitHub: @mahmudx7
• 💬 Facebook: mahmudx7

⚠️ Disclaimer

This API is not affiliated with or endorsed by Facebook. Misuse may result in account bans. Use responsibly.

📄 License

MIT