> ## 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.

# Configurare una campagna inattiva

> Seleziona mittenti, template, passaggi, responsabili delle risposte e orari di una campagna Emailx inattiva, senza sovrascrivere modifiche più recenti.

Configura una bozza Emailx dopo averla creata e aver selezionato il pubblico. Leggi le impostazioni salvate, modifica i campi necessari e rileggi il risultato. Il salvataggio mantiene la campagna inattiva.

> [!NOTE]
>
> Servono il pacchetto 0.4.0 o successivo, un host API aggiornato e una nuova autorizzazione `campaigns:configure`. Le chiavi esistenti mantengono i propri permessi. [Verifica le funzionalità accessibili](https://docs.emailx.ai/it/api-reference/start/check-permissions.md) prima di procedere.

## Leggere prima di modificare

```bash theme={null}
emailx campaigns configuration 456 --workspace 123 --channel linkedin --json
```

Copia `revision` in `expected_revision` per la modifica successiva. La revisione cambia quando cambiano le impostazioni salvate o il contenuto dei template email selezionati. Non interpretarne il valore. `editable` ed `edit_blockers` descrivono lo stato salvato della campagna; scope e permessi sui mittenti sono verificati separatamente.

Gli ID della guida sono esempi. Leggi [mittenti](https://docs.emailx.ai/it/api-reference/senders/list-senders.md) e [responsabili delle notifiche](https://docs.emailx.ai/it/api-reference/team/get-reply-notifications.md) nel workspace scelto. `sender_ids` contiene ID mittente Emailx, non ID provider o indirizzi email. Puoi salvare mittenti disconnessi per correggerli in seguito: la selezione non certifica che possano inviare.

## Configurare LinkedIn

Crea `setup.json` usando la revisione e gli ID effettivi:

```json setup.json theme={null}
{
  "expected_revision": "COPIA_LA_REVISIONE_DELLA_LETTURA",
  "sender_ids": [903],
  "language": "Italian",
  "reply_routing": "sender",
  "steps": [
    {"type": "connection_request", "wait_days": 0},
    {"type": "message", "message": "Buongiorno, vorrei confrontarmi su una possibile collaborazione.", "wait_days": 2}
  ],
  "schedule": {
    "timezone": "Europe/Rome",
    "active_days": ["Mon", "Tue", "Wed", "Thu", "Fri"],
    "time_start": "09:00",
    "time_end": "17:00",
    "daily_connection_limit": 20,
    "daily_message_limit": 40
  }
}
```

```bash theme={null}
emailx campaigns configure 456 --workspace 123 --channel linkedin --file setup.json --idempotency-key setup-001 --dry-run --json
emailx campaigns configure 456 --workspace 123 --channel linkedin --file setup.json --idempotency-key setup-001 --json
emailx campaigns configuration 456 --workspace 123 --channel linkedin --json
```

La simulazione verifica lo schema localmente senza richieste HTTP. Non controlla revisione, proprietà dei mittenti o idoneità della campagna. Sostituisci il segnaposto della revisione prima di eseguirla.

Sono supportate bozze normali con fonte manuale e autopilot disabilitato. Ricerca AI, pool condivisi e modalità speciali restano gestiti nell’app. Puoi modificare `audience` e `sender_context` come contesto testuale: non avviano ricerche né qualificano prospect.

La sequenza accetta una richiesta di collegamento, solo all’inizio, e fino a cinque messaggi. Ogni messaggio richiede testo non vuoto. Le note hanno massimo 300 caratteri; i limiti del provider possono essere inferiori. Le attese vanno da 0 a 14 giorni. La configurazione ammette da 1 a 30 richieste di collegamento e da 1 a 100 messaggi al giorno: sono limiti di validazione, non volumi consigliati o garanzie del provider. Consulta i [limiti di invio consigliati](https://docs.emailx.ai/it/overview/sending-limits.md).

## Configurare email

Usa ID di template già presenti nel workspace. Puoi selezionare template normali o smart template creati in Emailx; il salvataggio del riferimento non genera né approva i contenuti personalizzati.

```json setup.json theme={null}
{
  "expected_revision": "COPIA_LA_REVISIONE_DELLA_LETTURA",
  "sender_ids": [904, 905],
  "reply_owner_subclient_id": null,
  "steps": [
    {"template_id": 601, "label": "Presentazione", "wait_days": 0},
    {"template_id": 602, "label": "Sollecito", "wait_days": 3}
  ],
  "schedule": {
    "timezone": "Europe/Rome",
    "active_days": ["Mon", "Tue", "Wed", "Thu", "Fri"],
    "time_start": "09:00",
    "time_end": "17:00",
    "daily_volume_per_mailbox": 30,
    "initial_wait_days": 0
  }
}
```

Esegui gli stessi comandi con `--channel email`. L’endpoint accetta fino a dieci passaggi basati su template, attese da 0 a 90 giorni, volume giornaliero da 1 a 100 per casella e attesa iniziale da 0 a 90 giorni. Sono limiti della configurazione API. Prima degli invii restano da verificare salute delle caselle, warmup, abbonamento e budget disponibili.

I contatti selezionati restano invariati. Aggiungi contatti iscritti con l’[endpoint prospect email](https://docs.emailx.ai/it/api-reference/prospects/add-email-prospects.md). Le sequenze grafiche precedenti e le campagne con record di anteprima, pianificazione o invio richiedono l’app.

## Sostituzione e recupero

Invia solo i campi principali da modificare. Un campo omesso resta invariato. `sender_ids` e `steps` sostituiscono le rispettive liste complete; una lista vuota azzera la selezione della bozza. `schedule` sostituisce l’intera pianificazione e richiede tutti i campi del canale. Usa un fuso IANA, giorni univoci e orari `HH:MM` nello stesso giorno, con inizio precedente alla fine.

Per modificare un passaggio esistente, includi il suo `id` restituito dalla lettura. Gli allegati LinkedIn restano associati a quell’ID. Cambiare tipo o rimuovere un passaggio con allegati tramite questo endpoint viene rifiutato: gestisci prima gli allegati in Emailx. ID sconosciuti o di un altro workspace vengono rifiutati, senza ripieghi silenziosi.

Per email, `reply_owner_subclient_id=null` indica il proprietario del workspace; un ID collaboratore deve appartenere a un membro reale e attivo. LinkedIn supporta `reply_routing=sender` per notificare il proprietario del profilo mittente e `person` per il responsabile selezionato. Queste impostazioni regolano le notifiche, non l’invio automatico di risposte.

Con `stale_revision`, rileggi e verifica la modifica desiderata prima di inviare una nuova operazione con una nuova chiave di idempotenza. Dopo timeout o esito incerto, riutilizza chiave e corpo originali identici: cambiare revisione con la stessa chiave genera conflitto. Dopo un replay rileggi lo stato, perché la risposta salvata può descrivere una revisione precedente.

`approval_status=not_evaluated` e `activation_status=not_requested` rendono esplicito il risultato. Rivedi pubblico, contenuti generati e mittenti nell’app prima dell’avvio. Questi endpoint non avviano campagne né inviano messaggi.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.