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

# Zeitzone

> Jeder Assistent hat eine IANA-Zeitzone – sie verankert das Tool get_current_time, die Zeit-Variablen und die Geschäftszeiten-Prüfung; Kampagnen können sie pro Anruf überschreiben

Jeder Assistent hat eine **Zeitzone** – eine IANA-Kennung wie `Europe/Berlin` oder `America/New_York`, die du in den Assistenten-Einstellungen aus einem Dropdown auswählst. Sie legt fest, was „jetzt" für den Assistenten bedeutet: *„morgen um 15 Uhr"* bezieht sich dann auf den lokalen Tag von morgen bei der anrufenden Person – nicht auf UTC.

Der Standard ist `Europe/Berlin`.

## Was die Zeitzone beeinflusst

| Verbraucher                       | Wirkung                                                                                                                                                                                                                                                                    |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`get_current_time`-Systemtool** | Das immer aktive [Systemtool](/assistants/built-in-tools#system-tool-get_current_time) gibt Datum und Uhrzeit lokalisiert in dieser Zeitzone zurück – genutzt, sobald das Modell relative Zeitangaben auflöst („nächsten Dienstag", „in zwei Stunden") oder Termine bucht. |
| **Zeit-Variablen**                | `{{time}}`, `{{date}}`, `{{datetime}}` und `{{weekday}}` (siehe [Variablen](/assistants/variables)) werden zu Anrufbeginn in dieser Zeitzone gerendert.                                                                                                                    |
| **Geschäftszeiten-Tool**          | Das integrierte Tool [`check_business_hours`](/assistants/built-in-tools#business-hours) prüft seinen wöchentlichen Zeitplan in dieser Zeitzone – „geöffnet" heißt immer *lokal* geöffnet.                                                                                 |

## Override durch Kampagnen

Ausgehende [Kampagnen](/campaigns/overview) haben eine eigene Zeitzone (für die Anruffenster). Bei einem Kampagnenanruf hat sie für diesen Anruf **Vorrang vor der Zeitzone des Assistenten**:

```text theme={null}
effective timezone = campaign timezone (meta.timezone) ?? assistant timezone
```

So kann ein Assistent Kampagnen in verschiedenen Regionen bedienen und jedem Lead trotzdem die richtige Ortszeit nennen. Anrufe ohne Kampagne (eingehende Anrufe, einzelne ausgehende Anrufe, Web) nutzen immer die Zeitzone des Assistenten.

<Note>
  Die Zeitzone ändert, was der Assistent über die Zeit *sagt und prüft* – sie verschiebt nicht die Anrufplanung selbst. Die Anruffenster von Kampagnen richten sich so oder so nach der eigenen Zeitzone der Kampagne.
</Note>

## Einstellen über die API

`timezone` ist ein normales Assistenten-Feld – setze es im Editor, per `PATCH /api/v1/assistants/{id}` oder mit dem MCP-Tool `update_assistant`:

```bash theme={null}
curl -X PATCH https://app.famulor.de/api/v1/assistants/{id} \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "timezone": "Europe/Vienna" }'
```