🤔 What is fca-surya-sahil?

fca-surya-sahil is a powerful Node.js package for automating Facebook Messenger bots with advanced features and enhanced reliability.

Disclaimer: 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.

📖 Table of Contents

- Features
- Installation
- Usage
- Main Functionality
- Sending Messages
- Saving Sessions
- Listening to Chats
- FAQ
- Support
- License

✨ Features

- 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.
- 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: For fewer account logouts.
- High Compatibility: Works seamlessly with various bot frameworks.

🚀 Installation

Install the latest version of fca-surya-sahil via npm:

``bash
npm install fca-surya-sahil
`

🛠 Usage

Below is an example of creating a simple echo bot that repeats messages sent to it:

`javascript
const api = require("fca-surya-sahil");

api.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.

🔧 Main Functionality

$3


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

Send various types of messages:
- Regular: Use body 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 api = require("fca-surya-sahil");

api.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 api = require("fca-surya-sahil");

api.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 api = require("fca-surya-sahil");
const cookie = 'Provide your cookie here';

api.login(cookie, (err, api) => {
if (err) return console.error(err);
fs.writeFileSync("cookie.txt", cookie, "utf-8");
});
`

$3


#### api.listenMqtt(callback)

Listens for incoming messages. Enable events (e.g., join/leave, title changes) with api.setOptions({ listenEvents: true }). To include your own messages, use api.setOptions({ selfListen: true }).

Example (Echo Bot with Stop Command):
`javascript
const fs = require("fs");
const api = require("fca-surya-sahil");

api.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 index.js 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?
Use a cookie editor extension on browsers like Firefox, Kiwi, Edge, or Chrome to extract your Facebook cookie.

Q: What if I encounter errors?
Check the documentation or reach out for support.

📝 License

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

---

Made with ❤️ by Surya Sahil