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.
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.
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.
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.
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.
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.
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.
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.
Releases de documentacion e hitos de producto de alto nivel.