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:
- Auth Email Hook: envía los correos transaccionales de los eventos de autenticación (registro, enlace mágico, recuperación de contraseña, etc.)
- 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
- Ve a Supabase Auth Hooks en tu Supabase Dashboard y abre los ajustes de Auth Email Hook
- Añade un hook nuevo
- Selecciona el tipo “HTTPS”
- Haz clic en “Generate a secret” y copia su valor en la integración de Notifuse
- Guarda la integración para ver el endpoint del webhook que genera Notifuse
- Pega el endpoint del webhook en tu hook de Supabase y guarda
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
Variables de plantilla
Todas las plantillas de correo de autenticación de Supabase tienen acceso a estas variables:
{# 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:
{{ 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>
<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
- Abre el panel Hook antes de crear usuario en el formulario de la integración con Supabase
- Genera una clave secreta de webhook en Supabase (distinta de la del Auth Email Hook)
- Pega la clave secreta en el formulario de la integración con Supabase en Notifuse
- (Opcional) Selecciona una lista de contactos a la que añadir los usuarios nuevos
- (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
- En tu aplicación, lanza un flujo de autenticación (por ejemplo, un registro)
- Revisa los registros de Notifuse para confirmar que se recibió el webhook
- Revisa la bandeja de entrada del destinatario para ver el correo
Probar la sincronización de usuarios
- Crea un usuario nuevo en tu proyecto de Supabase
- En Notifuse, ve a Contactos
- Busca el correo del usuario para confirmar que se añadió
- 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_idointegration_idincorrectos - 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:
- 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 }}
- Variables disponibles:
- 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 }}
- Variables disponibles:
Por compatibilidad con versiones anteriores, los nombres de los tokens de Supabase son poco intuitivos:
token_hash_newse usa para la dirección de correo actualtoken_hashse 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):
- Deja vacía la lista de destino en los ajustes de la integración
- Usa segmentos de Notifuse para agrupar a los usuarios
- 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
- Configura la integración en un espacio de trabajo de desarrollo antes de pasar a producción.
- Toma las plantillas predeterminadas como punto de partida y adáptalas a tu marca.
- Revisa los registros de Notifuse con regularidad para confirmar que los webhooks se procesan.
- Agrupa a los usuarios con segmentos en lugar de listas estáticas.
- Trata las claves de firma de los webhooks como contraseñas y no las incluyas nunca en el control de versiones.
