Glosario

Glosario publico abreviado de terminos MailingCore.

Referencia rapida de terminos usados en la API, el panel y los webhooks.

Termino	Definicion
Tenant	Espacio de trabajo aislado. Dominios, plantillas, contactos, cuota y miembros propios. Identificado por `X-Tenant-Id`.
Admin	Usuario humano con acceso al panel. Puede pertenecer a uno o mas tenants.
API key	Credencial de servidor (`mc_live_` / `mc_test_`) con scopes granulares. Se muestra completa solo al crearla.
Scope	Permiso (`email:send`, `contacts:write`, …). Scope faltante → 403.
Plantilla	Diseno de email con nombre. Contiene una o mas versiones.
Version de plantilla	Instantanea con estado DRAFT o PUBLISHED. Los envios referencian un id de version publicada.
Contacto	Registro de audiencia (email, locale, opt-in, `externalId` para sync CRM).
Campana	Envio newsletter: una plantilla en fan-out a contactos filtrados.
Log de envio	Registro de un mensaje saliente (`QUEUED`, `SENT`, `FAILED`, etc.).
Supresion	Direccion bloqueada (rebote, queja, baja). Los envios se rechazan.
Webhook	Callback HTTPS en eventos (`email.sent`, `contact.unsubscribed`, …) con firma HMAC.
Cuota	Limite mensual de emails por plan. Cabeceras `X-Quota-*`; bloqueo duro al 110%.
JWT	Token de acceso corto para sesiones del panel (15 min) mas refresh token.
Tracking	Pixel de apertura (`/track/o/:logId`) y redirect de clic (`/track/c/:logId`).
Locale routing	Elige variante de plantilla por `locale` del contacto con cadena de fallback.