> ## 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.

# Treatwell mit anny verbinden

> Importiere Treatwell-Buchungen automatisch in anny und spiegle anny-Buchungen per Kalenderlink nach Treatwell.

[Treatwell](https://www.treatwell.de/) ist eine Buchungsplattform für Beauty- und Wellness-Anbieter, über die Endkund:innen Termine bei Salons und Studios buchen. Mit der Integration hält anny Buchungen aus beiden Systemen weitgehend synchron: Treatwell-Buchungen kommen per E-Mail-Weiterleitung in anny, anny-Buchungen werden per Kalenderlink in Treatwell sichtbar.

Mit Treatwell kannst du in anny:

* Treatwell-Buchungen automatisch per E-Mail-Weiterleitung importieren, inklusive Änderungen und Stornierungen
* Doppelte Einträge vermeiden und Prepaid-Zahlungen aus Treatwell berücksichtigen
* anny-Buchungen per Kalenderlink (ICS) in Treatwell als belegte Zeiten sichtbar machen

Besonders praktisch ist die Integration, wenn du Treatwell und anny parallel nutzt und deine Buchungen zentral in anny verwalten möchtest, ohne Termine doppelt zu pflegen.

## Typische Anwendungsfälle

| Anwendungsfall                | Beschreibung                                                                                                                                                                              |
| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Salon mit Treatwell-Buchungen | **Treatwell-Buchungen landen automatisch in anny.** Die Buchungs-E-Mail wird an die anny Inbox weitergeleitet, anny legt den Termin an oder aktualisiert ihn, auch bei Stornierungen.     |
| Studio mit Direktbuchungen    | **anny-Buchungen werden in Treatwell sichtbar.** Termine, die du direkt in anny anlegst, etwa per Telefon oder Walk-in, erscheinen über den Kalenderlink in Treatwell als belegte Zeiten. |
| Prepaid-Termine               | **Vorauszahlungen werden übernommen.** Meldet Treatwell eine Vorauszahlung, berücksichtigt anny die Prepaid-Information bei der Buchung.                                                  |

## Wie die Treatwell-Verbindung funktioniert

Die Integration nutzt zwei getrennte Wege, je nach Synchronisationsrichtung:

* **Treatwell → anny** läuft über E-Mail-Weiterleitung. Du leitest Treatwell-Buchungs-E-Mails an eine dedizierte anny Inbox weiter. anny AI liest die Inhalte robust aus und legt Buchungen an oder aktualisiert sie, auch wenn Treatwell das E-Mail-Layout ändert.
* **anny → Treatwell** läuft über einen Kalenderlink. anny stellt einen ICS-Kalenderfeed bereit (ICS ist ein standardisiertes Kalenderformat), den du in Treatwell importierst. Treatwell zeigt anny-Buchungen darüber als belegte Zeiten an.

Weil beide Richtungen über unterschiedliche Wege laufen, ist die Synchronisation nicht in Echtzeit. Rechne mit einer typischen Verzögerung von etwa 30 bis 60 Sekunden.

| Daten                                     | Richtung         | Häufigkeit                                                   |
| ----------------------------------------- | ---------------- | ------------------------------------------------------------ |
| Neue Buchungen, Änderungen, Stornierungen | Treatwell → anny | Per E-Mail-Weiterleitung, ca. 30 bis 60 Sekunden Verzögerung |
| Buchungen als belegte Zeiten              | anny → Treatwell | Per ICS-Kalenderlink, ca. 30 bis 60 Sekunden Verzögerung     |

## Treatwell verbinden

### Voraussetzungen

Bevor du Treatwell verbindest, stelle sicher, dass du Folgendes hast:

* Ein aktives **Treatwell-Konto** mit Zugriff auf die Buchungsbestätigungs-E-Mails
* Die Möglichkeit, in deinem E-Mail-Postfach eine **Weiterleitungsregel** für Treatwell-Buchungs-E-Mails einzurichten
* Zugriff auf den anny **Adminbereich**, um die Integration einzurichten und den Kalenderlink abzurufen

### Verbindung einrichten

<Steps>
  <Step title="Treatwell-Integration öffnen">
    Öffne im Adminbereich die **Integrationen** und wähle **Treatwell**.
  </Step>

  <Step title="Weiterleitung im Postfach einrichten">
    Unter **Postfach für Treatwell-Mails** zeigt anny dir eine dedizierte **E-Mail-Adresse** (z. B. `tw-…@calendar.anny.co`). Richte in deinem E-Mail-Postfach eine Weiterleitung ein, die Treatwell-Buchungsmails automatisch an diese Adresse sendet. Jede weitergeleitete Mail wird ausgelesen und als Buchung übernommen.
  </Step>

  <Step title="Weitere Absender ergänzen (optional)">
    Mails von Treatwell werden immer angenommen. Kommen Buchungen unter einem anderen Namen an, etwa von einem Treatwell-Partner oder über deine eigene Weiterleitung, trage die Adresse oder Domain unter **Weitere Absender** als **Akzeptierte Absender** ein (z. B. `@partner.de`).
  </Step>

  <Step title="Abweichende Namen zuordnen (optional)">
    Heißt eine Ressource oder ein Service in Treatwell anders als in anny, lege unter **Abweichende Namen** über **Hinzufügen** eine Zuordnung an. Ohne Regel wählt anny den Eintrag, dessen Name zur Mail passt.
  </Step>

  <Step title="Kalenderlink in Treatwell importieren">
    Importiere den von anny bereitgestellten **ICS-Kalenderlink** in Treatwell, damit anny-Buchungen dort als belegte Zeiten erscheinen.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. Solange sie inaktiv ist, zeigt anny den Hinweis „Die Integration ist derzeit nicht aktiv". Löse anschließend eine Testbuchung in Treatwell aus und prüfe, ob sie nach kurzer Zeit in anny erscheint.
  </Step>
</Steps>

Sobald die Integration aktiv ist, werden weitergeleitete Treatwell-Buchungen automatisch in anny angelegt und anny-Buchungen in Treatwell sichtbar.

<Tip>
  Behandle die weitergeleitete E-Mail-Adresse wie ein Passwort: Wer sie kennt, kann Buchungen in deinen Kalender schreiben. Achte außerdem darauf, dass die Weiterleitungsregel dauerhaft aktiv bleibt und nicht durch Spam- oder Filterregeln blockiert wird.
</Tip>

### Einstellungen & Optionen

| Einstellung                                   | Beschreibung                                                                             |
| --------------------------------------------- | ---------------------------------------------------------------------------------------- |
| E-Mail-Adresse (Postfach für Treatwell-Mails) | Dedizierte anny Inbox, an die du Treatwell-Buchungsmails weiterleitest                   |
| Akzeptierte Absender (Weitere Absender)       | Zusätzliche Adressen oder Domains, deren weitergeleitete Mails anny ebenfalls akzeptiert |
| Abweichende Namen                             | Zuordnung, wenn eine Ressource oder ein Service in Treatwell anders heißt als in anny    |
| Aktivierungsverlauf                           | Verlauf der Aktivierungen und Deaktivierungen der Integration                            |

## Einschränkungen

Die Treatwell-Integration unterstützt nicht:

* Echtzeit-Synchronisation: Buchungen werden mit einer typischen Verzögerung von etwa 30 bis 60 Sekunden übertragen
* Eine direkte API-Verbindung: Treatwell-Buchungen kommen per E-Mail, anny-Buchungen gehen per Kalenderlink
* Import ohne aktive Weiterleitung: Ohne korrekt eingerichtete Weiterleitungsregel werden keine Treatwell-Buchungen importiert

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst oder löschst, werden keine Termine mehr synchronisiert. Weitergeleitete Treatwell-Mails werden dann nicht mehr als Buchungen übernommen und anny-Buchungen nicht mehr nach Treatwell übertragen. Bereits importierte Buchungen bleiben in anny erhalten.
</Warning>

Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

<AccordionGroup>
  <Accordion title="Wie schnell erscheinen Treatwell-Buchungen in anny?">
    In der Regel innerhalb von etwa 30 bis 60 Sekunden. Die Synchronisation ist nicht in Echtzeit, da Buchungen per E-Mail-Weiterleitung übertragen werden.
  </Accordion>

  <Accordion title="Werden Stornierungen aus Treatwell automatisch übernommen?">
    Ja. Wird eine Buchung in Treatwell storniert, aktualisiert anny die zugehörige Buchung entsprechend, sofern die Storno-E-Mail an die anny Inbox weitergeleitet wird.
  </Accordion>

  <Accordion title="Was passiert, wenn dieselbe E-Mail mehrfach ankommt?">
    anny erkennt Duplikate und verhindert, dass dieselbe Buchung mehrfach angelegt wird, auch bei erneut zugestellten oder weitergeleiteten E-Mails.
  </Accordion>

  <Accordion title="Werden Prepaid-Zahlungen aus Treatwell berücksichtigt?">
    Ja, sofern die Vorauszahlung in der Treatwell-E-Mail enthalten ist. anny übernimmt die Prepaid-Information für die Buchung.
  </Accordion>

  <Accordion title="Sehen Treatwell-Nutzer:innen meine anny-Buchungen?">
    Treatwell zeigt anny-Buchungen über den importierten Kalenderlink als belegte Zeiten an. So bleiben Verfügbarkeiten konsistent, ohne dass Buchungsdetails aus anny offengelegt werden.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Treatwell-Buchungen erscheinen nicht in anny">
    Meist ist die E-Mail-Weiterleitung nicht korrekt eingerichtet. Prüfe der Reihe nach: 1. Ist die Integration aktiv (Toggle oben rechts)? 2. Ist die Weiterleitungsregel aktiv? 3. Stimmt die Zieladresse mit der dedizierten anny Inbox überein? 4. Kommen die Mails unter einem anderen Absender an und müssen unter **Weitere Absender** ergänzt werden? 5. Landen die Treatwell-Mails eventuell im Spam oder in einem Filter?
  </Accordion>

  <Accordion title="anny-Buchungen erscheinen nicht in Treatwell">
    Prüfe, ob der ICS-Kalenderlink korrekt in Treatwell importiert wurde. Beachte außerdem die typische Verzögerung von etwa 30 bis 60 Sekunden, bevor neue anny-Buchungen sichtbar werden.
  </Accordion>

  <Accordion title="Die Buchung wird der falschen Ressource oder dem falschen Service zugeordnet">
    Ohne Zuordnungsregel wählt anny den Eintrag, dessen Name zur Mail passt. Heißt eine Ressource oder ein Service in Treatwell anders als in anny, lege unter **Abweichende Namen** eine passende Zuordnung an.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Treatwell ist ein Partner-/Buchungskanal, KEINE klassische Kalender-Integration (wie Google/Microsoft) und KEINE API-Integration. Zwei getrennte Transportwege: Treatwell → anny per E-Mail-Weiterleitung an eine dedizierte anny Inbox (`tw-…@calendar.anny.co`); anny → Treatwell per ICS-Kalenderfeed, den Treatwell importiert. Deshalb keine Echtzeit, typische Verzögerung ca. 30 bis 60 Sekunden.
>
> **UI-Pfad:** Adminbereich → **Integrationen** → **Treatwell**. Sektionen in dieser Reihenfolge: **Postfach für Treatwell-Mails** (dedizierte E-Mail-Adresse), **Weitere Absender** (Feld „Akzeptierte Absender", Adresse oder Domain), **Abweichende Namen** (Ressourcen-/Service-Zuordnung über „Hinzufügen"), **Aktivierungsverlauf**. Aktivierung/Deaktivierung über den **Toggle** oben rechts, Löschen über die **drei Punkte** oben rechts.
>
> **Kein Gating:** Kein Plan-Gating und keine gesonderte Feature-Aktivierung außer dem Aktivierungs-Toggle, daher kein Info-Plan-Hinweis.
>
> **Wenn-Dann:** Import funktioniert nur, wenn die Integration aktiv ist und die Weiterleitungsregel auf die korrekte anny Inbox zeigt. Kommt die Mail unter fremdem Absender an, muss dieser unter „Weitere Absender" hinterlegt sein. Prepaid wird nur übernommen, wenn die Info in der Treatwell-E-Mail enthalten ist. Stornierung wird nur übernommen, wenn die Storno-E-Mail weitergeleitet wird. Duplikatsschutz verhindert Mehrfachanlage bei erneut zugestellten/mehrfach weitergeleiteten E-Mails.
>
> **Verbindung trennen:** Deaktivieren oder Löschen stoppt jede Termin-Synchronisation (kein Import aus Treatwell, keine Übertragung nach Treatwell). Bereits importierte Buchungen bleiben in anny erhalten.
>
> **Robustheit:** anny AI parst die E-Mails auch bei geändertem Treatwell-E-Mail-Layout.
