Comenzando con Mailoo
Esta guía recorre lo que Mailoo ofrece hoy: proyectos, integraciones FORM / CONTACT_FORM / JSBOX / BLOG, acceso por webhooks y claves API, y las vistas del panel para mensajes y suscriptores.
Prerrequisitos
Antes de comenzar, asegúrate de tener:
- Cuenta Mailoo (a través de tu proveedor de identidad)
- Un proyecto en el panel donde vivan integraciones y claves API
- Un lugar seguro para las claves API (servidor, BFF o automatización—no el bundle del navegador)
Consejo
Crea claves distintas por entorno (staging vs producción) y usa ámbitos RESTRICTED hasta saber qué webhook necesita cada integración.
Crear tu cuenta
Empieza en la página de inicio de sesión y sigue estos pasos:
- Abre la web de Mailoo y elige Empezar gratis o Iniciar sesión.
- Completa la autenticación con tu IdP (p. ej. Keycloak).
- Al entrar al panel, crea o selecciona un proyecto.
- Anota el UID del proyecto: lo usarás en webhooks y URLs públicas del blog.
Puedes volver al panel cuando quieras; la sesión sigue la configuración de Auth.js y tu IdP.
Configurar tu primera integración
Mailoo no conecta buzones de terceros. Añades una integración según cómo los visitantes interactúan con tu sitio:
Paso 1: Abre el espacio de integraciones
- Dentro del proyecto, abre Integraciones (o Añadir integración).
- Revisa los tipos disponibles según tu plan.
- Elige FORM, CONTACT_FORM, JSBOX o BLOG según lo que construyas.
Paso 2: Ajustes específicos del tipo
- Pon un nombre claro para que el equipo sepa qué sitio o formulario es.
- Configura orígenes permitidos, URLs de webhook u opciones del widget.
- Genera una clave API con los ámbitos adecuados (formularios vs chat, etc.).
- Guarda la clave en el entorno del servidor—nunca incrustes claves FULL en el cliente.
- Guarda la integración y comprueba que aparece como Activa.
Paso 3: Conecta tu aplicación
- Apunta tu backend o BFF al webhook documentado usando HTTPS.
- Reenvía cargas con la forma descrita en la guía de la integración.
- Para JSBOX, añade el loader y los identificadores que da Mailoo.
- Opcional: configura SMTP saliente en la integración antes de enviar correo a suscriptores.
Probar la integración
Valida el flujo antes de producción:
- Dispara una prueba desde staging (formulario, chat o publicación de blog).
- Espera la respuesta del webhook o la actualización del panel.
- Abre Mensajes y confirma metadatos, estado y vínculo a la integración.
- Para FORM, verifica Suscriptores con el email de prueba.
Solución de problemas
Si no aparece nada tras unos minutos:
- • Comprueba que el ámbito de la clave coincide con el webhook llamado.
- • Verifica el UID del proyecto y el ID de integración en URL o cuerpo.
- • Busca 4xx en los logs del servidor (CORS, firma o validación).
- • Contacta a soporte con el ID de integración y la hora aproximada.
Próximos pasos
Cuando la primera integración funcione, amplía:
- Añade otro tipo (por ejemplo JSBOX junto a un FORM).
- Configura plantillas y campañas para mensajes a suscriptores.
- Lee la guía de formularios web para patrones BFF en Next.js.
- Abre la OpenAPI alojada en /docs/v1 de tu despliegue de API.