> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Broadcasting

> Sende gezielte Nachrichten an Kund:innen, basierend auf Buchungen, Kundenprofilen oder Abonnements.

Mit dem Broadcast-Feature versendest du gezielte Nachrichten an definierte Empfängergruppen. Statt einzeln zu kommunizieren, erreichst du alle relevanten Kund:innen auf einmal, ob einmalig bei kurzfristigen Änderungen oder automatisiert als wiederkehrende Kampagne.

> [!NOTE]
>
> Verfügbar ab **Professional**. Broadcasting ist ein Plan-Feature, kein Schalter unter **Account-Einstellungen** → **Features**.

## Wie funktioniert Broadcast?

Broadcast arbeitet in drei Schritten:

1. **Empfänger definieren**: Du wählst eine von drei Basen (Buchungen, Kunden oder Abonnements) und filterst die Zielgruppe über Kriterien wie Zeitraum, Ressource, Community oder Abo-Plan.
2. **Nachricht konfigurieren**: Du erstellst eine Nachricht mit Betreff, Inhalt und optionalem Button. Tippe **#**, um Platzhalter einzufügen (gespeichert z. B. als `{customer.given_name}`).
3. **Versenden**: Du entscheidest, ob die Nachricht **Jetzt senden**, **Später senden** oder **Wiederkehrend** (täglich, wöchentlich, monatlich) versendet wird.

Die Nachricht wird über einen oder mehrere Kanäle gleichzeitig zugestellt: **Email**, **SMS** und **Push-Notification** (anny App). Einen eigenen Browser-Notification-Kanal gibt es nicht.

> [!TIP]
>
> Alternativ startest du einen Broadcast direkt aus der **Buchungen**-, **Kunden**- oder **Abos**-Ansicht: Filtere dort deine gewünschte Empfängerliste und klicke oben rechts auf **Broadcast**. Die Empfängerliste wird übernommen und kann im Broadcast nachträglich angepasst werden.
>
> Den Kampagnen-Bereich selbst findest du unter **Kunden** → **Broadcasting**.

## Wann nutze ich das?

* **Du musst Kund:innen kurzfristig über Änderungen informieren (z. B. Raumschließung, Ausfall)**: Einmaliger Broadcast an alle betroffenen Buchungen.
* **Du möchtest regelmäßige Erinnerungen automatisieren (z. B. Wochenplanung, Equipment-Rückgabe)**: Wiederkehrender Broadcast mit passenden Filtern.
* **Du willst Abo-Kund:innen gezielt ansprechen (z. B. Event-Newsletter, Verlängerungshinweis)**: Broadcast basierend auf Abonnements mit Abo-Plan-Filter.
* **Nicht geeignet für**: Transaktionale Einzelbenachrichtigungen wie Buchungsbestätigungen oder Erinnerungen. Dafür nutze E-Mail Templates.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Communities | Community-Zugehörigkeit als Empfänger-Filter nutzbar |
| Abos und Mitgliedschaften | Abo-Plan als Empfänger-Basis und Filter verfügbar |
| Check-In & Check-Out | Check-out-Status als Filter bei buchungsbasierten Broadcasts |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Empfänger-Basis | Buchungen, Kunden oder Abonnements |
| Channel | Email, SMS, Push-Notification |
| Platzhalter | Mit **#** einfügen, intern z. B. `{customer.given_name}` |
| Button | Optionaler CTA mit Titel und Ziel-URL |
| Vorlage speichern | Nachricht für spätere Verwendung sichern |
| Versandmodus | Jetzt senden, Später senden oder Wiederkehrend |
| Intervall | Täglich, wöchentlich oder monatlich |

### Filteroptionen nach Empfänger-Basis

**Basierend auf Buchungen:**

| Filter | Beschreibung |
| - | - |
| Zeitraum / Tag | Buchungen in einem bestimmten Zeitfenster |
| Ressource | Bestimmte Räume, Equipment oder Bereiche |
| Buchungsoptionen | Spezifische Buchungsoptionen |
| Status | Buchungsstatus (z. B. bestätigt, storniert) |
| Community | Nur Mitglieder einer bestimmten Community |
| Check-In / Check-Out | Eingecheckt oder ausgecheckt |
| Add-Ons, UTM, Custom Fields | Weitere Filter der Buchungsliste |

**Basierend auf Kundenprofilen:**

| Filter | Beschreibung |
| - | - |
| Community | Mitgliedschaft in einer Community |
| Registrierungsdatum | Zeitpunkt der Registrierung |
| Anzahl Buchungen | Buchungsanzahl insgesamt oder in einem Zeitraum |
| Geburtsdatum | Für Geburtstagsnachrichten |
| Unternehmen, E-Mail, Custom Fields | Weitere Kundenfilter |

**Basierend auf Abonnements:**

| Filter | Beschreibung |
| - | - |
| Abo-Plan | Kund:innen mit einem bestimmten Abo-Plan |
| Status, Abrechnung, offene Rechnung | Weitere Abo-Filter |

## Praxisbeispiele

> **Ein Coworking-Space informiert über geänderte Feiertags-Öffnungszeiten**
>
> Alle Community-Mitglieder sollen vor den Feiertagen über abweichende Öffnungszeiten informiert werden. Der Broadcast wird einmalig per E-Mail und Push-Notification versendet.

> **Ein Fitnessstudio versendet einen monatlichen Event-Newsletter an Abo-Kund:innen**
>
> Alle Kund:innen mit einem aktiven Abo-Plan sollen monatlich über anstehende Events und Kursangebote informiert werden. Der Broadcast wird wiederkehrend per E-Mail versendet.

## FAQ

> **Können Empfänger auf eine Broadcast-Nachricht antworten?**
>
> Nein. Broadcast-Nachrichten sind rein informativ und unterstützen keine Antwortfunktion. Für individuelle Kommunikation nutze die Kontaktdaten im Kundenprofil.

> **Was passiert, wenn ich einen Broadcast an Buchungen sende und eine Buchung storniert wird?**
>
> Broadcast hat rein informativen Charakter und löst keine automatische Stornierung oder Statusänderung von Buchungen aus. Wenn du z. B. über eine Raumschließung informierst, musst du die betroffenen Buchungen separat stornieren.

> **Kann ich eine wiederkehrende Kampagne nachträglich anpassen?**
>
> Ja. Öffne die Kampagne unter **Broadcasting**, passe Nachricht oder Filter an und speichere. Die Änderungen gelten ab dem nächsten geplanten Versand.

> **Welche Platzhalter kann ich verwenden?**
>
> Setze ein **#-Zeichen**, um die Variablenauswahl zu öffnen. Gespeichert wird z. B. `{customer.given_name}`, `{booking.resource}` oder `{plan.name}`. Der Platzhalter wird beim Versand durch die Daten des Empfängers ersetzt.

> **Wer erhält Broadcast-Nachrichten?**
>
> Ausschließlich Personen, die in deiner anny-Organisation als Kund:in registriert sind und den gewählten Filterkriterien entsprechen.

## Troubleshooting

> **Die Empfängerliste zeigt keine Einträge an**
>
> Die Filterkombination ergibt keine Treffer. Prüfe, ob der gewählte Abo-Plan aktive Abonnent:innen hat oder ob der Zeitraum-Filter Buchungen enthält. Bei Abo-basierten Broadcasts: Stelle sicher, dass du einen konkreten Abo-Plan ausgewählt hast (das Feld darf nicht leer bleiben).

> **Kund:innen erhalten die Broadcast-Nachricht nicht**
>
> Prüfe den gewählten Channel. Bei E-Mail: Hat die Person eine gültige E-Mail-Adresse hinterlegt? Bei Push: Ist die anny App installiert und sind Benachrichtigungen aktiviert? Bei SMS: Ist eine Mobilnummer vorhanden?

> **Mein Broadcast wird automatisch blockiert**
>
> anny blockiert Broadcasts, wenn die Nachricht als schädlich erkannt wird und deine Organisation nicht auf der Trusted-Account-Whitelist steht. Wende dich an den Support, um deine Organisation freischalten zu lassen.

> Wichtige Informationen für Agenten:
>
> * Feature: `broadcast-campaigns`, verfügbar ab Professional. Kein Toggle unter Account-Einstellungen → Features.
> * UI-Pfad: **Kunden** → **Broadcasting** (`/campaigns`). Start auch aus Buchungen, Kunden und Abos.
> * Drei Empfänger-Basen in der UI: Buchungen, Kunden, Abonnements. Backend kennt zusätzlich `static` (UI auskommentiert) und `community`.
> * Kanäle: Email, Push-Notification, SMS. Kein Browser-Notification-Kanal. SMS braucht aktivierte Mobile Notifications.
> * Platzhalter: `#` öffnet die Variablenauswahl. Gespeichert als `{customer.given_name}` etc., nicht als `#Vorname`.
> * Versand: **Jetzt senden**, **Später senden**, **Wiederkehrend**.
> * Grenzwert: Empfänger müssen in der anny-Organisation als Kund:in registriert sein
> * Trusted-Account-Whitelist (`broadcast_whitelisted`): umgeht Malicious-Content-Erkennung und `broadcast_blocked`. Auto-Block kommt aus Template-Analyse, nicht aus Versandvolumen.
> * Broadcast-Nachrichten sind im Kundenprofil einsehbar (Reiter **Broadcast-Nachrichten**)
> * Abgrenzung: Broadcast ist nicht gleich E-Mail Templates. E-Mail Templates sind transaktionale Benachrichtigungen (Buchungsbestätigung, Erinnerung). Broadcasting ist proaktive Masseninformation an definierte Empfängergruppen.
> * Broadcast hat rein informativen Charakter und löst keine automatische Stornierung oder Statusänderung von Buchungen aus
> * Bug-Fix 22.07.2026: Abo-Plan-Filter mit leerer Auswahl zeigte keine Empfänger. Leere Plan-Auswahl wird jetzt ignoriert (zeigt alle Abonnent:innen).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.