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

# Cambiar tu dominio

> Traslada una instancia de Notifuse a una nueva dirección y abre la consola en los dominios personalizados de los espacios de trabajo.

Notifuse toma su dirección pública de `API_ENDPOINT`, definida como variable de entorno o guardada por el asistente de configuración; si existen las dos, gana la variable de entorno. La consola envía ahí todas sus solicitudes, y la dirección se escribe en los correos, las invitaciones, los webhooks registrados en tus proveedores de correo y la URI de redirección del SSO. Para trasladar una instancia, cambia `API_ENDPOINT` y luego actualiza los lugares que copiaron la dirección.

> [!WARNING]
>
> Mantén el dominio antiguo apuntando a Notifuse, o redirigiendo al nuevo con la ruta y la query string intactas, mientras alguien pueda abrir correos que ya enviaste. Sus enlaces de seguimiento, baja, centro de notificaciones y versión web llevan la dirección antigua, y un correo entregado no se puede actualizar.

## Pasar al nuevo dominio

1. Enruta el nuevo dominio a Notifuse en tu proxy inverso, con un certificado TLS, y mantén también enrutado el dominio antiguo.
2. Cambia `API_ENDPOINT`:
   - **Si es una variable de entorno**: cámbiala y reinicia Notifuse.
   - **Si la guardó el asistente de configuración**: inicia sesión como root en el dominio antiguo, abre **Configuración del sistema** (el botón encima de la lista de espacios de trabajo), cambia **Punto final API** y guarda. Al guardar, Notifuse se reinicia: el proceso termina y tu contenedor o gestor de servicios lo vuelve a arrancar (el archivo Docker Compose proporcionado lo hace con `restart: unless-stopped`). El campo está desactivado cuando la variable de entorno está definida, porque esa variable lo anularía.
3. Vuelve a iniciar sesión en el nuevo dominio. Las sesiones se guardan por dirección, así que una sesión abierta en el dominio antiguo no se conserva.
4. Revisa la lista de abajo.

> [!NOTE]
>
> **¿Sin acceso después del traslado?** Si el dominio antiguo ya no llega a Notifuse, la consola en el nuevo dominio tampoco llega a su API; la página de inicio de sesión muestra la dirección que intentó. Define `API_ENDPOINT` con la nueva dirección como variable de entorno y reinicia: anula el valor guardado por el asistente de configuración.

## Qué más usa la dirección

| Usa la dirección                                                                                                                                    | Después del cambio                                                                                                                           | Qué hacer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enlaces de los correos ya enviados: seguimiento de clics, seguimiento de aperturas, baja, `List-Unsubscribe`, centro de notificaciones, versión web | Siguen apuntando al dominio antiguo                                                                                                          | Mantén el dominio antiguo enrutado a Notifuse. Los espacios de trabajo con una [URL de punto final personalizado](https://www.notifuse.com/es/docs/features/workspaces.md#custom-endpoint-url) usan ese dominio y no se ven afectados. Si rediriges el dominio antiguo al nuevo, los enlaces de baja y de centro de notificaciones envueltos por el seguimiento de clics en correos enviados antes de 42.2 muestran primero una [página de confirmación](https://www.notifuse.com/es/docs/features/workspaces.md#tracked-links), lo que cuesta un clic más. Cuando un espacio de trabajo cambia su propio dominio personalizado, redirige el antiguo a `API_ENDPOINT`, no al nuevo dominio personalizado: una versión web solo se abre en el dominio con el que se envió y en `API_ENDPOINT`. |
| Invitaciones pendientes a espacios de trabajo                                                                                                       | Enlazan al dominio antiguo                                                                                                                   | Mantén el dominio antiguo enrutado o reenvía las invitaciones: una invitación reenviada usa la nueva dirección.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Webhooks de los proveedores de correo                                                                                                               | Se registraron una sola vez, con la dirección de ese momento                                                                                 | Para cada integración, abre **Configuración → Integraciones** y elige **Volver a registrar webhooks** en su menú **⋯**. Consulta [Webhooks de los proveedores de correo](#email-provider-webhooks).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `WEBHOOK_ENDPOINT`                                                                                                                                  | Si está definida, sustituye a `API_ENDPOINT` para los webhooks                                                                               | Cámbiala también y vuelve a registrar.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Inicio de sesión único                                                                                                                              | La URI de redirección se deriva de `API_ENDPOINT`, salvo que `OIDC_REDIRECT_URI` esté definida                                               | Añade `https://<new-domain>/api/user.oidc.callback` en tu proveedor de identidad y actualiza `OIDC_REDIRECT_URI` si la definiste. Consulta [Inicio de sesión único](https://www.notifuse.com/es/docs/self-hosting/sso.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| URL copiadas en otras herramientas: hooks de autenticación de Supabase, la conexión de Zapier, aplicaciones que llaman a la API                     | Siguen llamando al dominio antiguo                                                                                                           | Actualízalas con la nueva dirección.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| El fragmento de analítica web instalado en tus sitios                                                                                               | Su `endpoint` y la URL de su script nombran el dominio antiguo, salvo que el espacio de trabajo tenga una URL de punto final personalizado   | Instala el fragmento actualizado o mantén el dominio antiguo enrutado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| URL de punto final personalizado de los espacios de trabajo                                                                                         | Su comprobación DNS espera un CNAME hacia el host de `API_ENDPOINT`, y solo se ejecuta cuando se define o se cambia un dominio personalizado | Los dominios personalizados existentes siguen funcionando mientras el destino de su CNAME siga llegando a Notifuse. Apúntalos al nuevo host cuando te venga bien.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `CORS_ALLOW_ORIGIN`                                                                                                                                 | Si está definida, lista los orígenes autorizados a llamar a la API                                                                           | Añade el nuevo origen. Consulta [Dominios personalizados de los espacios de trabajo](#opening-the-console-on-a-workspace-custom-domain).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

### Webhooks de los proveedores de correo

Notifuse registra su webhook en tu proveedor de correo al crear la integración, con la dirección de ese momento, y nunca lo actualiza por su cuenta. **Volver a registrar webhooks** envía la nueva dirección:

- **Mailgun** y **SendGrid** sustituyen la dirección antigua.
- **Postmark**, **SparkPost**, **Mailjet** y **Amazon SES** añaden la nueva dirección junto a la antigua. Elimina el webhook antiguo en el panel del proveedor, o en Amazon SES la suscripción SNS antigua, para que los eventos no lleguen dos veces.

Una integración puede aparecer como registrada aunque su webhook siga apuntando al dominio antiguo. Pasa el cursor sobre el estado de los webhooks de una integración en **Configuración → Integraciones** para ver la dirección que usa cada endpoint.

Amazon SES confirma automáticamente la nueva suscripción SNS en cuanto AWS puede llegar a Notifuse en el nuevo dominio.

## Abrir la consola en el dominio personalizado de un espacio de trabajo

La URL de punto final personalizado de un espacio de trabajo también sirve la consola: si un espacio de trabajo usa `https://news.example.com`, sus miembros pueden iniciar sesión en `https://news.example.com/console`. La consola y el centro de notificaciones abiertos ahí envían sus solicitudes a `API_ENDPOINT`, desde el origen del dominio personalizado.

- Con el valor por defecto de `CORS_ALLOW_ORIGIN` (`*`) no hay nada que configurar.
- Si restringes `CORS_ALLOW_ORIGIN`, incluye todos los dominios personalizados de los espacios de trabajo, separados por comas: `CORS_ALLOW_ORIGIN=https://news.example.com,https://mail.other-brand.com`. Desde un dominio que no esté en la lista no se puede iniciar sesión en la consola, y su centro de notificaciones no puede cargar las preferencias.
- Las sesiones se guardan por dirección: iniciar sesión en un dominio personalizado no te conecta en el dominio principal, ni a la inversa.
- El inicio de sesión único y los enlaces de invitación terminan en la dirección de `API_ENDPOINT`, no en el dominio personalizado.
