> ## Documentation Index > Fetch the complete documentation index at: https://docs.emailx.ai/llms.txt > Use this file to discover all available pages before exploring further. # Preparare, rivedere e avviare email > Prepara attività email limitate, genera anteprime selezionate con consenso esplicito all’uso dei crediti AI, approva i messaggi esatti e accoda una campagna verificata per l’invio pianificato. Il flusso separa configurazione salvata, generazione dei contenuti, approvazione dei messaggi e avvio della campagna. Usa un host API compatibile con la versione 0.8.0, controlla le capacità del workspace e considera `503 feature_unavailable` come funzione non disponibile su quell’host. La disponibilità dell’host non è garantita. ## Configurare una bozza inattiva Crea una bozza email, collega contatti iscritti e leggi la configurazione. Imposta un mittente esplicitamente autorizzato, una pianificazione supportata e fino a dieci passaggi con template esistenti. Usa l’ultima `revision` della configurazione come `expected_revision` per le modifiche. Il prompt di un template salvato è configurazione: non genera e non approva contenuti personalizzati. L’endpoint legacy per creare direttamente un contatto richiede ancora l’indirizzo email. ## Preparare attività locali Chiama `POST /workspaces/{workspace_id}/campaigns/email/{campaign_id}/preparation` con `expected_revision` corrente e scope `campaigns:generate`. La risposta `202` restituisce un’operazione. La preparazione crea attività isolate `api_prepared` per un massimo di 500 messaggi contatto-passaggio, prima di qualsiasi addebito. Non chiama l’AI, non approva contenuti e non pianifica email. Interroga l’operazione con `operations:read` e `campaigns:read`. Prosegui solo finché l’avanzamento può continuare. Fermati e verifica lo stato salvato a `awaiting_user_action`, `needs_reconciliation` o in uno stato terminale. Un timeout o un esito incerto non autorizza un nuovo comando: leggi l’operazione originale e riusa chiave di idempotenza e corpo esatti solo per ripetere la stessa richiesta logica. ## Generare solo le anteprime selezionate Elenca le attività con `messages:read`, seleziona da 1 a 10 ID di attività preparate e chiama `POST .../generations` con revisione corrente, ID selezionati e `confirm_credit_use: true`. Questa azione consuma crediti AI. La generazione crea anteprime da rivedere; non le approva e non le invia. La scrittura richiede `campaigns:generate`. ## Rivedere ogni messaggio esatto Usa `GET .../messages/{task_id}` per leggere l’anteprima salvata. Per modificarla, invia il suo `preview_id` e l’`expected_revision` corrente del messaggio con `messages:write`. Dopo `stale_revision`, rileggi e riconcilia. Approva un’anteprima esatta separatamente con `messages:approve`: l’approvazione non avvia la campagna. Il rifiuto può annullare i passaggi successivi della bozza e non può essere annullato tramite questa API. ## Verificare e avviare Leggi la configurazione e crea `POST .../reviews` usando la revisione corrente e `campaigns:launch-email`. Una verifica pronta vale cinque minuti; `expires_at` è il riferimento autorevole. Se scade o cambia la configurazione, recupera l’ultima revisione e crea una nuova verifica. Avvia solo dopo conferma esplicita dell’operatore. Invia `review_id` pronto e `confirm_launch: true` a `POST .../launch`. L’operazione `202` pianifica i messaggi approvati tramite l’invio nativo nelle finestre configurate; non avvia un invio immediato e non prova la consegna. Le scritture di verifica e avvio richiedono `campaigns:launch-email`; per interrogare la ricevuta servono anche `operations:read` e `campaigns:read`. Interroga l’operazione originale e fermati a `awaiting_user_action`, `needs_reconciliation` o a uno stato terminale. Esamina `error_code`, risultato dell’operazione e progressi della campagna. Risolvi il problema, riconcilia lo stato locale e crea una nuova verifica prima di decidere un nuovo avvio. Non ripetere automaticamente un esito incerto. `active` significa pianificata per il dispatcher nativo, non consegnata; i progressi salvati non verificano accettazione del provider o consegna. ## Limiti e accesso Il corpo HTTP è limitato a 256 KiB. I comandi durevoli sono limitati a 64 KiB, tranne le importazioni People che arrivano a 128 KiB. La generazione accetta da 1 a 10 ID attività per richiesta. La preparazione email si ferma a 500 messaggi contatto-passaggio. L’esecuzione API dipende dalla configurazione dell’host e dalle autorizzazioni del workspace. Consulta [configurazione email](https://docs.emailx.ai/it/overview/email-setup.md), [configurazione campagne](https://docs.emailx.ai/it/overview/campaign-setup.md), [idempotenza e recupero](https://docs.emailx.ai/it/api-reference/idempotency.md) e [copertura API](https://docs.emailx.ai/it/api-reference/coverage.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.