Guias de integracion, API y buenas practicas para enviar email desde tu frontend.
Primeros pasos
Que es MailingCore, para quien es y como encaja en tu stack.
Tenant, API keys, scopes, plantillas y demas terminos del producto.
Primer envio con API key en menos de 10 minutos.
Enviar correos transaccionales al abrir incidencias desde un flujo Botpress de atencion al cliente.
SDK en navegador vs API en servidor, colas y responsabilidades.
URL de API, claves mc_live/mc_test y staging.
Verificar dominio, cuota y supresiones antes de produccion.
SDK JavaScript
mailingcore-js — init, send y manejo de errores.
Instalar mailingcore-js — npm y estado de publicacion.
MailingCore.init — apiKey, baseUrl y timeout.
templateVersionId — enviar versiones publicadas de plantilla.
Reintentos seguros con idempotencyKey — misma clave, misma respuesta.
MailingCoreError — codigos de estado y recuperacion.
Server Actions — mantener la API key fuera del cliente.
Lista los emails enviados y su estado desde el SDK de JavaScript.
API REST
JWT para el panel y API keys para integraciones.
Crear claves, asignar permisos y rotar credenciales.
Header X-Tenant-Id y aislamiento de datos.
POST /emails/send — payload, respuesta y plantillas.
Formato de errores HTTP y causas habituales.
Headers X-Quota, grace period y bloqueo.
POST /emails/batch — hasta 100 destinatarios con variables por destinatario.
GET /emails/logs — historial paginado de envios del tenant.
Throttling, limites de auth y cabeceras X-RateLimit-*.
POST/GET/DELETE /scheduled-emails — envios transaccionales diferidos.
Metricas agregadas de aperturas, clics y rebotes por la API REST.
Plantillas
Draft vs Published y envio con templateVersionId.
POST .../publish, CSS inline y despublicar.
Sintaxis {{var}}, unsubscribeUrl y variables declaradas.
GET /library y POST clone — plantillas del sistema para tu tenant.
Editor del dashboard — Monaco, Unlayer y versiones borrador.
locale y localeGroupId — versiones multi-idioma.
Entregabilidad
Por que verificar tu dominio antes de produccion.
Registros SPF, DKIM y DMARC generados por MailingCore.
Comprobar SPF, DKIM y DMARC tras configurar DNS.
Bloquear envios a direcciones con rebote, queja o baja.
Pixel de tracking y redirect de enlaces para metricas de engagement.
fromEmail, fromName y replyTo en dominios verificados.
Supresion por hard bounce, webhook SES y evento email.bounced.
Que guarda el tracking de aperturas/clics, como desactivarlo y baja en un clic.
Newsletter y audiencia
Modelo de contacto, externalId y scopes para gestionar tu audiencia.
PUT /contacts con externalId, locale, optIn y atributos.
POST /contacts/bulk para sincronizar hasta 1000 contactos por peticion.
Pagina alojada /u/:token, variable {{unsubscribeUrl}} y borrado de contactos.
Estados, audiencia filtrada y fan-out de envios newsletter.
Flujo test send, programacion, envio y cancelacion de campanas.
GET /campaigns/:id/locale-coverage y fallback de variantes.
Sync de contactos, API de campanas y webhooks bidireccionales para newsletter embebida.
Automatizacion
Automatizaciones drip por pasos: envia y espera, con inscripcion de contactos y ciclo de vida propio.
Pasos SEND_EMAIL y WAIT, retardos, reglas de activacion y edicion en DRAFT.
Inscribe contactos en una secuencia activa, ciclo de vida del enrollment y estado real de los disparadores.
Prueba dos versiones de una plantilla en una campana y elige la ganadora por tasa de apertura.
Webhooks
Eventos, registro de endpoints y reintentos.
Validar X-MailingCore-Signature en tu servidor.
Referencia de payloads para email.* y contact.unsubscribed.
Registrar POST /webhooks/endpoints con scope webhooks:manage.
Log de entregas, politica de retry BullMQ y manejo idempotente.
Planes y limites
Limites por plan, cuotas y facturacion Stripe.
Aviso al 80 %, gracia al 110 % y bloqueo 429.
Stripe Checkout para cambiar de plan y Customer Portal para gestionar pagos.
Otorgamiento mensual, packs one-time y consumo en endpoints /ai.
Limites de peticion, tamano, batch y rate que aplica la API de MailingCore.
Asistente IA
Genera y mejora plantillas de email con IA desde el editor o la API /ai.
Endpoints /ai/generate, /ai/generate-template e /ai/improve, hard block 402 y limite 20/min.
Seguridad y GDPR
Alojamiento europeo, posicionamiento GDPR y limites de datos.
DELETE /contacts/:externalId — derecho al olvido.
Rotacion, separacion de entornos y sin exposicion en cliente.
Borrar un tenant/cuenta y que se elimina frente a lo que se conserva (GDPR).
Panel de control
Recorrido del panel web de MailingCore: emails, plantillas, dominios y ajustes.
Crear, copiar y asignar scopes a API keys desde el panel.
Activar 2FA TOTP para administradores del panel.
Invitar administradores, asignar roles y gestionar membresia del tenant.
KPIs agregados, tendencias diarias y top plantillas desde panel y API.
Integraciones
Envia a traves de tu propio servidor SMTP (por ejemplo Gmail) por proyecto.
MailingCore Forms — crea formularios de contacto que entregan por la API de MailingCore.
Deja que agentes de IA envien email por MailingCore con el servidor MCP y docs legibles por agentes.
Referencia
Swagger UI interactivo y esquema JSON en api.mailingcore.com.
Glosario publico abreviado de terminos MailingCore.
Madurez del producto, hosting, disponibilidad del SDK y datos en la UE.
Los estados del ciclo de vida de un log de email y que significa cada uno.