Aprobaciones, Registros y envíos
Envía correo por SMTP
Conecta Supabase Auth, WordPress o cualquier app compatible con SMTP a Banger para que su correo salga desde tu dominio y aparezca en Registros.
En esta guía 8 secciones
El relay SMTP de Banger permite que cualquier app que solo envíe por SMTP, como Supabase Auth, Auth0, WordPress o el módulo de correo de tu framework, envíe mediante Banger. Tu app inicia sesión con una clave de API de Banger, y cada mensaje sale desde tu dominio y aparece en Registros.
Antes de empezar
Necesitas dos cosas:
- Una vía de Producto. La dirección From debe estar en un dominio o subdominio con una vía de Producto lista. Abre Dominios › Añadir canal, elige Producto y añade los registros DNS que enumera. Consulta Añade tu dominio. Una vía de Correo (buzones del equipo) o Campaña no puede enviar correo de la app, para que ese correo nunca afecte a la reputación de las bandejas del equipo.
- Una clave de API que pueda enviar. Abre Claves de API › Crear clave de API, pon el nombre de la app (por ejemplo, “Supabase Auth”), selecciona solo
mail:sendy elige Crear clave. Cópiala enseguida: se muestra una sola vez.
También puedes acceder a Claves de API desde Configuración › Desarrolladores › Gestionar claves de API.
Ajustes SMTP
El cuadro SMTP de la página Claves de API muestra estos ajustes, con un botón para copiar el host.
| Ajuste | Valor |
|---|---|
| Host | submit.bangermail.com |
| Puerto | 465 (TLS) o 587 (STARTTLS) |
| Puerto, si están bloqueados | 2465 (TLS) o 2587 (STARTTLS) |
| Usuario | banger (cualquier valor funciona; la clave identifica el espacio de trabajo) |
| Contraseña | Tu clave de API |
| Cifrado | TLS 1.2 o posterior. El inicio de sesión solo se ofrece tras iniciar TLS. |
| Autenticación | PLAIN o LOGIN |
Si tu app pide “SSL” o “TLS”, usa el puerto 465. Si pide “STARTTLS”, usa 587.
Conecta Supabase Auth
- En Supabase, abre Authentication › Correos › Ajustes SMTP y activa SMTP personalizado.
- Correo del remitente: una dirección de tu vía de Producto, como
noreply@app.example.com. - Nombre del remitente: el nombre de tu producto. Banger lo conserva tal como está escrito.
- Host
submit.bangermail.com, Puerto465, Nombre de usuariobanger, Contraseña tu clave de API. - Guarda y envíate un enlace de acceso desde Authentication › Usuarios.
Las demás apps funcionan igual: pega los ajustes anteriores en sus ajustes SMTP o de correo. Hay ejemplos de código en la documentación SMTP para desarrolladores.
Comprueba que funcionó
Abre Registros. Cada mensaje de tu app aparece con SMTP como origen y su estado de entrega. Banger también registra cada intento rechazado y lo que hay que corregir.
Tu app recibe 250 2.0.0 Queued as … cuando Banger acepta un mensaje.
Qué hace Banger con cada mensaje
- Lo envía como lo escribió tu app, con tu nombre From, firmado con la clave DKIM de tu dominio.
- Quita
BccyReturn-Pathy añadeReply-Tocon la dirección From si no había uno. - Omite destinatarios suprimidos y envía al resto.
- Trata un reintento del mismo mensaje como el mismo envío, para que un tiempo de espera agotado nunca lo envíe dos veces.
- Cuenta cada mensaje para tu plan, como cualquier otro envío.
Cada mensaje puede tener hasta 10 MiB y hasta 50 destinatarios.
Cuando se rechaza un mensaje
Cada rechazo explica por qué e incluye una referencia, (ref …), que coincide con la entrada en Registros. Los códigos que empiezan por 4 son temporales; tu app puede reintentar después.
| Respuesta | Qué hacer |
|---|---|
535 5.7.8 | La contraseña no es una clave de API válida. Comprueba que no esté revocada y tenga mail:send. |
421 4.7.0 | Tres inicios de sesión fallidos en una conexión, por lo que se cerró. Corrige la clave antes de reintentar. |
454 4.7.0 | Demasiados inicios de sesión fallidos desde tu red. Corrige la clave y espera hasta una hora. |
550 5.7.1 | El dominio From no tiene vía de Producto lista (la respuesta indica qué falta), el destinatario está suprimido o el envío está pausado. Consulta Entregabilidad y pausas de envío. |
553 5.1.3 | Una dirección de destinatario no es válida. |
552 5.3.4 | El mensaje supera 10 MiB. |
554 5.6.0 | El mensaje está mal formado, como dos cabeceras From o un From con varias direcciones. |
451 4.7.0 | Tu cuota de envío o límite diario se agotó. Se renueva el próximo periodo o día, o ahora si mejoras el plan. |
451 4.3.0 | Banger no pudo aceptar el mensaje ahora. Tu app debe reintentar. |
Protege la clave
- Da a cada app su propia clave con solo
mail:send. Así, una contraseña SMTP filtrada no puede leer tu espacio de trabajo. - Para rotarla, crea otra, actualiza la app y usa Revocar en la antigua. Las apps que sigan usándola se rechazan en su próximo inicio de sesión.
- Banger solo guarda un hash de cada clave y registra los inicios de sesión rechazados en Registros.
Pruébalo con tu IA
Crea una clave de API que solo pueda enviar correo, comprueba que mi vía de Producto esté lista y dame los ajustes SMTP para pegarlos en Supabase.