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’ultimarevision 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
ChiamaPOST /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à conmessages: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
UsaGET .../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 creaPOST .../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.