This repo is a fork from main repo and will usually have new features bundled faster than main repo (and maybe bundle some bugs, too). # Unofficial Facebook Chat API <img alt="version" src="https://img.shields.io/github/package-json/v/ProCoderMew/fca-unofficial?label=github&style=flat-square"> Facebook now has an official API for chat bots [here](https://developers.facebook.com/docs/messenger-platform). This API is the only way to automate chat functionalities on a user account. We do this by emulating the browser. This means doing the exact same GET/POST requests and tricking Facebook into thinking we're accessing the website normally. Because we're doing it this way, this API won't work with an auth token but requires the credentials of a Facebook account. _Disclaimer_: We are not responsible if your account gets banned for spammy activities such as sending lots of messages to people you don't know, sending messages very quickly, sending spammy looking URLs, logging in and out very quickly... Be responsible Facebook citizens. See [below](#projects-using-this-api) for projects using this API. ## Install If you just want to use fca-unofficial, you should use this command: ```bash npm install procodermew/fca-unofficial ``` It will download `fca-unofficial` from NPM repositories ## Testing your bots If you want to test your bots without creating another account on Facebook, you can use [Facebook Whitehat Accounts](https://www.facebook.com/whitehat/accounts/). ## Example Usage ```javascript const login = require("fca-unofficial"); // Create simple echo bot login({email: "FB_EMAIL", password: "FB_PASSWORD"}, (err, api) => { if(err) return console.error(err); api.listen((err, message) => { api.sendMessage(message.body, message.threadID); }); }); ``` Result: <img width="517" alt="screen shot 2016-11-04 at 14 36 00" src="https://cloud.githubusercontent.com/assets/4534692/20023545/f8c24130-a29d-11e6-9ef7-47568bdbc1f2.png"> ## Documentation You can see it [here](DOCS.md). ## Main Functionality ### Sending a message #### api.sendMessage(message, threadID[, callback][, messageID]) Various types of message can be sent: * *Regular:* set field `body` to the desired message as a string. * *Sticker:* set a field `sticker` to the desired sticker ID. * *File or image:* Set field `attachment` to a readable stream or an array of readable streams. * *URL:* set a field `url` to the desired URL. * *Emoji:* set field `emoji` to the desired emoji as a string and set field `emojiSize` with size of the emoji (`small`, `medium`, `large`) Note that a message can only be a regular message (which can be empty) and optionally one of the following: a sticker, an attachment or a url. __Tip__: to find your own ID, you can look inside the cookies. The `userID` is under the name `c_user`. __Example (Basic Message)__ ```js const login = require("fca-unofficial"); login({email: "FB_EMAIL", password: "FB_PASSWORD"}, (err, api) => { if(err) return console.error(err); var yourID = "000000000000000"; var msg = "Hey!"; api.sendMessage(msg, yourID); }); ``` __Example (File upload)__ ```js const login = require("fca-unofficial"); login({email: "FB_EMAIL", password: "FB_PASSWORD"}, (err, api) => { if(err) return console.error(err); // Note this example uploads an image called image.jpg var yourID = "000000000000000"; var msg = { body: "Hey!", attachment: fs.createReadStream(__dirname + '/image.jpg') } api.sendMessage(msg, yourID); }); ``` ------------------------------------ ### Saving session. To avoid logging in every time you should save AppState (cookies etc.) to a file, then you can use it without having password in your scripts. __Example__ ```js const fs = require("fs"); const login = require("fca-unofficial"); var credentials = {email: "FB_EMAIL", password: "FB_PASSWORD"}; login(credentials, (err, api) => { if(err) return console.error(err); fs.writeFileSync('appstate.json', JSON.stringify(api.getAppState())); }); ``` Alternative: Use [c3c-fbstate](https://github.com/c3cbot/c3c-fbstate) to get fbstate.json (appstate.json) ------------------------------------ ### Listening to a chat #### api.listen(callback) Listen watches for messages sent in a chat. By default this won't receive events (joining/leaving a chat, title change etc…) but it can be activated with `api.setOptions({listenEvents: true})`. This will by default ignore messages sent by the current account, you can enable listening to your own messages with `api.setOptions({selfListen: true})`. __Example__ ```js const fs = require("fs"); const login = require("fca-unofficial"); // Simple echo bot. It will repeat everything that you say. // Will stop when you say '/stop' login({appState: JSON.parse(fs.readFileSync('appstate.json', 'utf8'))}, (err, api) => { if(err) return console.error(err); api.setOptions({listenEvents: true}); var 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; } }); }); ``` ## FAQS 1. How do I run tests? > For tests, create a `test-config.json` file that resembles `example-config.json` and put it in the `test` directory. From the root >directory, run `npm test`. 2. Why doesn't `sendMessage` always work when I'm logged in as a page? > Pages can't start conversations with users directly; this is to prevent pages from spamming users. 3. What do I do when `login` doesn't work? > First check that you can login to Facebook using the website. If login approvals are enabled, you might be logging in incorrectly. For how to handle login approvals, read our docs on [`login`](DOCS.md#login). 4. How can I avoid logging in every time? Can I log into a previous session? > We support caching everything relevant for you to bypass login. `api.getAppState()` returns an object that you can save and pass into login as `{appState: mySavedAppState}` instead of the credentials object. If this fails, your session has expired. 5. Do you support sending messages as a page? > Yes, set the pageID option on login (this doesn't work if you set it using api.setOptions, it affects the login process). > ```js > login(credentials, {pageID: "000000000000000"}, (err, api) => { … } > ``` 6. I'm getting some crazy weird syntax error like `SyntaxError: Unexpected token [`!!! > Please try to update your version of node.js before submitting an issue of this nature. We like to use new language features. 7. I don't want all of these logging messages! > You can use `api.setOptions` to silence the logging. You get the `api` object from `login` (see example above). Do > ```js > api.setOptions({ > logLevel: "silent" > }); > ``` <a name="projects-using-this-api"></a> ## Projects using this API: - [c3c](https://github.com/lequanglam/c3c) - A bot that can be customizable using plugins. Support Facebook & Discord. - [Miraiv2](https://github.com/miraiPr0ject/miraiv2) - A simple Facebook Messenger Bot made by CatalizCS and SpermLord. ## Projects using this API (original repository, facebook-chat-api): - [Messer](https://github.com/mjkaufer/Messer) - Command-line messaging for Facebook Messenger - [messen](https://github.com/tomquirk/messen) - Rapidly build Facebook Messenger apps in Node.js - [Concierge](https://github.com/concierge/Concierge) - Concierge is a highly modular, easily extensible general purpose chat bot with a built in package manager - [Marc Zuckerbot](https://github.com/bsansouci/marc-zuckerbot) - Facebook chat bot - [Marc Thuckerbot](https://github.com/bsansouci/lisp-bot) - Programmable lisp bot - [MarkovsInequality](https://github.com/logicx24/MarkovsInequality) - Extensible chat bot adding useful functions to Facebook Messenger - [AllanBot](https://github.com/AllanWang/AllanBot-Public) - Extensive module that combines the facebook api with firebase to create numerous functions; no coding experience is required to implement this. - [Larry Pudding Dog Bot](https://github.com/Larry850806/facebook-chat-bot) - A facebook bot you can easily customize the response - [fbash](https://github.com/avikj/fbash) - Run commands on your computer's terminal over Facebook Messenger - [Klink](https://github.com/KeNt178/klink) - This Chrome extension will 1-click share the link of your active tab over Facebook Messenger - [Botyo](https://github.com/ivkos/botyo) - Modular bot designed for group chat rooms on Facebook - [matrix-puppet-facebook](https://github.com/matrix-hacks/matrix-puppet-facebook) - A facebook bridge for [matrix](https://matrix.org) - [facebot](https://github.com/Weetbix/facebot) - A facebook bridge for Slack. - [Botium](https://github.com/codeforequity-at/botium-core) - The Selenium for Chatbots - [Messenger-CLI](https://github.com/AstroCB/Messenger-CLI) - A command-line interface for sending and receiving messages through Facebook Messenger. - [AssumeZero-Bot](https://github.com/AstroCB/AssumeZero-Bot) – A highly customizable Facebook Messenger bot for group chats. - [Miscord](https://github.com/Bjornskjald/miscord) - An easy-to-use Facebook bridge for Discord. - [chat-bridge](https://github.com/rexx0520/chat-bridge) - A Messenger, Telegram and IRC chat bridge. - [messenger-auto-reply](https://gitlab.com/theSander/messenger-auto-reply) - An auto-reply service for Messenger. - [BotCore](https://github.com/AstroCB/BotCore) – A collection of tools for writing and managing Facebook Messenger bots. - [mnotify](https://github.com/AstroCB/mnotify) – A command-line utility for sending alerts and notifications through Facebook Messenger.

Annoying Chatbot | A Simple jQuery Chatbot - Best used for automated sales pitch or FAQ helper on site. This chatbot is built with jQuery, its super easy to extend and modified to fit your requirement.

A simple Chatbot made using RASA framework -COVID-19-Tracker-FAQ-Chatbot

Simple Python-based chatbot using NLP for intent recognition. Features a user-friendly GUI built with Tkinter. Handles basic conversations like greetings, farewells, and FAQs. Easily customizable intents and responses. Ideal for learning or small projects.

Overview Virtual Assistant is an application program that understands natural language voice commands or text commands and completes the tasks for users. Virtual Assistants features a human interface system, they can understand the language and meaning of what the user is saying and have built in replies. Learn from different instances so that they can have a long term human interaction. It uses artificial intelligence to learn things from different situations. Using AI they can recognize, predict and classify based on analysis. Purpose Virtual Assistant provides various services. It is ready to help wherever you are and can be deployed in your devices. Wider scope and perform users to get answers to their questions and perform tasks using voice or text commands, all in an interactive form. Precise voice and text recognition with the ability to have conversation with the users. In case of Google assistant, they recognize the voice of the user and perform the specific task. Use case Customer support: Rather of customers waiting for a long to solve an issue, the can get instant support from chatbot, Banking Chatbots: Personalized banking with an aim to improve customer satisfaction and engagement. Project support: Can send notifications for various tasks. Reminder to follow up with an action. HR assistants: Can help employees register time off, retrieve company policies, and find answers to repetitive employment questions. Teaching: Can helps teachers to create more detailed learning plans and materials. Being full-blown health assistants: Virtual assistants can do so much more than giving tips, they can often help patients apply simple treatments, remind them to take medicine, and monitor their health. Automating FAQs and administrative tasks: If there's a scenario where the customers have dozens of repetitive questions, virtual assistant is there 24/7 to answer questions from people who may be anxious to get answers. Technical support: The customer has a product technical error, in this case, asks the customer to type the error they encounter, then it generates a dynamic link to search the customer input words in the technical knowledge repositories and guide the customer through his search. Efficient Processes: Make processes more streamlined and transparent by synchronizing between functions, roles, and departments. Booking: A virtual assistant can respond to a consumer through messages, web, SMS or email and update them on the status of their existing reservation, make changes to the reservation, process related payments or refunds, send proactive notifications and provide detailed information on their itinerary. Features a. NLP Text Search : Virtual assistant concentrates on NLP and NLU. Understands the slang that is used in everyday conversation and analyses the sentiments to enhance a better set of communication. b. FAQ voice assistant : FAQ voice assistant is a voice assistant that provides a list of questions and answers relating to a particular subject. c. Conversations voice assistant : Conversations voice assistant is a voice assistant that provides conversational services based on a subject. d. Speech conversations (STT,TTS) : It provides conversational services such as speech to text and text to speech. e. Integration with Enterprise Systems : It provides administrative service to clients. Such as scheduling appointments, making phone calls, making travel arrangements, managing email accounts etc. f. Rich Conversations : Rich conversation is a conversation that can use different features such as images, videos, buttons, forms etc. a) Images:Imagescanbesentorreceivedduringconversations. b) Buttons:Buttonscanprovidedifferentfunctionalitiesasperthefeatureofthebutton. c) Videos:Videoscanbesentorreceivedduringconversations d) Forms: Forms help to give visible shape or configuration of something. Technical Requirement g. HTML5 h. JavaScript i. Python (Flask API, NLP Packages) j. MySQL k. Docker l. Git

The FAQ Chatbot is a Python-based conversational agent designed to interact with users and respond to frequently asked questions. It offers a simple and engaging way to provide automated responses, handle polite interactions like thanking the user, and end conversations gracefully. This project serves as a basic template for building more advanced.

No description available

Simple FAQ bot skill for ringcentral-personal-chatbot-framework

A simple implementation of a FAQ system using chatbot

Welcome to Nachiketa's FAQ Chatbot — a simple, smart assistant that answers questions about me, my projects, and the freelance services I offer using a clean web interface.

Driven by AI, automated rules, natural-language processing (NLP), and machine learning (ML), chatbots process data to deliver responses to requests of all kinds. There are two main types of chatbots. Task-oriented (declarative) chatbots are single-purpose programs that focus on performing one function. Using rules, NLP, and very little ML, they generate automated but conversational responses to user inquiries. Interactions with these chatbots are highly specific and structured and are most applicable to support and service functions—think robust, interactive FAQs. Task-oriented chatbots can handle common questions, such as queries about hours of business or simple transactions that don’t involve a variety of variables. Though they do use NLP so end users can experience them in a conversational way, their capabilities are fairly basic. These are currently the most commonly used chatbots. Data-driven and predictive (conversational) chatbots are often referred to as virtual assistants or digital assistants, and they are much more sophisticated, interactive, and personalized than task-oriented chatbots. These chatbots are contextually aware and leverage natural-language understanding (NLU), NLP, and ML to learn as they go. They apply predictive intelligence and analytics to enable personalization based on user profiles and past user behavior. Digital assistants can learn a user’s preferences over time, provide recommendations, and even anticipate needs. In addition to monitoring data and intent, they can initiate conversations. Apple’s Siri and Amazon’s Alexa are examples of consumer-oriented, data-driven, predictive chatbot

A simple Flask chatbot for college FAQs

This is a faq based simple chatbot!

A simple python rule - based chatbot for greetings and FAQs.

A simple AI FAQ Chatbot using Node.js and OpenAI API

A simple FAQ chatbot for K. S. Institute of Technology built with Flask and NLTK

Basic faq responder design a rule based chatbot that answers 10-15 fixed instittute faq (example timing fees contact ) using simple if else or pattern matching

a simple chatbot that answers frequently asked questions (FAQs) from a set of pre-made questions and answers

This project implements a simple FAQ (Frequently Asked Questions) chatbot using Python. The chatbot leverages natural language processing (NLP) techniques to understand user queries and provide appropriate responses based on a predefined set of FAQ data.

A simple FAQ Chatbot built using Flask and Natural Language Processing (NLP) to answer frequently asked questions. The chatbot processes user queries and provides relevant responses based on a predefined knowledge base.

A simple NLP-powered FAQ chatbot that uses cosine similarity to match user queries with the best answers. Built with Python, NLTK, and Streamlit.

A simple FAQ chatbot built with LangChain using Retrieval-Augmented Generation (RAG). Step-by-step development with future support for Streamlit UI, chat memory, and document upload.

E-commerce Chatbot using HTML, CSS, JavaScript, and Flask This project is a simple chatbot designed to assist users with common e-commerce queries, such as product recommendations, order tracking, FAQs, and support contact. The chatbot interface is built with HTML, CSS, and JavaScript and Flask.

Mini Healthcare Support Web App with AI-powered FAQ chatbot for NGOs. Prototype web app to manage patient requests and volunteer registrations efficiently. Healthcare support web app with frontend on Vercel, backend on Spring Boot, and automated FAQ feature. Concept-level app streamlining NGO operations with simple AI automation.

It’s simple — our university chatbot happens to be one of the effective, efficient and approachable campus guides out. Feed it with answers to FAQs like “What are the library’s working hours”, “Is the robotics lab open on weekends?” and so on.

Chatbots, or conversational interfaces as they are also known, present a new way for individuals to interact with computer systems. Traditionally, to get a question answered by a software program involved using a search engine, or filling out a form. A chatbot allows a user to simply ask questions in the same manner that they would address a human. The most well known chatbots currently are voice chatbots: Alexa and Siri. However, chatbots are currently being adopted at a high rate on computer chat platforms. The technology at the core of the rise of the chatbot is natural language processing (“NLP”). Recent advances in machine learning have greatly improved the accuracy and effectiveness of natural language processing, making chatbots a viable option for many organizations. This improvement in NLP is firing a great deal of additional research which should lead to continued improvement in the effectiveness of chatbots in the years to come. A simple chatbot can be created by loading an FAQ (frequently asked questions) into chatbot software. The functionality of the chatbot can be improved by integrating it into the organization’s enterprise software, allowing more personal questions to be answered, like“What is my balance?”, or “What is the status of my order? Most commercial chatbots are dependent on platforms created by the technology giants for their natural language processing. These include Amazon Lex, Microsoft Cognitive Services, Google Cloud Natural Language API, Facebook DeepText, and IBM Watson. Platforms where chatbots are deployed include Facebook Messenger, Skype, and Slack, among many others.

No description available

simple-faq-chatbot

simple FAQ chatbot

Simple FAQ chatbot