Primeros pasos con Mailoo

Última actualización: Sep 21, 2026Sección: Primeros pasos

Mailoo te ayuda a gestionar formularios web, listas de suscriptores, un blog headless, un catálogo de mercado, publicación social y un widget de chat JSBOX desde un único panel de control. Conectas tu producto mediante webhooks del lado del servidor y claves API---Mailoo no es un conector de buzón de correo.

Lo que necesitarás

  • Una cuenta de Mailoo a través de tu proveedor de identidad configurado
  • Un proyecto en el panel de control que será propietario de las integraciones y claves API
  • Capacidad del lado del servidor o BFF para almacenar los secretos X-API-Key de forma segura

Paso 1: Crea tu cuenta y proyecto

  1. Visita https://mailoo.app y selecciona Comenzar (o Iniciar sesión).

  2. Completa la autenticación con tu proveedor de identidad (IdP). No hay un formulario de registro separado dentro del panel de control de Mailoo: Iniciar sesión / Comenzar abre el IdP. El inicio de sesión, registro, restablecimiento de contraseña y verificación de correo se realizan en páginas del IdP con marca Mailoo. Los idiomas coinciden con el sitio (inglés, alemán, español, ruso). La apariencia clara y oscura sigue el tema que uses en mailoo.app.

  3. Crea un proyecto desde el panel de control y anota su projectUid.

    Los propietarios del proyecto pueden invitar colaboradores como OWNER o EDITOR (alcance opcional por integración para editores). Los miembros invitados inician sesión y aceptan el enlace de invitación.

Paso 2: Añade tu primera integración

  1. Abre Integraciones dentro del proyecto (o selecciona Añadir integración).
  2. Elige el tipo que corresponda a tu necesidad:
  • FORM --- boletín informativo o captura de leads
  • CONTACT_FORM --- mensajes de soporte o comentarios
  • JSBOX --- chat embebible en tiempo real
  • BLOG --- contenido editorial a través de la API pública de blog
  • MARKET --- catálogo de productos, pedidos y generadores de ofertas
  • SOCIAL --- publicaciones en X y Facebook
  1. Completa el asistente de configuración (orígenes permitidos opcionales, nombres para mostrar y ajustes de conexión específicos del tipo).

Paso 3: Conecta tu aplicación

  • Formularios: llama a Mailoo desde tu servidor o BFF con una clave API con alcance limitado almacenada en variables de entorno. Prefiere los helpers BFF de @mailoo/forms para Next.js.
  • Chat: integra el widget JSBOX (o @mailoo/chat), pasa los identificadores del proyecto e integración, y usa la consola de chat del panel de control para los operadores.
  • Blog / Mercado: publica en el panel de control y luego lee desde tu sitio a través de las APIs externas con X-API-Key.
  • Redes sociales: añade las credenciales del canal en Conexión y ajustes, luego redacta y publica publicaciones en el panel de control.
  • Agentes (opcional): crea un token de agente MCP en Perfil → Seguridad → Tokens MCP y apunta tu host MCP a https://mcp.mailoo.app/mcp. Consulta integrations/mailoo-mcp{.interpreted-text role="doc"}.

Paso 4: Verifica mensajes y suscriptores

  1. Envía una prueba de envío desde un entorno seguro.
  2. Confirma que la fila aparece en Mensajes con los metadatos esperados.
  3. Para integraciones FORM, verifica que Suscriptores capturó el correo de prueba.

Opcional: SMTP saliente

El correo dirigido a suscriptores (respuestas, secuencias de bienvenida, envío transaccional, confirmaciones de pedido de mercado) usa credenciales SMTP almacenadas en la integración. No existe un respaldo silencioso a un servicio de correo compartido de la plataforma---configura SMTP antes de depender de esas funcionalidades. Consulta integrations/outbound-smtp{.interpreted-text role="doc"}.

Siguientes pasos

  • quick-setup{.interpreted-text role="doc"} --- lista de verificación para un pase rápido a producción
  • Guías de integración en Integraciones
  • Esquemas OpenAPI en https://api.mailoo.app/docs/v1
📚