Inicio rápido

Última actualización: Aug 31, 2026Sección: Integraciones

Formulario de contacto / comentarios

Usa una integración de Formulario de contacto / comentarios para recoger mensajes de tu sitio (contacto, soporte, comentarios). Cada envío crea un mensaje en Mailoo y un registro de comentario vinculado con campos estructurados.

:::: important ::: title Important :::

Solo del lado del servidor: Envía desde tu backend o BFF; llama a Mailoo con X-API-Key desde variables de entorno. No expongas la clave en JavaScript del navegador ni en paquetes públicos. ::::

:::: note ::: title Note :::

Legado: Llamar al webhook de comentarios directamente desde el navegador puede funcionar si CORS y los orígenes permitidos coinciden, pero expone la clave API. Usa un backend o BFF para nuevas integraciones. ::::

Inicio rápido

  1. En el panel de control, abre tu proyecto → Crear nueva integración → Formulario de contacto / comentarios.
  2. Opcionalmente establece orígenes permitidos (lista de orígenes). Déjalo vacío para omitir las verificaciones de Origin; la clave API sigue siendo obligatoria. Un BFF puede reenviar el Origin del navegador, así que una lista no vacía sigue aplicándose.
  3. Crea una clave API con alcance Envíos de formulario de comentarios (webhook.feedback-submission) si usas una clave RESTRICTED, o usa Acceso completo. Almacena la clave solo en el servidor.
  4. Desde tu servidor, haz POST al webhook de comentarios (consulta la referencia de API abajo).
  5. Visualiza los envíos en Mensajes de esa integración.

SMTP saliente (panel de control)

En la pestaña Conexión y ajustes de la integración, Correo saliente (SMTP) permite configurar el correo para flujos de suscriptores y respuestas de operador que usan el SMTP a nivel de integración (consulta outbound-smtp{.interpreted-text role="doc"}). Usa Enviar correo de prueba para verificar los campos SMTP actuales; la prueba se envía al correo de tu cuenta de Mailoo y no guarda automáticamente el formulario.

Referencia de API

Endpoint

POST /api/v1/webhooks/feedback/{projectUid}/{integrationId}

Cabeceras

Cabecera Obligatoria Descripción

Content-Type Sí application/json

X-API-Key Sí Clave API del proyecto con webhook.feedback-submission (o FULL)

Origin No Cuando allowedOrigins no está vacío, debe coincidir con una entrada. Omite o deja la lista vacía para saltar las verificaciones de Origin (la clave API sigue siendo obligatoria).

Cuerpo JSON

Campo Obligatorio Descripción

email Sí Correo del remitente

message Sí Cuerpo del mensaje (texto plano)

name No Nombre del remitente

subject No Línea de asunto (valor genérico por defecto si se omite)

metadata No Objeto con datos clave/valor adicionales (almacenados con el envío)

Respuesta exitosa (200)

{
  "success": true,
  "messageId": "...",
  "feedbackId": "...",
  "message": "Feedback submission processed successfully"
}

Panel de control

Abre Proyecto → Integración → Ver mensajes para listar y abrir mensajes individuales. Las integraciones de comentarios no usan las pestañas de suscriptores/campañas del boletín.

Integración desde tu aplicación Next.js

Conecta una ruta BFF con @mailoo/forms para que el navegador nunca vea la clave API. Guía completa, opciones de entorno y patrones del cliente: feedback-form-nextjs-example{.interpreted-text role="doc"}.

Consulta también

  • feedback-form-nextjs-example{.interpreted-text role="doc"} --- BFF de Next.js, lista de permitidos opcional, envío desde el cliente
  • outbound-smtp{.interpreted-text role="doc"} --- SMTP saliente de integración, correo de prueba del panel, MAIL_SMTP_ENCRYPTION_KEY
  • ../index{.interpreted-text role="doc"} --- otros tipos de integración
  • OpenAPI: https://api.mailoo.app/docs/v1 --- claves API y allowedOperations
📚