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

# Supabase

> Integra Supabase Auth con Notifuse para los correos de autenticación y la sincronización de usuarios.

![Integración con Supabase](https://www.notifuse.com/docs/assets/integrations/supabase.png)

La integración con Supabase envía los correos de Supabase Auth a través de Notifuse y sincroniza los usuarios nuevos con tus contactos.

## Descripción general

Tiene dos partes:

1. **Auth Email Hook**: envía los correos transaccionales de los eventos de autenticación (registro, enlace mágico, recuperación de contraseña, etc.)
2. **Before User Created Hook**: añade los usuarios nuevos de Supabase a tus contactos de Notifuse

## Configuración

Ve a **Configuración** → **Integraciones**, haz clic en **Añadir integración** y elige **Supabase** en **Aplicaciones conectadas**.

### Requisitos previos

Necesitas:

- Un espacio de trabajo de Notifuse con los permisos necesarios
- Un proyecto de Supabase
- Al menos una integración de correo configurada en Notifuse (para enviar los correos transaccionales)

## Auth Email Hook

El Auth Email Hook envía tus propios correos de autenticación a través de Notifuse en lugar de los correos predeterminados de Supabase.

### Puesta en marcha

1. Ve a [Supabase Auth Hooks](https://supabase.com/dashboard/project/_/auth/hooks) en tu Supabase Dashboard y abre los ajustes de **Auth Email Hook**
2. Añade un hook nuevo
3. Selecciona el tipo "HTTPS"
4. Haz clic en "Generate a secret" y copia su valor en la integración de Notifuse
5. Guarda la integración para ver el endpoint del webhook que genera Notifuse
6. Pega el endpoint del webhook en tu hook de Supabase y guarda

![Auth Hooks de Supabase](https://www.notifuse.com/docs/assets/screenshots/supabase/supabase_settings.png)

![Configuración del Auth Hook de Supabase](https://www.notifuse.com/docs/assets/screenshots/supabase/supabase_hook.png)

![Integración en Notifuse](https://www.notifuse.com/docs/assets/screenshots/supabase/supabase_notifuse.png)

![Endpoints de Notifuse](https://www.notifuse.com/docs/assets/screenshots/supabase/supabase_endpoints.png)

### Plantillas predeterminadas

La primera vez que guardas la integración con Supabase, Notifuse crea una plantilla predeterminada para cada tipo de correo. Estas plantillas:

- Están marcadas como gestionadas por la integración (no se pueden eliminar)
- Incluyen todas las variables de plantilla Liquid necesarias de Supabase
- Se pueden editar para adaptarlas a tu marca

![Plantillas de Notifuse para Supabase](https://www.notifuse.com/docs/assets/screenshots/supabase/supabase_templates.png)

### Variables de plantilla

Todas las plantillas de correo de autenticación de Supabase tienen acceso a estas variables:

```liquid
{# User information #}
{{ user.id }}
{{ user.email }}
{{ user.phone }}
{{ user.email_new }}  {# Only for email change #}

{# Email data #}
{{ email_data.token }}          {# OTP code (for display, not URLs) #}
{{ email_data.token_hash }}     {# Hashed token for verification URLs #}
{{ email_data.token_new }}      {# For secure email changes #}
{{ email_data.token_hash_new }} {# For secure email changes #}
{{ email_data.redirect_to }}    {# Where to redirect after verification #}
{{ email_data.site_url }}       {# Your Supabase auth URL #}
{{ email_data.email_action_type }} {# Type: signup, recovery, magiclink, etc. #}
```

### Formato de la URL de confirmación

Los enlaces de confirmación tienen que usar exactamente este formato para funcionar con el sistema de autenticación GoTrue de Supabase:

```liquid
{{ email_data.site_url }}/verify?token={{ email_data.token_hash }}&type={{ email_data.email_action_type }}&redirect_to={{ email_data.redirect_to }}
```

Esto da una URL como:

```
https://yourproject.supabase.co/auth/v1/verify?token=abc123...&type=signup&redirect_to=https://yourapp.com
```

Usa `token_hash` en la URL, no `token`. La variable `token` sirve para mostrar códigos OTP en los correos de reautenticación.

### Plantilla de ejemplo

Una plantilla de confirmación de registro con el formato de URL correcto:

```mjml
<mjml>
  <mj-body>
    <mj-section>
      <mj-column>
        <mj-text font-size="20px" color="#F45E43" font-family="Helvetica"> Welcome! </mj-text>
        <mj-text font-size="16px" color="#555" font-family="Helvetica">
          Please confirm your email address by clicking the link below:
        </mj-text>
        <mj-button
          href="{{ email_data.site_url }}/verify?token={{ email_data.token_hash }}&type={{ email_data.email_action_type }}&redirect_to={{ email_data.redirect_to }}"
          background-color="#F45E43"
          color="white"
        >
          Confirm Email
        </mj-button>
        <mj-text font-size="14px" color="#555" font-family="Helvetica">
          If you did not sign up for this account, you can ignore this email.
        </mj-text>
      </mj-column>
    </mj-section>
  </mj-body>
</mjml>
```

## Before User Created Hook

El Before User Created Hook añade los usuarios nuevos de Supabase a tus contactos de Notifuse.

### Puesta en marcha

1. Abre el panel **Hook antes de crear usuario** en el formulario de la integración con Supabase
2. Genera una clave secreta de webhook en Supabase (distinta de la del Auth Email Hook)
3. Pega la clave secreta en el formulario de la integración con Supabase en Notifuse
4. (Opcional) Selecciona una lista de contactos a la que añadir los usuarios nuevos
5. (Opcional) Rechaza las direcciones de correo desechables (por ejemplo: @yopmail.com)

### Correspondencia de campos

Los campos de usuario de Supabase se corresponden con estos campos de contacto de Notifuse:

| Campo de Supabase | Campo de Notifuse                         |
| ----------------- | ----------------------------------------- |
| `email`           | `email`                                   |
| `id`              | `external_id`                             |
| `phone`           | `phone`                                   |
| `user_metadata`   | Campo Custom JSON configurable (opcional) |

En los ajustes de la integración puedes elegir qué campo Custom JSON (1-5) recibe el `user_metadata` de Supabase. Si no seleccionas ninguno, `user_metadata` no se sincroniza.

### Gestión de errores

El Before User Created Hook nunca bloquea un registro en tu aplicación. El error queda en los registros y el usuario se registra igualmente cuando:

- Falla la creación o actualización del contacto
- La lista de contactos configurada se ha eliminado

## Seguridad

### Verificación de la firma del webhook

Notifuse verifica cada webhook de Supabase con su firma HMAC-SHA256 y rechaza los que tienen una firma no válida, así que solo procesa peticiones de tu proyecto de Supabase.

### Cifrado

Las claves de firma de los webhooks se guardan cifradas con AES-256 en la base de datos de Notifuse.

## Pruebas

### Probar los correos de autenticación

1. En tu aplicación, lanza un flujo de autenticación (por ejemplo, un registro)
2. Revisa los registros de Notifuse para confirmar que se recibió el webhook
3. Revisa la bandeja de entrada del destinatario para ver el correo

### Probar la sincronización de usuarios

1. Crea un usuario nuevo en tu proyecto de Supabase
2. En Notifuse, ve a **Contactos**
3. Busca el correo del usuario para confirmar que se añadió
4. Si configuraste una lista de destino, comprueba que el usuario está en ella

## Solución de problemas

### No se envían los correos

**Revisa estos puntos:**

- ¿Hay un **Secreto del hook** guardado en el panel **Hook de envío de correo** en Notifuse?
- ¿Es correcta la clave de firma del webhook tanto en Supabase como en Notifuse?
- ¿Tienes un proveedor de correo transaccional configurado en tu espacio de trabajo?
- Revisa los registros de Notifuse en busca de mensajes de error

### No se sincronizan los usuarios

**Revisa estos puntos:**

- ¿Hay un **Secreto del hook** guardado en el panel **Hook antes de crear usuario** en Notifuse?
- ¿Es correcta la clave de firma del webhook tanto en Supabase como en Notifuse?
- Revisa los registros de Notifuse en busca de mensajes de error
- Recuerda: los errores del Before User Created Hook quedan en los registros pero no impiden que el usuario se registre

### Errores de firma no válida

**Suele significar que:**

- La clave de firma de Notifuse no coincide con la de Supabase
- La URL del webhook incluye parámetros `workspace_id` o `integration_id` incorrectos
- Estás probando con una herramienta como Postman sin la cabecera de firma correcta

**Para solucionarlo:**

- Vuelve a generar la clave de firma en Supabase
- Copia la clave nueva en Notifuse
- Asegúrate de usar exactamente la URL de webhook que proporciona Notifuse

## Comportamiento del cambio de correo

El flujo de "secure email change" de Supabase envía dos correos:

1. **A la dirección de correo actual**: usa `template_mappings.email_change_current`
   - Variables disponibles: `user.email`, `user.email_new`, `email_data.token_hash_new`
   - URL de confirmación: `{{ email_data.site_url }}/verify?token={{ email_data.token_hash_new }}&type=email_change&redirect_to={{ email_data.redirect_to }}`
2. **A la dirección de correo nueva**: usa `template_mappings.email_change_new`
   - Variables disponibles: `user.email`, `user.email_new`, `email_data.token_hash`
   - URL de confirmación: `{{ email_data.site_url }}/verify?token={{ email_data.token_hash }}&type=email_change&redirect_to={{ email_data.redirect_to }}`

Por compatibilidad con versiones anteriores, los nombres de los tokens de Supabase son poco intuitivos:

- `token_hash_new` se usa para la dirección de correo actual
- `token_hash` se usa para la dirección de correo nueva

El cambio solo se completa cuando se confirman los dos correos. Notifuse detecta los cambios de correo seguros y envía a cada dirección el token que le corresponde.

## Configuración avanzada

### Lógica personalizada de listas de contactos

Para elegir la lista según otras reglas (los metadatos del usuario, por ejemplo):

1. Deja vacía la lista de destino en los ajustes de la integración
2. Usa segmentos de Notifuse para agrupar a los usuarios
3. Crea una automatización que se dispare cuando se añadan contactos nuevos

### Personalización de los correos

Puedes editar cualquier plantilla gestionada por la integración:

- Personaliza colores, fuentes y diseño
- Añade tu logo y los recursos de tu marca
- Cambia el texto, conservando las variables de plantilla
- Añade parámetros UTM para el seguimiento

Las plantillas gestionadas por la integración no se pueden eliminar, pero todo lo que contienen se puede cambiar.

## Limitaciones

- Las plantillas gestionadas por la integración no se pueden eliminar (sí se pueden editar)
- Cada proyecto de Supabase necesita su propia integración en Notifuse
- El Before User Created Hook solo se activa con los registros de usuarios nuevos (no con los usuarios existentes)
- Supabase determina las variables de plantilla y no se pueden modificar

## Buenas prácticas

1. Configura la integración en un espacio de trabajo de desarrollo antes de pasar a producción.
2. Toma las plantillas predeterminadas como punto de partida y adáptalas a tu marca.
3. Revisa los registros de Notifuse con regularidad para confirmar que los webhooks se procesan.
4. Agrupa a los usuarios con segmentos en lugar de listas estáticas.
5. Trata las claves de firma de los webhooks como contraseñas y no las incluyas nunca en el control de versiones.

## Documentación relacionada

- [Supabase Auth Hooks: Send Email Hook](https://supabase.com/docs/guides/auth/auth-hooks/send-email-hook)
- [Supabase Auth Hooks: Before User Created Hook](https://supabase.com/docs/guides/auth/auth-hooks/before-user-created-hook)
- [Plantillas de correo de Notifuse](https://www.notifuse.com/es/docs/features/templates.md)
- [Contactos de Notifuse](https://www.notifuse.com/es/docs/features/contacts.md)
- [Listas de Notifuse](https://www.notifuse.com/es/docs/features/lists.md)
