About this plugin
This plugin connects a Telegram bot to your WordPress site to support
the community or group you manage:
- Validates every Telegram user against the plugin’s own database
table (username, Telegram ID and an access code). The code is stored
encrypted with AES-256-GCM (authenticated encryption) using the
php, and is managed from a
screen in the WordPress admin, with no loose JSON files.
- If a user is not validated, the bot does not reply at all -except
for a single private notice the first time they write- so no
information is exposed and no spam is generated.
- In a group, the bot only replies if it is mentioned (@bot username,
replying to one of its messages, or with a command directed at it).
In private chats it always replies, to already validated users.
- Includes configurable general commands: /reglas, /horario,
/anuncios, /recursos, /ayuda, /misdatos -all editable from
the WordPress admin, without touching code.
- Optional “rules menu”: with it enabled, /reglas replies with an
inline keyboard (one button per rule, plus “Ver todas”) instead of a
plain text block. Works in private chats and in whitelisted groups.
The rules are edited one per line, optionally as “Title | Detail”.
- Includes moderation commands for administrators, private chat only:
/validar, /invalidar, /listar, /anunciar, /stats.
- “Mis recursos”: each validated user can have a carnet (student/member
code). Files uploaded per carnet from the “Recursos por usuario” admin
screen are offered to that user -and only that user- when they send
/recursos in a private chat: one button per file plus a “download
all” button that sends a ZIP. The files are stored in a private,
web-inaccessible folder and are delivered straight to Telegram, never
through a public URL.
- “Entregas”: validated users can send a file to the bot in a private
chat and have it stored on the server, filed under their carnet and a
configurable delivery (assignment/task). Admins define each delivery
(slug, label, optional file-name pattern, size limit and open window)
from the “Entregas” screen and review or download the received files
from “Entregas recibidas”. Files are kept in the same private,
web-inaccessible folder style as “Mis recursos” and are never opened
by the bot.
- Integrates an Ollama (conversational AI) client that is already
built but disabled by default: once your Ollama server is ready,
just enable the checkbox and set the URL/model in Settings. Until
then the bot replies with a notice instead of failing.
Use cases
Built for any Telegram community that needs to moderate access and
automate replies: study groups, communities of practice, work teams,
clubs or product support.
External services
This plugin connects to the following external services to work:
- Telegram Bot API ( https://api.telegram.org ) – required for the
bot to function. The plugin sends your bot token and the text
messages exchanged with Telegram users (inbound and outbound) so it
can receive and reply to messages via webhook. Subject to Telegram’s
Terms of Service and
Privacy Policy.
- Ollama (URL you configure, typically your own server) – optional
and disabled by default. If you enable it, the text of messages from
validated users is sent to the URL you configure to generate an AI
reply. No information is sent to any third-party server other than
the one you specify in Settings.
Requirements
- WordPress 5.8 or higher.
- PHP 7.4 or higher, with the openssl extension enabled.
- A site with valid HTTPS (Telegram does not accept webhooks over
http://).
- A bot created with @BotFather on Telegram.