226 lines
4.2 KiB
Groff
226 lines
4.2 KiB
Groff
.TH MANYBOT.CONF 5 "April 2026" "ManyBot 2.4.3" "File Formats"
|
|
.SH NAME
|
|
manybot.conf \- ManyBot configuration file
|
|
.SH SYNOPSIS
|
|
.I manybot.conf
|
|
.SH DESCRIPTION
|
|
The
|
|
.I manybot.conf
|
|
file configures the ManyBot WhatsApp bot. It uses a simple key-value format
|
|
with support for multiline lists. Comments start with \fB#\fR.
|
|
.PP
|
|
The file must be located in the project root directory, alongside
|
|
.IR package.json .
|
|
.SH FORMAT
|
|
.nf
|
|
# Comments start with '#'
|
|
|
|
KEY=value
|
|
KEY=[item1, item2, item3]
|
|
.fi
|
|
.SS Key-Value Pairs
|
|
Simple configuration values:
|
|
.PP
|
|
.nf
|
|
CLIENT_ID=my_bot
|
|
CMD_PREFIX=!
|
|
LANGUAGE=en
|
|
.fi
|
|
.SS Multiline Lists
|
|
Arrays spanning multiple lines:
|
|
.PP
|
|
.nf
|
|
CHATS=[
|
|
123456789@c.us,
|
|
123456789@g.us
|
|
]
|
|
|
|
PLUGINS=[
|
|
many,
|
|
figurinha,
|
|
audio,
|
|
video
|
|
]
|
|
.fi
|
|
.SH OPTIONS
|
|
.SS Core Settings
|
|
.TP
|
|
.B CLIENT_ID=\fIstring\fR
|
|
Unique identifier for the bot session.
|
|
.RS
|
|
.IP \(bu 2
|
|
Default: \fBbot_permanente\fR
|
|
.IP \(bu 2
|
|
Creates a \fIsession/CLIENT_ID/\fR folder for authentication data
|
|
.IP \(bu 2
|
|
Changing this starts a new session (requires QR code rescan)
|
|
.RE
|
|
.TP
|
|
.B CMD_PREFIX=\fIcharacter\fR
|
|
Character that prefixes all bot commands.
|
|
.RS
|
|
.IP \(bu 2
|
|
Default: \fB!\fR
|
|
.IP \(bu 2
|
|
Example: \fB!\fR makes commands like \fB!video\fR, \fB!audio\fR
|
|
.IP \(bu 2
|
|
Changing to \fB.\fR would make commands \fB.video\fR, \fB.audio\fR
|
|
.RE
|
|
.TP
|
|
.B LANGUAGE=\fIcode\fR
|
|
Bot interface language.
|
|
.RS
|
|
.IP \(bu 2
|
|
Default: \fBen\fR (English)
|
|
.IP \(bu 2
|
|
Options: \fBen\fR, \fBpt\fR (Portuguese), \fBes\fR (Spanish)
|
|
.IP \(bu 2
|
|
Fallback to English if selected language not found
|
|
.RE
|
|
.SS Chat Settings
|
|
.TP
|
|
.B CHATS=[\fIid1\fR, \fIid2\fR, ...]
|
|
Whitelist of chat IDs where the bot responds.
|
|
.RS
|
|
.IP \(bu 2
|
|
Default: \fB[]\fR (empty = respond to all chats)
|
|
.IP \(bu 2
|
|
Private chat format: \fBnumber@c.us\fR
|
|
.IP \(bu 2
|
|
Group format: \fBnumber@g.us\fR or \fBnumber-number@g.us\fR
|
|
.IP \(bu 2
|
|
Use \fBnode src/utils/get_id.js\fR to discover chat IDs
|
|
.RE
|
|
.SS Plugin Settings
|
|
.TP
|
|
.B PLUGINS=[\fIname1\fR, \fIname2\fR, ...]
|
|
List of plugins to load at startup.
|
|
.RS
|
|
.IP \(bu 2
|
|
Default: \fB[]\fR (no plugins loaded)
|
|
.IP \(bu 2
|
|
Each name must match a folder in \fIsrc/plugins/\fR
|
|
.IP \(bu 2
|
|
Order matters: plugins load in listed order
|
|
.IP \(bu 2
|
|
Comment out or remove to disable without deleting files
|
|
.RE
|
|
.SS Built-in Plugins
|
|
.TP
|
|
.B many
|
|
Lists all available commands. Required for \fB!many\fR to work.
|
|
.TP
|
|
.B figurinha
|
|
Converts images/GIFs/videos to WhatsApp stickers.
|
|
.TP
|
|
.B video
|
|
Downloads videos from URLs.
|
|
.TP
|
|
.B audio
|
|
Downloads audio from videos as voice messages.
|
|
.TP
|
|
.B adivinha\(,c\(oao
|
|
Guessing game (1-100).
|
|
.TP
|
|
.B forca
|
|
Hangman game.
|
|
.TP
|
|
.B obrigado
|
|
Responds to thank-you messages.
|
|
.SH CUSTOM SETTINGS
|
|
You can add any custom key-value pairs for use by plugins:
|
|
.PP
|
|
.nf
|
|
# In manybot.conf
|
|
ADMIN_NUMBER=5511999999999@c.us
|
|
API_KEY=your_secret_key
|
|
MAX_DOWNLOAD_SIZE=50MB
|
|
.fi
|
|
.PP
|
|
Access in plugins:
|
|
.nf
|
|
import { ADMIN_NUMBER, API_KEY, MAX_DOWNLOAD_SIZE } from "../../config.js";
|
|
.fi
|
|
.SH EXAMPLES
|
|
.SS Minimal Configuration
|
|
.nf
|
|
# Basic bot setup
|
|
CLIENT_ID=my_bot
|
|
CMD_PREFIX=!
|
|
LANGUAGE=en
|
|
|
|
PLUGINS=[
|
|
many
|
|
]
|
|
.fi
|
|
.SS Production Configuration
|
|
.nf
|
|
# Production bot with whitelist
|
|
CLIENT_ID=bot_prod
|
|
CMD_PREFIX=/
|
|
LANGUAGE=pt
|
|
|
|
CHATS=[
|
|
5511999999999@c.us,
|
|
5511888888888-123456789@g.us
|
|
]
|
|
|
|
PLUGINS=[
|
|
many,
|
|
figurinha,
|
|
video,
|
|
audio,
|
|
obrigado
|
|
]
|
|
|
|
# Custom settings
|
|
ADMIN_NUMBER=5511999999999@c.us
|
|
LOG_LEVEL=info
|
|
.fi
|
|
.SS Development Configuration
|
|
.nf
|
|
# Debug/development setup
|
|
CLIENT_ID=bot_dev
|
|
CMD_PREFIX=!
|
|
LANGUAGE=en
|
|
|
|
# Respond to all chats
|
|
CHATS=[]
|
|
|
|
# All plugins for testing
|
|
PLUGINS=[
|
|
many,
|
|
figurinha,
|
|
video,
|
|
audio,
|
|
adivinha\(,c\(oao,
|
|
forca,
|
|
obrigado
|
|
]
|
|
.fi
|
|
.SH FILES
|
|
.TP
|
|
.I manybot.conf
|
|
Main configuration file (must be created by user)
|
|
.TP
|
|
.I manybot.conf.example
|
|
Example configuration with documentation comments
|
|
.SH NOTES
|
|
\(bu Keys are case-sensitive
|
|
.br
|
|
\(bu Values are read as strings unless they're list syntax
|
|
.br
|
|
\(bu Inline comments supported: \fBKEY=value # comment\fR
|
|
.br
|
|
\(bu Multiline lists must end with \fB]\fR on its own line or last item line
|
|
.br
|
|
\(bu Whitespace in values is trimmed
|
|
.br
|
|
\(u Missing optional values use built-in defaults
|
|
.SH SEE ALSO
|
|
.BR manybot (1),
|
|
.BR manybot-plugin (1),
|
|
.BR manyplug (1)
|
|
.SH AUTHOR
|
|
Written by synt-xerror.
|