Watch

Eddy de Vink e4d817ff80 refactor: switch to dedicated group, remove @mention requirement, add pinned message service

- Change ALLOWED_GROUP to Dienst opvragen EdGPT-EBS (120363407613652082@g.us)
- Remove isBotMentioned check (no @mention needed)
- Match only exact 4-digit messages (regex /^\s*(\d{4})\s*$/)
- Add pinnedMessageService.js: auto-repins welcome message when expired
- Move incrementDaily() to count all 4-digit messages, not just successful ones
- Update daily summary with emoji
- Update docs and .env.example

2026-05-26 09:20:49 +02:00

4.1 KiB

Raw Blame History

Dienst Bot

Dit project is gemaakt door middel van vibecoding met OpenCode 1.14.40.

WhatsApp bot die dienstschema's (PNG) privé verstuurt op basis van een 4-cijferig dienstnummer, gepost in een speciale WhatsApp groep.

Hoe het werkt

Iemand stuurt een 4-cijferig dienstnummer in de groep (bijv. 4002)
De bot zoekt het dienstschema op in dienst-tijden.json
De bijbehorende PNG-bestanden worden privé naar de afzender gestuurd
Via een vastgezet welkomstbericht in de groep staat uitleg over het gebruik

De bot gebruikt een speciale groep (Dienst opvragen EdGPT-EBS) waarin elk bericht dat uit exact 4 cijfers bestaat wordt verwerkt. Geen @mention nodig.

Vereisten

Node.js 18+
wwebjs-api Docker container (poort 3000)
WhatsApp sessie "EdGpt" actief in wwebjs-api
PM2 (optioneel, voor procesbeheer)

Installatie

git clone <repo-url>
cd dienst_echo_whatsappgroep
npm install

Configuratie

Kopieer .env.example naar .env en vul de waarden in:

# WhatsApp API
WHATSAPP_API_ENDPOINT=http://localhost:3000
WHATSAPP_SESSION=EdGpt

# Webhook
WEBHOOK_PORT=3002
ALLOWED_GROUP=120363407613652082@g.us

# Bestanden
DIENSTEN_JSON=./diensten/dienst-tijden.json
DIENSTEN_PNG=./diensten/png

# Admin
ADMIN_NUMBER=31620248011@c.us

wwebjs-api webhook config

In de .env van wwebjs-api:

BASE_WEBHOOK_URL=http://host.docker.internal:3002/webhook
ENABLE_LOCAL_CALLBACK_EXAMPLE=FALSE
ENABLE_WEBHOOK=TRUE

Belangrijk: gebruik docker compose up -d (niet docker restart) om .env wijzigingen door te voeren.

Data

De map diensten/ bevat:

dienst-tijden.json — array met dienstmetadata:

[
  {
    "dienstnummer": "4002",
    "startTime": "09:30",
    "endTime": "10:30",
    "paginas": [
      { "bestandsnaam": "4002-001.png" },
      { "bestandsnaam": "4002-002.png" }
    ]
  }
]

png/ — PNG bestanden met dienstschema's (bijv. 4002-001.png)

Beide zijn uitgesloten van git via .gitignore.

Gebruik

Starten

npm start

Of met PM2:

npx pm2 start src/index.js --name dienst-bot
npx pm2 save

Stoppen

npx pm2 stop dienst-bot

Logs bekijken

npx pm2 logs dienst-bot

Projectstructuur

src/
  index.js              # Express webhook server + cron job
  messageHandler.js     # Berichtverwerking en filtering
  rateLimiter.js        # Spam protectie (max 5 per dag)
  dailyStats.js         # Dagelijkse aanvraag-teller
  dienstService.js      # JSON lookup en PNG bestandspaden
  whatsappApi.js        # WhatsApp API client (bericht + afbeelding)
  pinnedMessageService.js  # Vastgezet welkomstbericht beheer

Welkomstbericht

De groep heeft een vastgezet welkomstbericht dat automatisch door EdGpt wordt herplaatst als het is verlopen (30 dagen). De tekst luidt:

Welkom in Dienst opvragen EdGpt-EBS. Stuur hier je 4 cijferige dienstnummer en EdGpt zal het prive naar je toe sturen, alleen 4 cijfers meer niet.

Bij elke interactie met de groep controleert de bot of het pinned bericht nog bestaat en plaatst het opnieuw indien nodig.

Foutafhandeling

Ongeldig dienstnummer: de bot stuurt een melding terug naar de afzender
Fout bij verzenden PNG: de admin krijgt een WhatsApp melding
Webhook fout: wordt gelogd in PM2 logs

Spam protectie

Elke gebruiker kan maximaal MAX_REQUESTS_PER_DAY (standaard 5) diensten per dag opvragen. Bij overschrijding krijgt de gebruiker een melding. De teller wordt dagelijks automatisch gereset (bij de eerste request na middernacht).

Dagelijkse samenvatting

Elke dag om 10:00 stuurt de bot een WhatsApp-bericht naar ADMIN_NUMBER met het totaal aantal alle 4-cijferige berichten van de vorige dag (00:00 t/m 23:59).

📊 Aantal dienstaanvragen gisteren: N

De teller wordt bijgehouden in memory door dailyStats.js en gereset na verzending van de samenvatting. De scheduling gebruikt node-cron (0 10 * * *).

Licentie

Public Domain

4.1 KiB Raw Blame History