Vai al contenuto principale
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

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

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

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.
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.
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 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.
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 per il flusso completo. La guida alle bozze spiega input e dry-run; scripting 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.
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. 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.