Stefan Hacker
2.3 KiB
Blacklist für STARFACE
Custom Block für den STARFACE Module Designer: prüft eingehende Anrufe gegen eine konfigurierbare Blacklist und behandelt anonyme Anrufe (unterdrückte Rufnummer). Pro Eintrag lässt sich festlegen, was passieren soll – auflegen, besetzt, umleiten oder Ansage abspielen.
Was kann das Modul?
- Pro Nummer / Bereich eine eigene Aktion:
HANGUP,BUSY,REDIRECT,ANNOUNCE,ALLOW - Anonyme Anrufer (Rufnummernunterdrückung) separat behandeln
- Bereichssperren (z.B. ganzer
0190-Bereich) inklusive Ausnahmen (ALLOW) - Robuste Nummern-Normalisierung (+49 / 0049 / 0… werden einheitlich verglichen)
Quick Start (selbst kompilieren)
cd v8-9-10
./build-block.sh # erzeugt BlacklistBlock.class
Die STARFACE-API-JARs werden automatisch aus dem benachbarten mail2fax-Modul genutzt,
falls sie nicht in v8-9-10/libs/starface/ liegen. Es sind keine Zusatz-Bibliotheken nötig.
Danach im Module Designer importieren → siehe v8-9-10/INSTALLATION.md.
Projektstruktur
blacklist-module/
├── README.md
└── v8-9-10/ # für STARFACE 8/9/10
├── BlacklistBlock.java # Custom Block Quellcode
├── BlacklistBlock.class # kompiliertes Ergebnis
├── build-block.sh # Kompilier-Script
├── README.md # technische Doku (Felder, Aktionen, Matching)
├── INSTALLATION.md # Schritt-für-Schritt im Module Designer
└── libs/starface/ # STARFACE API JARs (für den Build)
Unterschied zum Mail2Fax-Modul
| Mail2Fax | Blacklist | |
|---|---|---|
| Auslöser | Timer (pollt regelmäßig E-Mails) | eingehender Anruf (Call-Processing) |
| Runtime | normale Runtime | AGI-Runtime (Anruf-Kontext) |
| Zusatz-Libs | JavaMail erforderlich | keine |
| Aktion | Fax senden | Anruf auflegen/besetzt/umleiten/Ansage |
Wichtig zur Einbindung
Das Modul muss als Call-Processing-Modul mit Aktivierung "bei allen eingehenden Anrufen" eingebunden werden (oder gezielt in die Rufverteilung eines Benutzers/einer Gruppe). Nur dann läuft der Block im Anruf-Kontext und kann den Anruf beeinflussen. Details in v8-9-10/INSTALLATION.md.