> ## 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. # Reference dei comandi > Tutte le operazioni v1 organizzate per lavoro da svolgere. Gli ID degli esempi sono segnaposto. Usa quelli restituiti per il workspace scelto e conserva il canale con gli ID di campagne e conversazioni. Ogni comando ha `--help`. ## Lettura ```bash theme={null} emailx auth status --json emailx workspaces list --limit 25 --json emailx workspaces get 123 --json emailx contacts list --workspace 123 --email person@example.com --json emailx contacts get 789 --workspace 123 --json emailx campaigns list --workspace 123 --channel linkedin --json emailx campaigns get 456 --workspace 123 --channel linkedin --json emailx campaigns configuration 456 --workspace 123 --channel linkedin --json emailx prospects list 456 --workspace 123 --channel linkedin --json emailx inbox list --workspace 123 --channel email --json emailx inbox get 789 --workspace 123 --channel email --json emailx senders list --workspace 123 --channel email --json emailx senders get 903 --workspace 123 --channel email --json emailx workspaces capabilities 123 --json emailx members list --workspace 123 --json emailx reply-routing options --workspace 123 --channel linkedin --json emailx analytics get --workspace 123 --channel linkedin --json emailx outcomes list --workspace 123 --channel email --json ``` Le liste restituiscono una pagina. Per continuare passa `next_cursor` con `--cursor` e filtri invariati. I contatti accettano anche `--unsubscribed true` o `false`. I dati dei mittenti sono salvati, lo storico inbox è incompleto e le analytics sono storiche. Gli esiti possono restituire `feature_unavailable`. ## Creazione e modifica ```bash theme={null} emailx contacts create --workspace 123 --file contact.json --idempotency-key contact-001 --json emailx contacts update 789 --workspace 123 --file changes.json --idempotency-key contact-update-001 --json emailx contacts suppress 789 --workspace 123 --idempotency-key suppress-001 --json emailx campaigns create-draft --workspace 123 --channel linkedin --file draft.json --idempotency-key draft-001 --json emailx campaigns configure 456 --workspace 123 --channel linkedin --file setup.json --idempotency-key setup-001 --json emailx campaigns rename 456 --workspace 123 --channel linkedin --name "Reviewed draft" --idempotency-key rename-001 --json emailx prospects add 456 --workspace 123 --channel linkedin --file prospect.json --idempotency-key prospect-001 --json emailx prospects add 456 --workspace 123 --channel email --file audience.json --idempotency-key audience-001 --json ``` La creazione del contatto richiede `email`; l'aggiornamento non può cambiarla. L'esclusione imposta `unsubscribed=true` e non annulla una disiscrizione. Il file prospect LinkedIn richiede un `provider_id` risolto; il pubblico email usa `{"contact_ids":[789]}`. Entrambi si aggiungono solo a bozze inattive, senza ricerca provider o invio. ## Pausa ```bash theme={null} emailx campaigns get 456 --workspace 123 --channel linkedin --json emailx campaigns pause 456 --workspace 123 --channel linkedin --idempotency-key pause-001 --yes --json emailx campaigns get 456 --workspace 123 --channel linkedin --json ``` La pausa richiede un'intenzione esplicita. Nel terminale interattivo compare una conferma; gli script devono passare `--yes`, altrimenti si fermano prima di HTTP. Non richiama attività già in corso. Una bozza resta bozza. Non esiste un comando di ripresa. ## Template e importazioni LinkedIn Il pacchetto 0.5.0 aggiunge comandi per gestire impostazioni salvate dei template e importare un numero limitato di URL di profili LinkedIn. Per leggere i template serve `templates:read`; per crearli o modificarli serve `templates:write`. Salvare i campi non esegue prompt e non approva contenuti generati. ```bash theme={null} emailx templates list --workspace 123 --json emailx templates get 601 --workspace 123 --json emailx templates create --workspace 123 --file template.json --idempotency-key template-001 --json emailx templates update 601 --workspace 123 --file template-update.json --idempotency-key template-update-001 --json ``` Per LinkedIn, leggi prima la configurazione aggiornata della campagna e copia la `revision` in `import.json`. Aggiungi l’ID Emailx del mittente selezionato e da 1 a 100 URL HTTPS canonici di profili. Per leggere la configurazione serve `campaigns:read`; l’importazione richiede `campaigns:import`. La funzione è disattivata per impostazione predefinita e le ricerche possono consumare quota provider. L’importazione, da sola, non attiva campagne e non invia messaggi. ```bash theme={null} emailx campaigns import-linkedin 456 --workspace 123 --file import.json --idempotency-key linkedin-import-001 --json emailx operations list --workspace 123 --json emailx operations get op_0123456789abcdef0123456789abcdef --workspace 123 --json emailx operations rows op_0123456789abcdef0123456789abcdef --workspace 123 --json emailx operations cancel op_0123456789abcdef0123456789abcdef --workspace 123 --idempotency-key cancel-001 --yes --json ``` Per leggere le operazioni servono `operations:read` e `campaigns:read`. L’annullamento richiede anche `operations:write` e il grant originale del comando: `campaigns:import` per un’importazione o `campaigns:launch` per un’attivazione. `--yes` rende esplicita l’intenzione negli script. Se l’esito è incerto, leggi l’operazione e gli eventuali risultati delle righe d’importazione. La CLI non ripete automaticamente i comandi. Consulta [template e importazioni LinkedIn](https://docs.emailx.ai/it/overview/templates-and-linkedin-imports.md) per la struttura JSON e le regole di recupero. ## Verifica e attiva una campagna LinkedIn Il pacchetto 0.6.0 aggiunge l’anteprima d’idoneità People e l’attivazione esplicita di bozze LinkedIn manuali già verificate. L’anteprima People è in sola lettura e non iscrive i contatti. Le richieste di verifica e avvio richiedono `campaigns:launch` e una verifica valida. Per leggere configurazione e progressi serve `campaigns:read`; per interrogare le ricevute servono `operations:read` e `campaigns:read`. Verifica le capacità del workspace e considera `feature_unavailable` come funzione non abilitata. ```bash theme={null} emailx contacts select --workspace 123 --file selection.json --idempotency-key people-preview-001 --json emailx campaigns configuration 456 --workspace 123 --channel linkedin --json emailx campaigns review-linkedin 456 --workspace 123 --expected-revision REVISIONE_CORRENTE --idempotency-key linkedin-review-001 --json emailx campaigns launch-linkedin 456 --workspace 123 --review-id ID_VERIFICA --idempotency-key linkedin-launch-001 --yes --json emailx operations get op_0123456789abcdef0123456789abcdef --workspace 123 --json emailx campaigns linkedin-progress 456 --workspace 123 --json emailx prospects get-linkedin 901 --workspace 123 --campaign 456 --json emailx campaigns pause 456 --workspace 123 --channel linkedin --idempotency-key pause-002 --yes --json emailx campaigns review-linkedin-resume 456 --workspace 123 --expected-revision REVISIONE_CORRENTE --idempotency-key linkedin-resume-review-001 --json emailx campaigns resume-linkedin 456 --workspace 123 --review-id ID_VERIFICA_RIPRESA --idempotency-key linkedin-resume-001 --yes --json ``` Il pacchetto 0.9.0 aggiunge `review-linkedin-resume` e `resume-linkedin` per le campagne manuali già avviate e messe in pausa. La ripresa richiede una verifica dedicata: una verifica di avvio viene rifiutata. I progressi salvati restano invariati, non parte nessun invio di lancio e i tentativi con esito incerto non vengono mai ripetuti. Gli script richiedono `--yes`. Per la verifica usa la revisione più recente della configurazione. In una shell interattiva il comando chiede conferma prima dell’avvio; gli script richiedono `--yes`. Una ricevuta riuscita indica l’attivazione locale per il dispatcher pianificato, non la consegna. Se l’esito è incerto, leggi l’operazione originale e non inviare automaticamente un’altra richiesta. Per verifiche obsolete o scadute, riconcilia lo stato e richiedine una nuova. Consulta [verifica e avvio](https://docs.emailx.ai/it/overview/review-and-launch-linkedin.md) per il flusso completo. La guida alle [bozze](https://docs.emailx.ai/it/cli/drafts.md) spiega input e dry-run; [scripting](https://docs.emailx.ai/it/cli/scripting.md) descrive output e codici di uscita. ## Esecuzione email e importazione People Il pacchetto 0.8.0 aggiunge comandi separati per preparazione, generazione, revisione del messaggio esatto, approvazione e avvio email verificato, oltre all’importazione People CSV/XLSX limitata. Usa un host API compatibile e verifica le capacità del workspace. `campaigns:generate`, `messages:write`, `messages:approve` e `campaigns:launch-email` sono scope distinti. `campaigns:launch-email` riguarda email; LinkedIn continua a usare `campaigns:launch`. ```bash theme={null} emailx campaigns prepare-email 456 --workspace 123 --expected-revision REVISIONE --idempotency-key prepare-001 --json emailx campaigns generate-email 456 --workspace 123 --expected-revision REVISIONE --task-id 101 --confirm-credit-use --idempotency-key generate-001 --yes --json emailx messages list 456 --workspace 123 --json emailx messages get 101 --workspace 123 --campaign 456 --json emailx messages approve 101 --workspace 123 --campaign 456 --file approval.json --idempotency-key approve-001 --json emailx campaigns review-email 456 --workspace 123 --expected-revision REVISIONE --idempotency-key review-001 --json emailx campaigns launch-email 456 --workspace 123 --review-id ID_VERIFICA_PRONTA --idempotency-key launch-001 --yes --json emailx campaigns email-progress 456 --workspace 123 --json ``` La generazione accetta da 1 a 10 attività preparate e consuma crediti AI. Verifica e avvio sono separati; la verifica pronta scade dopo cinque minuti (`expires_at` è autorevole). L’operazione `202` pianifica messaggi approvati nelle finestre configurate e non prova la consegna. Interroga l’operazione originale; fermati a `awaiting_user_action`, `needs_reconciliation` o a uno stato terminale. Gli esiti incerti non vengono ripetuti automaticamente. Consulta [esecuzione email](https://docs.emailx.ai/it/overview/email-execution.md). Per People, inizia con `emailx contacts preview-import` usando `--file`, `--mapping` o `--mapping-file` e `--channel email|linkedin`. Conferma il fingerprint esatto con `emailx contacts import --expected-fingerprint ... --yes`; leggi gli ID con `emailx contacts import-rows`. I file sono limitati a 64 KiB e 1.000 righe. L’importazione salva solo i contatti, senza iscriverli. Le righe solo LinkedIn possono non avere email, ma `contacts create` diretto richiede ancora email. Consulta [importazione People](https://docs.emailx.ai/it/overview/people-import.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.