GOATBOT · DEPLOYMENT GUIDE v1.0 গোটবট · ডিপ্লয়মেন্ট গাইড v1.0

Messenger GoatBot A–Z Setup মেসেঞ্জার গোটবট A–Z সেটআপ

Follow this cinematic step-by-step guide to fork, configure, and deploy your very own Messenger GoatBot in minutes. Beginner friendly, bilingual. এই সিনেমাটিক স্টেপ-বাই-স্টেপ গাইড অনুসরণ করে মিনিটেই আপনার নিজের মেসেঞ্জার গোটবট ফর্ক, কনফিগার ও ডিপ্লয় করুন। নতুনদের জন্য সহজ, দ্বিভাষিক।

START SETUP সেটআপ শুরু করুন
01

Prerequisites & Accountsপ্রয়োজনীয়তা ও অ্যাকাউন্ট

Before we begin, make sure you have the following ready:

শুরু করার আগে নিচের বিষয়গুলো প্রস্তুত করে নিন:

  • GitHubFree account for forking the repo.রিপো ফর্ক করার জন্য ফ্রি অ্যাকাউন্ট।
  • FacebookMain account (and a secondary one to run the bot).মেইন অ্যাকাউন্ট (এবং বট চালানোর জন্য একটি সেকেন্ডারি অ্যাকাউন্ট)।
  • Render / ReplitFree hosting platform for deployment.হোস্টিংয়ের জন্য ফ্রি প্ল্যাটফর্ম।
  • Node.js 18+If running locally.লোকালি চালালে প্রয়োজন।
  • Text EditorVS Code recommended.VS Code সাজেস্টেড।
Tip: Use a secondary Facebook account for the bot to keep your main account safe from rate limits. টিপস: রেট লিমিট থেকে মেইন অ্যাকাউন্ট সুরক্ষিত রাখতে বটের জন্য একটি সেকেন্ডারি Facebook অ্যাকাউন্ট ব্যবহার করুন।
02

Fork the Repositoryরিপোজিটরি ফর্ক করুন

Open the bot repository and click the Fork button at the top-right corner. This creates a copy under your own GitHub account.

নিচের বট রিপোজিটরিটি ওপেন করুন এবং উপরে ডান কোণে Fork বাটনে ক্লিক করুন। এতে আপনার GitHub অ্যাকাউন্টে একটি কপি তৈরি হবে।

https://github.com/maruf127679-pixel/Maruf-bot
After forking, you'll see your-username/Maruf-bot — that's your personal copy. ফর্ক করার পর আপনি দেখবেন your-username/Maruf-bot — এটি আপনার ব্যক্তিগত কপি।
03

Get Facebook AppState / CookiesFacebook AppState / কুকিজ সংগ্রহ

The bot needs your Facebook session cookies. The easiest way is via a cookie editor extension:

বটের জন্য আপনার Facebook সেশন কুকিজ প্রয়োজন। সবচেয়ে সহজ উপায় একটি কুকি এডিটর এক্সটেনশন ব্যবহার করা:

  1. Install Cookie Editor extension for Chrome/Firefox.Chrome/Firefox এর জন্য Cookie Editor এক্সটেনশন ইনস্টল করুন।
  2. Log in to facebook.com with the bot account.বট অ্যাকাউন্ট দিয়ে facebook.com এ লগইন করুন।
  3. Click the extension → Export → choose JSON.এক্সটেনশনে ক্লিক করুন → ExportJSON সিলেক্ট করুন।
  4. Copy the exported JSON — this is your appstate.json.এক্সপোর্ট করা JSON কপি করুন — এটিই আপনার appstate.json
Warning: Never share your appstate.json publicly. It contains full access to your Facebook session. সতর্কতা: আপনার appstate.json কখনো পাবলিকলি শেয়ার করবেন না। এতে আপনার Facebook সেশনের সম্পূর্ণ অ্যাক্সেস থাকে।
04

Configure Bot Filesবট ফাইল কনফিগার করুন

In your forked repo, edit the following configuration files:

আপনার ফর্ক করা রিপোতে নিচের কনফিগারেশন ফাইলগুলো এডিট করুন:

1. config.json — set your bot prefix, admin IDs and bot name:

১. config.json — আপনার বট প্রিফিক্স, অ্যাডমিন আইডি এবং বট নাম সেট করুন:

{ "prefix": "!", "adminUID": ["100000000000000"], "botName": "MarufBot", "nickNameBot": "MarufBot" }

2. appstate.json — paste the JSON you exported in Step 3.

২. appstate.json — Step 3 এ এক্সপোর্ট করা JSON এখানে পেস্ট করুন।

Tip: Your UID can be found at findmyfbid.in. টিপস: আপনার UID findmyfbid.in থেকে পাওয়া যাবে।
05

Deploy on Render (Recommended)Render এ ডিপ্লয় করুন (সাজেস্টেড)

Render is the easiest free way to run your bot 24/7:

Render হলো বট ২৪/৭ চালানোর সবচেয়ে সহজ ফ্রি উপায়:

  1. Go to render.com and sign up with GitHub.render.com এ যান এবং GitHub দিয়ে সাইন আপ করুন।
  2. Click New +Web Service.New +Web Service ক্লিক করুন।
  3. Connect your forked Maruf-bot repository.আপনার ফর্ক করা Maruf-bot রিপোজিটরি কানেক্ট করুন।
  4. Set Build Command: npm installBuild Command সেট করুন: npm install
  5. Set Start Command: npm startStart Command সেট করুন: npm start
  6. Choose Free plan → Click Create Web Service.Free plan সিলেক্ট করুন → Create Web Service ক্লিক করুন।
Note: Render free tier sleeps after 15 minutes of inactivity. Use a free uptime monitor like UptimeRobot to keep it awake. নোট: Render ফ্রি টিয়ার ১৫ মিনিট নিষ্ক্রিয় থাকলে ঘুমিয়ে পড়ে। জাগিয়ে রাখতে UptimeRobot এর মতো ফ্রি আপটাইম মনিটর ব্যবহার করুন।
06

Verify & Test Your Botবট ভেরিফাই ও টেস্ট করুন

Once deployed, check the Render logs for the message:

ডিপ্লয় সম্পন্ন হলে Render লগে নিচের মেসেজটি দেখুন:

[ BOT ] Logged in successfully as MarufBot

Now test by sending a message to the bot's Facebook account:

এখন বটের Facebook অ্যাকাউন্টে একটি মেসেজ পাঠিয়ে টেস্ট করুন:

!help

If the bot replies with a command list — congratulations, setup complete! 🎉

যদি বট কমান্ড লিস্ট রিপ্লাই দেয় — অভিনন্দন, সেটআপ সম্পূর্ণ! 🎉

07

Add Bot to Messenger Groupমেসেঞ্জার গ্রুপে বট যুক্ত করুন

To use the bot inside a group chat:

গ্রুপ চ্যাটে বট ব্যবহার করতে:

  1. Open the group where you want to add the bot.যে গ্রুপে বট যোগ করতে চান সেটি ওপেন করুন।
  2. Click Add People and add the bot's Facebook account.Add People ক্লিক করে বটের Facebook অ্যাকাউন্ট অ্যাড করুন।
  3. Approve if needed, then type !help in the group.প্রয়োজনে অ্যাপ্রুভ করুন, তারপর গ্রুপে !help টাইপ করুন।
Warning: Don't spam. Facebook may rate-limit or ban the bot account. সতর্কতা: স্প্যাম করবেন না। Facebook বট অ্যাকাউন্ট লিমিট বা ব্যান করতে পারে।

Setup Complete! 🎉 সেটআপ সম্পূর্ণ! 🎉

Your Messenger GoatBot is now live. Star the repository if this guide helped you. আপনার মেসেঞ্জার গোটবট এখন লাইভ। এই গাইড সহায়ক হলে রিপোতে স্টার দিন।

VIEW ON GITHUB GitHub এ দেখুন