> ## 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.
# Purpleview mit anny verbinden
> Verbinde Purpleview mit anny und versende automatisch Videoberatungs-Links mit jeder bestätigten Buchung.
[Purpleview](https://www.purpleview.de) ist ein Anbieter für professionelle Videoberatung, mit dem Organisationen wie Verwaltungen und Beratungsstellen Termine per Video durchführen. Mit der Integration erzeugt anny für jede passende bestätigte Buchung automatisch einen persönlichen Videotermin-Link zu deiner Purpleview-Umgebung.
Mit Purpleview kannst du in anny:
* jede bestätigte Buchung automatisch mit einem persönlichen Videotermin-Link ausstatten
* Ressourcen und Dienstleistungen über Regeln gezielt einzelnen Beratungsgruppen und Terminarten zuordnen
* Kund:innen den Link direkt über die Buchungsbestätigung und den Kalendereintrag bereitstellen
Besonders praktisch ist die Integration für Bürgerbüros, Beratungsstellen und Serviceteams, die ihre Termine über anny buchbar machen und direkt per Video durchführen möchten.
Verfügbar in Plänen mit dem Feature für Video-Meeting-Integrationen.
## Typische Anwendungsfälle
| Anwendungsfall | Beschreibung |
| :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Bürgerservice der Verwaltung | **Videotermine für Anliegen wie KFZ-Zulassung oder BAföG.** Kund:innen buchen online einen Termin und erhalten den Beratungslink automatisch mit der Buchungsbestätigung. |
| Fachbereiche mit eigenen Beratungsgruppen | **Jede Ressource führt in die passende Beratungsgruppe.** Über Gruppen-Hash und Terminart der Regel landet jeder Termin beim richtigen Team in Purpleview. |
| Hybride Terminangebote | **Nur ausgewählte Dienstleistungen erhalten einen Videolink.** Über den Dienstleistungs-Filter der Regeln bleiben Vor-Ort-Termine ohne Link, Online-Termine bekommen ihn automatisch. |
## Wie die Purpleview-Verbindung funktioniert
Die Verbindung basiert auf einem gemeinsamen Geheimschlüssel, dem **Shared Secret**. Du erzeugst ihn in anny und hinterlegst ihn in deiner Purpleview-Umgebung. anny ruft keine Purpleview-Schnittstelle auf und liest keine Daten aus deiner Purpleview-Umgebung. Stattdessen erzeugt anny für jede passende Buchung einen mit dem Shared Secret signierten Link, den Purpleview beim Öffnen prüft.
Der Ablauf:
1. Eine Buchung wird abgeschlossen. Nur bestätigte Buchungen mit zugeordneter Kund:in erhalten einen Link.
2. anny prüft, ob eine Regel zur Ressource und Dienstleistung der Buchung passt. Regeln auf einer übergeordneten Ressource gelten auch für Buchungen ihrer Unterressourcen.
3. Trifft eine Regel zu, erzeugt anny den Videotermin-Link und hängt ihn an die Buchung. Kund:innen sehen ihn als Button **Online Termin beitreten** in den Buchungs-E-Mails und im Kalendereintrag. Du findest ihn in den Buchungsdetails über **Meeting öffnen**.
Im Link stecken der Name der Kund:in, die Terminart, die Startzeit und eine Termin-ID. Diese Daten werden erst an Purpleview übertragen, wenn jemand den Link öffnet.
anny hält den Link automatisch aktuell: Wird eine Buchung verschoben, auf eine andere Ressource verlegt oder ändert sich ihr Status, ersetzt anny den Link durch einen neuen. Bei Stornierung, Ablehnung oder Löschung entfernt anny den Link von der Buchung. Wird eine Buchung erst später bestätigt, entsteht der Link im Moment der Bestätigung. Serienbuchungen erhalten für jeden Termin einen eigenen Link.
Generierst du das Shared Secret neu, passen zuvor erzeugte Links nicht mehr zum neuen Secret. Sobald Purpleview das neue Secret verwendet, funktionieren die alten Links nicht mehr.
## Purpleview verbinden
### Voraussetzungen
Bevor du Purpleview verbindest, stelle sicher, dass du Folgendes hast:
* Eine eigene Purpleview-Umgebung mit Basis-URL und Mandanten-Hash
* Die Gruppen-Hashes deiner Beratungsgruppen und die Bezeichnungen der Terminarten aus Purpleview
* Die Möglichkeit, das Shared Secret aus anny in deiner Purpleview-Umgebung zu hinterlegen (kläre das mit deinem Purpleview-Kontakt)
* Admin-Rechte in deinem anny Account
### Verbindung einrichten
Öffne aus der Menüleiste die **Integrationen** und gehe zu **PurpleView**. Trage die **Basis-URL** deiner Purpleview-Umgebung und den **Mandanten-Hash** ein.
Klicke bei **Shared Secret** auf **Secret generieren**. Kopiere das Secret sofort, denn es wird nur ein einziges Mal angezeigt. Hinterlege es anschließend in deiner Purpleview-Umgebung.
Klicke im Bereich **Regeln** auf **Hinzufügen**. Wähle die **Ressource**, optional einzelne **Dienstleistungen** (ohne Auswahl gilt die Regel für **Alle Dienstleistungen**) und trage **Gruppen-Hash** und **Terminart** aus Purpleview ein. Speichere mit **Bestätigen**.
Aktiviere die Integration über den **Toggle** oben rechts.
Sobald die Integration aktiv ist, erhält jede neue bestätigte Buchung mit passender Regel automatisch ihren Videotermin-Link.
Teste die Einrichtung mit einer Testbuchung: Prüfe, ob der Button **Online Termin beitreten** in der Bestätigungs-E-Mail erscheint und der Link deine Purpleview-Umgebung öffnet.
### Einstellungen & Optionen
| Einstellung | Beschreibung |
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
| Basis-URL | Adresse deiner Purpleview-Umgebung. Sie bildet den Anfang aller erzeugten Links. |
| Mandanten-Hash | Kennung deines Mandanten bei Purpleview. Sie ist Teil jedes erzeugten Links. |
| Shared Secret | Geheimschlüssel zur Signierung der Links. Über **Secret generieren** bzw. **Secret regenerieren** erzeugst du ihn neu; er wird nur einmal angezeigt. |
| Ressource | Die Ressource, für die die Regel gilt. Regeln auf einer übergeordneten Ressource gelten auch für deren Unterressourcen. |
| Dienstleistungen | Optionaler Filter: Die Regel greift nur für die gewählten Dienstleistungen. Ohne Auswahl gilt sie für **Alle Dienstleistungen**. |
| Gruppen-Hash | Kennung der Purpleview-Beratungsgruppe, in die der Termin führt. |
| Terminart | Bezeichnung der Terminart, die Purpleview dem Termin zuordnet (z. B. KFZ). |
Lege pro Ressource möglichst eindeutige Regeln an. Passt mehr als eine Regel auf eine Buchung, verwendet anny die zuerst angelegte passende Regel.
## Einschränkungen
Die Purpleview-Integration unterstützt nicht:
* **Kalender- oder Datensync:** anny legt keine Termine in Purpleview an und liest dort keine Daten aus. Alle Informationen stecken im Link und werden erst beim Öffnen übertragen.
* **Separater Moderations-Link:** anny erzeugt genau einen Link pro Buchung; dein Team und deine Kund:innen nutzen denselben Link.
* **Echter Verbindungstest:** **Verbindung testen** prüft nur, ob Basis-URL, Mandanten-Hash und Shared Secret hinterlegt sind, nicht ob die Werte auf Purpleview-Seite stimmen.
* **Eigene Link-E-Mail:** Der Link wird ausschließlich über die normalen Buchungs-E-Mails und den Kalendereintrag geteilt; eine separate Benachrichtigung gibt es nicht.
* **Namensänderungen:** Ändert sich der Name der Kund:in nachträglich, behält der bestehende Link den alten Namen. Erst eine Termin- oder Statusänderung erzeugt einen neuen Link.
## Verbindung trennen
Wenn du die Integration deaktivierst, erzeugt anny keine neuen Videotermin-Links mehr. Bereits erzeugte Links bleiben auf den Buchungen bestehen und werden bei Änderungen oder Stornierungen nicht mehr aktualisiert oder entfernt. Beim Löschen werden Einstellungen, Regeln und das Shared Secret entfernt; bereits erzeugte Links bleiben ebenfalls bestehen. Möchtest du bestehende Links ungültig machen, ändere das hinterlegte Secret in deiner Purpleview-Umgebung.
Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.
## FAQ
Als Button **Online Termin beitreten** in den Buchungs-E-Mails und als Link im Kalendereintrag der Buchung. Du selbst findest ihn in den Buchungsdetails im Bereich **Kalender Synchronisationen** über **Meeting öffnen**.
anny ersetzt den Link automatisch durch einen neuen mit der aktualisierten Startzeit. Der aktuelle Link steht in der neuesten Buchungs-E-Mail und in den Buchungsdetails; ältere E-Mails enthalten noch den vorherigen Link.
Nein. Nur bestätigte Buchungen mit zugeordneter Kund:in erhalten einen Videotermin-Link. Bestätigst du eine Anfrage später, erzeugt anny den Link im Moment der Bestätigung.
Du musst das neue Secret auch in deiner Purpleview-Umgebung hinterlegen. Bestehende Links wurden mit dem alten Secret signiert und funktionieren nicht mehr, sobald Purpleview das neue Secret verwendet. Erzeuge das Secret deshalb am besten nur, wenn du es wirklich austauschen möchtest.
## Troubleshooting
Ursache: Die Integration ist deaktiviert, es passt keine Regel oder die Buchung ist nicht bestätigt bzw. hat keine zugeordnete Kund:in. Prüfe den **Toggle** der Integration und die Regel: Stimmen Ressource und Dienstleistung? Bei Unterressourcen lege die Regel auf die übergeordnete Ressource.
Ursache: Die Signatur oder die Kennungen passen nicht zusammen, z. B. weil das Shared Secret neu generiert, aber nicht bei Purpleview hinterlegt wurde, oder weil Basis-URL, Mandanten-Hash oder Gruppen-Hash fehlerhaft sind. Vergleiche die Werte mit deiner Purpleview-Umgebung und hinterlege bei Bedarf ein frisch generiertes Secret auf beiden Seiten.
Ursache: Der Link stammt aus einer älteren E-Mail von vor der Terminänderung. Der aktuelle Link steht in der neuesten Buchungs-E-Mail und in den Buchungsdetails; teile ihn bei Bedarf erneut.
> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Purpleview ist eine der Video-Meeting-Integrationen (Kategorie „Online Meeting-Integrationen") neben Zoom, MS Teams und anny Videoanrufen. Anders als Zoom/MS Teams gibt es keine API- oder OAuth-Verbindung und keinen Terminaustausch: anny erzeugt ausschließlich lokal signierte Links (HMAC über Gruppen-Hash, Termin-ID, Kundenname, Terminart und Start-Zeitstempel mit dem Shared Secret).
>
> **UI-Pfade & Wortlaut:** Menüleiste → **Integrationen** → Kachel „PurpleView" (UI-Schreibweise mit großem V; der UI-Beschreibungstext nennt die Purpleview-Plattform „empathy"). Panel „PurpleView-Einstellungen": Felder „Basis-URL", „Mandanten-Hash", Zeile „Shared Secret" mit Button „Secret generieren" bzw. „Secret regenerieren" (Modal-Hinweis: „Kopiere dieses Secret jetzt. Es wird nicht erneut angezeigt."). Panel „Regeln" → Button „Hinzufügen"; Dialog „Regel erstellen"/„Regel bearbeiten" mit Feldern „Ressource", Dienstleistungs-Auswahl (Platzhalter „Alle Dienstleistungen"), „Gruppen-Hash", „Terminart" (Platzhalter „EWID, KFZ, BAFOEG..."), Speichern über „Bestätigen". Tabellen-Spalten: „Ressource", „Dienstleistungen", „Gruppen-Hash", „Terminart". Drei-Punkte-Menü: „Integration aktivieren"/„Integration deaktivieren", „Verbindung testen", „Authentifizierung entfernen" (nur bei deaktivierter Integration sichtbar; löscht das gespeicherte Shared Secret), „Löschen". Buchungsdetails: Panel „Kalender Synchronisationen" → Button „Meeting öffnen". Ressourcen-Detailseite → Integrationen → Panel „Online Meeting-Integrationen" listet Integrationen, deren Regeln die Ressource verwenden.
>
> **Quirks:** (1) Bei mehreren passenden Regeln gewinnt die zuerst angelegte; es gibt keine Sortierfunktion für Regeln. (2) Der Regelabgleich läuft immer über die oberste Ressource der Buchung. (3) Jede relevante Änderung (Ressource, Status, Start, Ende) erzeugt einen komplett neuen Link mit neuer Termin-ID; alte Links aus früheren E-Mails werden dadurch nicht technisch entwertet, weil ihre Signatur gültig bleibt. (4) Im Kalendereintrag (ICS) steht der Link als „Join Meeting"-Zeile in der Beschreibung; der E-Mail-Button heißt „Online Termin beitreten". (5) In den Buchungsdetails erscheint als Quelle des Link-Eintrags „anny", nicht „Purpleview". (6) Die Link-Erzeugung setzt einen nicht leeren Kundennamen voraus. (7) Serienbuchungen: ein eigener Link pro Serientermin, kein Link für den Serienmaster.
>
> **Beziehungen:** Freischaltung über dasselbe Plan-Feature wie alle Video-Meeting-Integrationen (Zoom, MS Teams, anny Video-Calls); die Plan-Zuordnung ist nicht im Artikel dokumentiert. Verwandte Artikel: zoom, ms-teams, anny-video-calls.