​

Test di go-live della campagna Futura

​

Ambito

• definizioni di audience con targeting all, tags, o segment;
• filtri tipizzati su campi personalizzati per le audience di tipo segment;
• materializzazione dei destinatari in campaign_recipients prima del dispatch;
• binding del template tramite nome del template approvato o ID template, locale e variabili del corpo;
• ID di risposta a bottone normalizzati per l’instradamento di campagna e journey;
• eventi di opt-out da bottone di campagna scritti nel registro dei consensi;
• azioni di route deterministiche per tag contatto, attributi contatto, conversazioni aperte e opt-out.

​

Contratto dei metadati di campagna

{
  "audienceDefinition": {
    "kind": "tags",
    "tagIds": ["tag-vip"],
    "tagLabels": ["Futura"],
    "snapshotAt": "2026-04-27T07:00:00.000Z"
  },
  "templateBinding": {
    "templateName": "futura_repeat_guest_check_it",
    "locale": "it",
    "variables": [
      {
        "component": "body",
        "index": 0,
        "source": "contact.first_name",
        "fallback": "cliente"
      }
    ]
  },
  "responseRoutes": {
    "futura_not_booked": {
      "label": "Non ho ancora prenotato",
      "actions": [
        { "type": "tag_contact", "tagLabel": "futura_not_booked" },
        { "type": "open_conversation", "queue": "sales" },
        { "type": "set_contact_attribute", "attribute": "futura_response", "value": "not_booked" }
      ]
    },
    "futura_already_booked": {
      "label": "Ho già prenotato",
      "actions": [
        { "type": "tag_contact", "tagLabel": "futura_already_booked" },
        { "type": "set_contact_attribute", "attribute": "futura_response", "value": "already_booked" }
      ]
    },
    "marketing_opt_out": {
      "label": "Non voglio ricevere messaggi",
      "actions": [{ "type": "record_opt_out", "reason": "marketing_button" }]
    }
  },
  "launchSafety": {
    "requireDryRun": true,
    "maxRecipients": 500,
    "requireOptOutFooter": true
  }
}

​

Checklist di preflight

​

Materializzazione dei destinatari

• legge la audienceDefinition della campagna dai metadati v1;
• risolve le audience all, tag o segment all’interno del workspace;
• deduplica i contatti per ID;
• salta i contatti opted-out o unsubscribed;
• inserisce nuovi destinatari queued con una chiave univoca campaign_id,contact_id;
• aggiorna i metadati della campagna con materialization.materializedCount, skippedOptOutCount, duplicateCount e materializedAt.

• materializedCount corrisponde al conteggio approvato dopo gli skip per consenso;
• skippedOptOutCount è spiegabile e diverso da zero solo quando previsto;
• una seconda esecuzione di materializzazione segnala duplicati invece di creare destinatari duplicati;
• non sono state create righe campaign_recipients per contatti esterni al workspace;
• non esistono righe per contatti di test noti come opted-out.

​

Controlli di dispatch e personalizzazione

• esiste o viene creata una conversazione nel canale previsto;
• una riga messages in uscita è accodata con send_mode: template e author_label: Campaign;
• payload.templateName è il nome del template collegato (bound);
• payload.templateLocale è presente quando è configurato un locale;
• payload.templateComponents include i parametri del corpo nell’ordine dell’indice;
• contact.first_name viene risolto prima da contacts.metadata.first_name, poi dal primo token di contacts.name, poi dal fallback configurato;
• l’anteprima del corpo del messaggio renderizzato sostituisce {{1}}, {{2}} e i placeholder successivi in modo coerente con i componenti del template;
• i destinatari opted-out incontrati durante il dispatch vengono segnati come falliti con error_code: skipped_opt_out e non vengono inviati.

​

Normalizzazione delle risposte a bottone

• bottoni di risposta legacy: message.button.payload;
• bottoni interattivi: message.interactive.button_reply.id;
• risposte a lista interattiva: message.interactive.list_reply.id.

​

Test di opt-out del consenso

1. Invia un messaggio di campagna di test a un contatto seed che ha dato il consenso.
2. Rispondi toccando il bottone di opt-out, non digitando una parola chiave STOP.
3. Conferma che venga scritta una riga consent_events con event_type: opted_out, source: campaign_button, actor: system, e metadati contenenti il buttonId e l’ID del messaggio del provider.
4. Conferma che il subscriber_status del contatto venga aggiornato a unsubscribed e che il contatto non sia più eleggibile per successive materializzazioni di campagna.
5. Conferma che i tentativi di dispatch successivi saltino il contatto prima di creare un invio Meta.

​

Follow-up manuale invece di journey avviate dalla campagna

• futura_not_booked tagga il contatto, registra futura_response=not_booked, e apre/instrada la conversazione verso le vendite;
• un operatore umano rivede la conversazione e invia manualmente la prossima risposta approvata;
• futura_already_booked tagga o segna il contatto come già prenotato e non richiede alcuna journey automatica;
• marketing_opt_out registra l’opt-out del consenso e non deve mai attivare un follow-up di marketing.

​

Checklist operativa di go-live

• I metadati di campagna validano contro lo schema v1.
• L’anteprima del segmento o il conteggio dei tag corrisponde all’audience approvata.
• I filtri tipizzati su campi personalizzati sono stati testati con almeno un contatto seed corrispondente e uno non corrispondente.
• I conteggi della materializzazione dei destinatari sono stati registrati nelle note di lancio.
• Il nome del template approvato, il locale e i fallback delle variabili del corpo sono stati verificati.
• I payload dei componenti del template sono stati ispezionati per almeno due contatti seed.
• Gli ID dei bottoni sono stati testati da WhatsApp, non solo da payload di webhook simulati (mock).
• marketing_opt_out ha creato un evento nel registro dei consensi di tipo campaign_button.
• La materializzazione e il dispatch post-opt-out hanno entrambi saltato il contatto seed.
• È stato assegnato personale per il follow-up manuale di futura_not_booked e delle eventuali risposte opzionali futura_already_booked.
• I metadati delle route di produzione non contengono azioni start_journey.
• I job outbox campaign.dispatch e message.dispatch si sono svuotati senza fallimenti inaspettati.
• I conteggi di delivery, letto, fallito e saltato sono stati confrontati con le metriche di dettaglio della campagna.
• L’owner dell’incidente e il punto di decisione per rollback/pausa sono documentati.

​

Criteri di rollback e pausa

• la materializzazione include contatti fuori dall’audience approvata;
• i contatti opted-out ricevono messaggi di campagna;
• le risposte a bottone vengono registrate come etichette di visualizzazione invece di ID normalizzati;
• la pianificazione del lancio dipende dall’avvio automatico da campagna a journey prima che BORD-431 sia implementato;
• Meta restituisce errori di policy o template sostenuti nel tempo per il template Futura;
• i fallimenti di delivery superano la soglia concordata dall’owner della campagna.