Usa esta lista de verificación cuando quieras tener una instalación funcional de Mailoo en una sola sesión.
Requisitos previos
- Cuenta de Mailoo con acceso al panel de control
- Un proyecto creado para tu espacio de trabajo
- Claves API generadas con los alcances que requiere cada webhook
Flujo en cinco minutos
1. Organización del proyecto (1 minuto)
: Confirma la nomenclatura, copia el projectUid y decide quién rota las claves.
2. Crea la integración (2 minutos)
: Añade FORM, CONTACT_FORM, JSBOX, BLOG, MARKET o SOCIAL; opcionalmente establece orígenes permitidos; copia el UID del proyecto, el ID de integración y las notas de integración desde Conexión y ajustes.
3. Conecta tu backend (2 minutos)
: Almacena X-API-Key en variables de entorno, reenvía los envíos de formulario desde un BFF, o integra el cargador de chat en tu sitio de marketing. Nunca pongas claves API en JavaScript del lado del cliente.
4. Envía un evento de prueba
: Envía una entrada de formulario sintética o abre el widget de chat y confirma que el panel de control muestra un nuevo mensaje.
Sugerencias por escenario
Boletín de marketing
: Usa una integración FORM y envía desde una ruta del servidor. Configura SMTP saliente si envías correo de bienvenida o confirmación desde Mailoo.
Contacto de soporte
: Usa CONTACT_FORM con una clave restringida y el patrón de reenvío de comentarios de Next.js (integrations/feedback-form-nextjs-example{.interpreted-text role="doc"}).
Sitio editorial
: Crea una integración BLOG, publica un artículo y recupéralo desde la API externa de blog (integrations/blog-headless-cms{.interpreted-text role="doc"}).
Chat en tiempo real
: Configura JSBOX (opcionalmente restringe orígenes a tu host HTTPS) y dirige a los operadores a través de la experiencia de chat del panel de control.
Catálogo de tienda
: Crea una integración MARKET, añade productos y llama a la API externa de catálogo con market.external-read (integrations/market-catalog-external-api{.interpreted-text role="doc"}).
Publicación social
: Crea una integración SOCIAL, guarda las credenciales de X y/o Facebook, y luego redacta y publica una publicación (integrations/social-networks{.interpreted-text role="doc"}).
Automatización con agentes
: Crea un token MCP en Perfil → Seguridad y conecta tu host MCP (integrations/mailoo-mcp{.interpreted-text role="doc"}).
Lista de verificación de validación
- El estado de la integración es Activo
- El mensaje o contenido de prueba aparece con los metadatos esperados
- Los alcances de la clave API coinciden con cada webhook expuesto
- SMTP saliente configurado antes de habilitar respuestas a suscriptores o correo de pedidos
Solución de problemas
Webhook rechazado
: Vuelve a verificar los alcances, el UID del proyecto, el ID de integración y la estructura del payload JSON.
Widget de chat silencioso
: Si las verificaciones de Origin fallan, comprueba los orígenes permitidos opcionales, HTTPS y que los IDs de integración coincidan con la entrada del panel de control.
API de blog o catálogo vacía
: Confirma que el contenido está publicado para el idioma solicitado y que la clave API tiene el alcance de lectura correspondiente.
¿Listo para más?
getting-started{.interpreted-text role="doc"} --- recorrido conceptual del modelo de integración de Mailoo- Guías de integración en Integraciones
- OpenAPI en
https://api.mailoo.app/docs/v1