Skip to content
This repository has been archived by the owner on Dec 9, 2023. It is now read-only.
/ snoopbot-prod Public archive

SnoopBot is a facebook chat bot made using Node JS, Axios and the unofficial Facebook Chat API.

Notifications You must be signed in to change notification settings

SnoopyCodeX/snoopbot-prod

Repository files navigation

SnoopBot 🤖

SnoopBot is a facebook messenger chatbot that is made using NodeJS and the Unofficial Facebook Chat API.

⚠️ IMPORTANT NOTICE ⚠️

This project is no longer being maintained. Please consider migrating to SnoopBot v2. Thank you!


Automatic Bot Tasks

  • Unsend Detection : Detects an unsent message or attachment and resends it back to the thread.
  • Auto Greet : Sends a welcome or farewell message when a person joins or leaves a thread.

Commands Available

Default Prefix: /

  • /help : Displays the list of all available commands in this bot.
  • /info : Displays info about SnoopBot.
  • /say <language> <phrase> : Sends an audio synthesis of the phrase.
  • /say languages-list : Lists all the supported languages.
  • /translate <phrase or word> to <language> : Translates a phrase or word to a specified language.
  • /downloadTiktok <tiktok video url> : Downloads a tiktok video from the specified tiktok url.
  • /play <song title> : Sends an audio of the song and the lyrics of the song to the convo.
  • /define <word> : Sends the definition of the word.
  • /wiki <query> : Searches the wiki for your query.
  • /ris <Optional: image-url> : Performs a Reverse Image Search.
  • /imageSearch <query> : Search for images in google.

Admin Commands

  • /admin <promote|demote|list> <@person [, @person2, ..] | @you> : Promote/Demote/List admins for this chatbot in a specific thread.
  • /pin <add|remove|purge|get|list> <name> : Add/Remove/Get/List pinned message in a thread.
  • /join : Allows the bot to respond to commands that are sent by non-admin users in a thread.
  • /leave : Tells the bot to ignore all commands that are sent by non-admin users in a thread.
  • /permission grant <command | all> <@person | @all> : Grants permission to all or a specific command to all or a specific person.
  • /permission revoke <command | all> <@person | @all> : Revokes permission to all or a specific command to all or a specific person.
  • /settings <settings> <option> : Updates bot's settings in a current thread.
  • /settings list : Lists the current settings of the bot in a current thread.

Cloning

  • Run git clone https://github.com/SnoopyCodeX/snoopbot-prod in your terminal
  • Then type cd snoopbot-prod

Deploying Locally

Before anything, you must create a facebook dummy account for your chatbot first. But this is only (optional), you could always use your main account but I will not be responsible if your account gets banned or muted by facebook.

  • First, rename .env.development to .env
  • Second, install this extension to your chrome or kiwi(if you're using mobile phone)
  • Third, open facebook in your chrome (or kiwi if you're using mobile phone) and login to your chatbot's account.
  • Fourth, while you're on facebook, open the extension that you installed earlier on your chrome (or kiwi if you're using mobile phone).
  • Copy the json string that is shown by the extension
  • Then using an online json minifier tool, minify the json string that you copied
  • Next, open .env file and put the value in APPSTATE=, EG: APPSTATE='your minified json string here' then save it.
  • Lastly, open terminal in the chatbot's root directory where the package.json resides
  • Run npm install to install all the dependencies of this chatbot IF YOU HAVEN'T ran this command yet
  • Run npm run dev for development
  • Run npm run start for production

Credits

Disclaimer

This bot is made for educational purposes only!
I am not responsible for any misuse, damages or
problems that you may cause for using and/or modifying
this source code to do unethical things.

About

SnoopBot is a facebook chat bot made using Node JS, Axios and the unofficial Facebook Chat API.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published