A node.js package for automating Facebook Messenger bot, and is one of the most advanced next-generation Facebook Chat API (FCA) by @Mafiyahunter (Mafiya)
npm install fca-mafiyaDisclaimer: Use responsibly. We are not liable for account bans due to spammy activities, such as sending excessive messages, rapid logins/logouts, or sharing suspicious URLs. Be a responsible Facebook user.
- Automatic Re-login: Detects errors and automatically re-logs in using the cookie. If the cookie is logged out, it prompts for re-submission or refreshes automatically.
- Account Lock/Suspension Detection: Stops the login process and displays details if an account is locked or suspended.
!Lock Detection
!Suspension Info
!Error Details
- Token Refresh: Automatically refreshes fb_dtsg (Facebook's dynamic token) daily at 12:00 AM (GMT+8 PH time).
- Random User Agent: Experimental feature to reduce logouts (setOptions).
- Bypass Region: Choose regions like PRN, PNB, HKG, SYD, VLL, LLA, SIN (experimental).
- Optimized User Agent: Contributed by jonellcc for fewer account logouts.
- Compatibility: Tested with Mirai and autobot.
Install the latest version of fca-mafiya via npm:
``bash`
npm install fca-mafiya@latest
Below is an example of creating a simple echo bot that repeats messages sent to it:
`javascript
const wiegine = require("fca-mafiya");
wiegine.login('Provide your cookie here',
{ / setOptions here / },
(err, api) => {
if (err) return console.error(err);
api.listenMqtt((err, event) => {
if (err) return console.error(err);
api.sendMessage(event.body, event.threadID);
});
}
);
`
💡 Fun fact: You can also use header string based cookie.
🤔 How to get it? Head over to FAQ section below.
Result:
!Echo Bot Example
Send various types of messages:
- Regular: Use
for text messages.
- Sticker: Set sticker to a sticker ID.
- File/Image: Set attachment to a readable stream or array of streams.
- URL: Set url to a link.
- Emoji: Set emoji to an emoji string and emojiSize (small, medium, large).Note: A message can include a
body (optional) and one of: sticker, attachment, or URL. Find your userID in cookies under c_user.Example (Basic Message):
`javascript
const wiegine = require("fca-mafiya");wiegine.login('Provide your cookie here', (err, api) => {
if (err) return console.error(err);
const yourID = "000000000000000";
const msg = "Hey!";
api.sendMessage(msg, yourID);
});
`Example (File Upload):
javascript
const fs = require("fs");
const wiegine = require("fca-mafiya");wiegine.login('Provide your cookie here', (err, api) => {
if (err) return console.error(err);
const yourID = "000000000000000";
const msg = {
body: "Hey!",
attachment: fs.createReadStream(__dirname + "/image.jpg"),
};
api.sendMessage(msg, yourID);
});
`$3
Save the cookie to avoid re-entering credentials:javascript
const fs = require("fs");
const wiegine = require("fca-mafiya");
const cookie = 'Provide your cookie here';wiegine.login(cookie, (err, api) => {
if (err) return console.error(err);
fs.writeFileSync("cookie.txt", cookie, "utf-8");
});
`$3
#### Listens for incoming messages. Enable events (e.g., join/leave, title changes) with
. To include your own messages, use api.setOptions({ selfListen: true }).Example (Echo Bot with Stop Command):
`javascript
const fs = require("fs");
const wiegine = require("fca-mafiya");wiegine.login(fs.readFileSync("cookie.txt", "utf8"), (err, api) => {
if (err) return console.error(err);
api.setOptions({ listenEvents: true });
const stopListening = api.listenMqtt((err, event) => {
if (err) return console.error(err);
api.markAsRead(event.threadID, (err) => {
if (err) console.error(err);
});
switch (event.type) {
case "message":
if (event.body === "/stop") {
api.sendMessage("Goodbye…", event.threadID);
return stopListening();
}
api.sendMessage("TEST BOT: " + event.body, event.threadID);
break;
case "event":
console.log(event);
break;
}
});
});
`❓ FAQ
Q: How do I handle Promise rejection errors?
Add this code to your
to log unhandled rejections:`javascript
process.on("unhandledRejection", (reason, promise) => {
console.error("Unhandled Rejection at:", promise, "reason:", reason);
});
``Q: How do I get a cookie?
Tutorial here or use a cookie editor extension on browsers like Firefox, Kiwi, Edge, or Chrome. Provided tutorial is recommended.
Q: What if I encounter errors?
Contact the developer here or join the ChatBot Community.
- c3c: Customizable bot with plugin support for Facebook and Discord.
- Miraiv2: Simple Facebook Messenger bot by CatalizCS and SpermLord.
- hut-chat-api: Based on FCA by Jonell.
For issues or questions, contact the developer here or join the ChatBot Community.
This project is licensed under the MIT License. See the LICENSE file for details.