Glossario

Glossario pubblico abbreviato dei termini MailingCore.

Riferimento rapido ai termini usati in API, pannello e webhook.

Termine	Definizione
Tenant	Workspace isolato. Domini, template, contatti, quota e membri propri. Identificato da `X-Tenant-Id`.
Admin	Utente umano con accesso al pannello. Puo appartenere a uno o piu tenant.
API key	Credenziale server (`mc_live_` / `mc_test_`) con scope granulari. Mostrata per intero solo alla creazione.
Scope	Permesso (`email:send`, `contacts:write`, …). Scope mancante → 403.
Template	Design email con nome. Contiene una o piu versioni.
Versione template	Istantanea con stato DRAFT o PUBLISHED. Gli invii referenziano un id versione pubblicata.
Contatto	Record audience (email, locale, opt-in, `externalId` per sync CRM).
Campagna	Invio newsletter: un template in fan-out su contatti filtrati.
Log invio	Record di un messaggio in uscita (`QUEUED`, `SENT`, `FAILED`, ecc.).
Soppressione	Indirizzo bloccato (bounce, reclamo, disiscrizione). Gli invii sono rifiutati.
Webhook	Callback HTTPS su eventi (`email.sent`, `contact.unsubscribed`, …) con firma HMAC.
Quota	Limite mensile email per piano. Header `X-Quota-*`; blocco duro al 110%.
JWT	Token di accesso breve per sessioni pannello (15 min) piu refresh token.
Tracking	Pixel apertura (`/track/o/:logId`) e redirect clic (`/track/c/:logId`).
Locale routing	Sceglie variante template per `locale` del contatto con catena di fallback.