WhatsApp Messenger Block for Moodle

A Moodle block plugin that enables teachers to send WhatsApp messages to students enrolled in their courses using the WhatsApp Business API.

Features

• Send WhatsApp messages to individual students or all enrolled students
• Plugin-level configuration for WhatsApp Business API credentials
• Support for WhatsApp templates with dynamic placeholders
• Message logging for tracking sent messages
• AJAX-based interface with real-time status updates
• Uses students' phone numbers from their Moodle profile
• Multi-language support (English and Hebrew)

Requirements

• Moodle 3.9 or higher
• WhatsApp Business API account
• Access token and Phone Number ID from WhatsApp Business

Installation

1. Copy the plugin folder to your Moodle installation: {moodle}/blocks/whatsapp_messenger/
2. Log in as administrator and visit the notifications page to install
3. Configure the plugin settings with your WhatsApp Business API credentials

Configuration

Go to Site administration > Plugins > Blocks > WhatsApp Messenger and configure:

• Access Token: Your WhatsApp Business API access token
• Phone Number ID: Your WhatsApp Business phone number ID
• API Version: WhatsApp API version (default: v17.0)
• Template Name: WhatsApp template name (optional)
• Template Language: Template language code (e.g., en_US, he_IL)
• Template Content: Paste your template for reference with available placeholders
• Debug Mode: Enable detailed logging for troubleshooting

Template Placeholders

Available placeholders for templates: - {firstname} - Student first name - {lastname} - Student last name - {fullname} - Student full name - {email} - Student email - {coursename} - Course name - {courseid} - Course ID - {courseshortname} - Course short name - {message} - The actual message content entered by the teacher - {teachername} - Teacher full name - {sitename} - Site name - {date} - Current date (short format) - {datetime} - Current date and time - {time} - Current time

Usage

1. Add the block to a course page
2. Select a recipient (individual student or all students)
3. Type your message
4. Click "Send Message"

The plugin will send messages to students who have phone numbers in their profile (phone1 or phone2 field).

Permissions

• block/whatsapp_messenger:addinstance - Add the block to a course
• block/whatsapp_messenger:sendmessage - Send WhatsApp messages

Database

The plugin creates a log table block_whatsapp_messenger_log to track all sent messages.

Copyright

Copyright © 2025 CentricApp LTD

This plugin was developed by CentricApp LTD, a leading provider of educational technology solutions.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Support

For support and inquiries, please visit centricapp.co.il

WhatsApp Business Phone Setup / התקנת מספר טלפון ייעודי

עברית: אם אתם מעוניינים להתקין מספר טלפון ייעודי לשליחת הודעות WhatsApp, אנו יכולים לסייע לכם ברכישה, קונפיגורציה והתקנה של המערכת. ניתן לפנות אלינו במייל:

📧 support@centricapp.co.il

English: If you would like to set up a dedicated phone number for sending WhatsApp messages, we can assist you with purchasing, configuration, and installation of the system. Please contact us at:

📧 support@centricapp.co.il