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

# Zona horaria

> Cada asistente tiene una zona horaria IANA: es la base de la herramienta get_current_time, las variables de sistema de hora y la comprobación del horario comercial; las campañas pueden anularla en cada llamada

Cada asistente tiene una **zona horaria**: un identificador IANA como `Europe/Berlin` o `America/New_York`, que eliges desde un menú desplegable en la configuración del asistente. Define qué significa "ahora" para el asistente, así que *"mañana a las 3 p.m."* se resuelve como el mañana local de quien llama, no como UTC.

El valor predeterminado es `Europe/Berlin`.

## Qué afecta la zona horaria

| Elemento                                      | Efecto                                                                                                                                                                                                                                                                              |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Herramienta de sistema `get_current_time`** | Esta [herramienta de sistema](/assistants/built-in-tools#system-tool-get_current_time), siempre activa, devuelve la fecha y hora actuales en esta zona horaria; se usa cada vez que el modelo resuelve fechas relativas ("el próximo martes", "en dos horas") o agenda una reserva. |
| **Variables de sistema de hora**              | `{{time}}`, `{{date}}`, `{{datetime}}` y `{{weekday}}` (consulta [Variables](/assistants/variables)) se generan en esta zona horaria al iniciar la llamada.                                                                                                                         |
| **Herramienta de horario comercial**          | La herramienta integrada [`check_business_hours`](/assistants/built-in-tools#business-hours) evalúa su horario semanal en esta zona horaria: "abierto" siempre significa abierto *en horario local*.                                                                                |

## Anulación por campaña

Las [campañas](/campaigns/overview) salientes tienen su propia zona horaria (la que usan para definir sus franjas de llamada). En una llamada de campaña, esa zona horaria **prevalece sobre la del asistente**:

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

Así, un mismo asistente puede atender campañas de distintas regiones y aun así indicarle a cada lead la hora local correcta. Las llamadas sin campaña (entrantes, llamadas salientes individuales, web) siempre usan la zona horaria del asistente.

<Note>
  La zona horaria cambia lo que el asistente *dice y comprueba* sobre la hora; no modifica la programación de las llamadas en sí. Las franjas de llamada de una campaña siempre se rigen por la zona horaria propia de la campaña.
</Note>

## Configurarla mediante la API

`timezone` es un campo normal del asistente: configúralo desde el editor, con `PATCH /api/v1/assistants/{id}`, o con la herramienta MCP `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" }'
```