Controlla le funzionalità disponibili nel workspace prima di iniziare. L’avvio con revisione deve essere abilitato e la chiave deve avere il permesso
campaigns:launch. Se ricevi 503 feature_unavailable, chiedi all’amministratore del workspace di verificare l’accesso.1. Controlla l’idoneità dei contatti
Usa la selezione People indicando gli ID dei contatti oppure filtri consentiti. La richiesta richiedecontacts:read e una chiave di idempotenza. La risposta è uno snapshot in sola lettura con idoneità e codici dei blocchi. Non modifica i contatti, non li iscrive a una campagna e non crea un pubblico. Affina la selezione e verifica gli ID restituiti prima di procedere.
Per una campagna LinkedIn, le importazioni richiedono URL espliciti e HTTPS di profili LinkedIn canonici. Il risultato della selezione People non viene importato automaticamente. Limita ogni richiesta a 100 profili al massimo. Le ricerche dei profili tramite provider possono consumare la quota LinkedIn del workspace.
2. Prepara una bozza manuale inattiva
Crea o seleziona una bozza LinkedIn inattiva. Configura pubblico, passaggi supportati, mittente e orario, poi leggi la configurazione della campagna e conserva larevision corrente. Le modifiche richiedono lo scope di configurazione e expected_revision. Se la revisione è obsoleta, rileggi la configurazione più recente e riconcilia le modifiche prima di continuare.
Accoda URL espliciti con Crea un’operazione di importazione LinkedIn. Invia expected_revision aggiornato e il sender_id selezionato. Ogni importazione è limitata a 100 righe e può consumare quota di ricerca dei profili. L’importazione accodata aggiunge profili alla bozza; non avvia la campagna, non approva contenuti e non invia messaggi.
Interroga l’operazione e controlla i risultati delle righe. La lettura delle operazioni richiede operations:read e campaigns:read. Se la risposta alla creazione è incerta o non è arrivata, leggi le operazioni del workspace e riconcilia il risultato originale. Non inviare automaticamente una nuova importazione dopo un esito sconosciuto.
3. Richiedi una verifica di idoneità
Dopo aver preparato pubblico e configurazione, rileggi la configurazione e usa larevision corrente come expected_revision per richiedere una verifica di avvio LinkedIn. Per leggere la configurazione serve campaigns:read; la richiesta di verifica richiede campaigns:launch, oltre all’accesso applicabile al workspace. Le verifiche scadono dopo cinque minuti. Considera expires_at come valore autorevole e richiedi una nuova verifica quando è scaduta. Anche le modifiche a configurazione, pubblico, mittente o altre dipendenze possono renderla obsoleta. La verifica riporta blocchi e avvisi basati solo sullo stato locale.
4. Attiva esplicitamente l’esecuzione pianificata
Solo dopo aver verificato un risultato idoneo e ancora valido, chiama Avvia una campagna LinkedIn con l’ID della verifica econfirm_launch: true. La richiesta di avvio richiede campaigns:launch, oltre all’accesso applicabile al workspace. Per leggere configurazione, progressi e ricevute delle operazioni serve campaigns:read; per le ricevute serve anche operations:read. La richiesta restituisce 202 con un’operazione durevole. Usa una chiave di idempotenza per la richiesta logica di avvio.
queued e non è iniziata, annullala solo quando l’API conferma che è sicuro. Controlla error_code e stato; risolvi awaiting_user_action o needs_reconciliation prima di decidere un’altra azione. Per una verifica obsoleta o scaduta, riconcilia lo stato e richiedine una nuova. Usa una nuova chiave di idempotenza solo per un nuovo avvio dopo aver chiarito che l’esito precedente è noto e sicuro.
5. Consulta i progressi e metti in pausa se necessario
Interroga l’operazione mentre èqueued o running. Fermati quando diventa succeeded, failed, cancelled, awaiting_user_action o needs_reconciliation. Gli ultimi due stati richiedono che una persona legga error_code, risolva il problema e decida cosa fare; non proseguono da soli. Una ricevuta riuscita indica che la campagna è attiva per invii pianificati negli orari configurati. Non significa che una richiesta di collegamento o un messaggio sia stato consegnato. Leggi i progressi della campagna e, quando serve, lo stato salvato di un prospect. Conteggi e timestamp riflettono i dati salvati localmente, non l’accettazione del provider o la consegna completata.
Usa Metti in pausa una campagna per fermare le attività pianificate future. Se uno stato o timestamp richiede indagine, consulta i progressi e i dettagli del prospect in Emailx.
6. Riprendi una campagna in pausa
Una campagna LinkedIn manuale già avviata e poi messa in pausa può riprendere tramite API. La ripresa usa una verifica dedicata: una verifica di avvio viene rifiutata e una verifica di ripresa non può avviare una bozza. Leggi la configurazione, poi richiedi una verifica di ripresa usando larevision corrente come expected_revision. La richiesta richiede campaigns:launch e la verifica scade dopo cinque minuti. Il campo audience riporta i prospect salvati, quelli con attività ancora da svolgere, quelli esclusi e gli inviti con esito incerto.
confirm_resume: true. La richiesta restituisce 202 con un’operazione linkedin.resume.
dispatch_mode: "native_periodic_scheduler" e delivery_verified: false. Se la campagna o i suoi prospect cambiano dopo la verifica, l’operazione passa a awaiting_user_action e la campagna resta in pausa. Richiedi una nuova verifica prima di riprovare.