Copertura per lingua

GET /campaigns/:id/locale-coverage e routing varianti multi-lingua.

Quando l'audience include contatti in piu lingue, MailingCore risolve automaticamente la variante del template per ogni destinatario. L'endpoint locale-coverage ti mostra quali lingue hanno una variante pubblicata prima di programmare l'invio.

Scope richiesto: campaigns:read.

Endpoint

GET https://api.mailingcore.com/campaigns/:id/locale-coverage
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

Risposta

Array di righe con la copertura per locale:

[
  { "locale": "it", "audienceCount": 450, "hasVariant": true },
  { "locale": "en", "audienceCount": 120, "hasVariant": true },
  { "locale": "es", "audienceCount": 80, "hasVariant": false }
]

Campo	Descrizione
`locale`	Codice lingua del contatto
`audienceCount`	Contatti nell'audience con quel locale
`hasVariant`	Esiste una versione pubblicata per quel locale nel `localeGroupId` del template

hasVariant: false non blocca l'invio; indica che verra usato il fallback.

Catena di fallback

Al fan-out, per ogni contatto MailingCore risolve il template in questo ordine:

Variante del Contact.locale
CAMPAIGN_FALLBACK_LOCALE (env, default es)
Versione base della campagna (locale: null)

Il locale risolto viene salvato in email_log.metadata.locale. Il link di disiscrizione include ?lang= con il locale del contatto.

Varianti multi-lingua

Crea versioni pubblicate con lo stesso localeGroupId e locale diverso (es, en, it, fr, ca, de). Se localeGroupId e null, l'id della versione base funge da gruppo.

La versione neutra (locale: null) e la rete di sicurezza finale.

Pubblica le varianti
Crea e pubblica una versione per ogni lingua con lo stesso localeGroupId.
Crea la campagna
Referenzia una versione base in templateVersionId.
Controlla la copertura
GET /campaigns/:id/locale-coverage prima di schedule o send.
Rivedi gli avvisi
Se localeCoverageWarnings compare nella risposta di invio, valuta se aggiungere varianti mancanti.

Avvisi all'invio

POST /campaigns/:id/schedule e POST /campaigns/:id/send possono includere:

{
  "localeCoverageWarnings": [
    { "locale": "es", "audienceCount": 80, "hasVariant": false }
  ]
}

Sono informativi: l'invio procede usando il fallback. Utile per QA prima di campagne multilingua.