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

# Verifica e avvia una campagna LinkedIn

> Controlla l’idoneità dei contatti, importa un pubblico LinkedIn limitato, verifica lo stato locale, attiva esplicitamente l’esecuzione pianificata, consulta i progressi salvati e riprendi una campagna in pausa.

Segui questo flusso per preparare e attivare esplicitamente una campagna LinkedIn manuale tramite API. Puoi usare un’anteprima di selezione People in sola lettura per controllare l’idoneità dei contatti. Le importazioni LinkedIn aggiungono un pubblico limitato a una bozza; prima che l’attivazione pianificata sia possibile, serve una verifica separata e a breve scadenza.

> [!NOTE]
>
> 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](https://docs.emailx.ai/it/api-reference/import-contacts/check-contacts-eligibility.md) indicando gli ID dei contatti oppure filtri consentiti. La richiesta richiede `contacts: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 la `revision` 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](https://docs.emailx.ai/it/api-reference/prospects/import-linkedin-profiles.md). 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](https://docs.emailx.ai/it/api-reference/jobs/get-job.md) e controlla i [risultati delle righe](https://docs.emailx.ai/it/api-reference/prospects/list-linkedin-import-results.md). La lettura delle operazioni richiede `operations:read` e `campaigns:read`. Se la risposta alla creazione è incerta o non è arrivata, leggi [le operazioni del workspace](https://docs.emailx.ai/it/api-reference/jobs/list-jobs.md) 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 la `revision` corrente come `expected_revision` per richiedere [una verifica di avvio LinkedIn](https://docs.emailx.ai/it/api-reference/launch-linkedin/check-linkedin-launch.md). 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.

```bash theme={null}
curl -X POST "$EMAILX_BASE_URL/api/v1/workspaces/123/campaigns/linkedin/456/reviews" \
  -H "Authorization: Bearer $EMAILX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: linkedin-review-2026-11-001" \
  --data '{"expected_revision":"COPIA_LA_REVISIONE_CORRENTE_DELLA_CAMPAGNA"}'
```

La verifica non controlla salute dell’account LinkedIn, non riserva quota, non genera né approva contenuti e non garantisce la consegna. Risolvi i blocchi in Emailx, leggi la configurazione aggiornata e richiedi una nuova verifica. Non riutilizzare una verifica scaduta, obsoleta o bloccata.

## 4. Attiva esplicitamente l’esecuzione pianificata

Solo dopo aver verificato un risultato idoneo e ancora valido, chiama [Avvia una campagna LinkedIn](https://docs.emailx.ai/it/api-reference/launch-linkedin/launch-linkedin.md) con l’ID della verifica e `confirm_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.

```bash theme={null}
curl -X POST "$EMAILX_BASE_URL/api/v1/workspaces/123/campaigns/linkedin/456/launch" \
  -H "Authorization: Bearer $EMAILX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: linkedin-launch-2026-11-001" \
  --data '{"review_id":"COPIA_L_ID_DELLA_VERIFICA","confirm_launch":true}'
```

Il servizio ricontrolla verifica e dipendenze locali prima dell’attivazione. Gli invii successivi seguono gli orari configurati tramite il dispatcher pianificato. Questa richiesta non avvia un invio immediato e la ricevuta dell’operazione non verifica la consegna.

Se la risposta all’avvio è persa o incerta, leggi l’operazione originale o elenca le operazioni del workspace. Non ripetere automaticamente la richiesta e non creare una nuova chiave per lo stesso avvio. Se l’operazione è ancora `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](https://docs.emailx.ai/it/api-reference/running/get-linkedin-progress.md) e, quando serve, lo [stato salvato di un prospect](https://docs.emailx.ai/it/api-reference/prospects/get-linkedin-prospect.md). Conteggi e timestamp riflettono i dati salvati localmente, non l’accettazione del provider o la consegna completata.

Usa [Metti in pausa una campagna](https://docs.emailx.ai/it/api-reference/running/pause-campaign.md) 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](https://docs.emailx.ai/it/api-reference/launch-linkedin/check-linkedin-resume.md) usando la `revision` 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.

```bash theme={null}
curl -X POST "$EMAILX_BASE_URL/api/v1/workspaces/123/campaigns/linkedin/456/resume-reviews" \
  -H "Authorization: Bearer $EMAILX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: linkedin-resume-review-2026-11-001" \
  --data '{"expected_revision":"COPIA_LA_REVISIONE_CORRENTE"}'
```

La verifica si blocca se un invito ha un esito incerto, se un’importazione è ancora in corso, se la campagna usa la ricerca AI o una modalità diversa da quella normale, oppure se un mittente, un posto o il piano non sono più disponibili. Risolvi il blocco in Emailx e richiedi una nuova verifica. La ripresa non cancella mai un tentativo incerto al posto tuo.

Dopo la conferma esplicita dell’utente, chiama [Riprendere una campagna LinkedIn](https://docs.emailx.ai/it/api-reference/launch-linkedin/resume-linkedin.md) con l’ID della verifica e `confirm_resume: true`. La richiesta restituisce `202` con un’operazione `linkedin.resume`.

```bash theme={null}
curl -X POST "$EMAILX_BASE_URL/api/v1/workspaces/123/campaigns/linkedin/456/resume" \
  -H "Authorization: Bearer $EMAILX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: linkedin-resume-2026-11-001" \
  --data '{"review_id":"COPIA_ID_VERIFICA_RIPRESA","confirm_resume":true}'
```

Il worker ricontrolla i permessi e ogni dipendenza verificata, poi rende attiva la campagna. Lo scheduler periodico prosegue con le attività future negli orari configurati. Progressi salvati, data di avvio e mittenti assegnati restano invariati: non parte nessun invio di lancio e gli arretrati non vengono inviati tutti insieme. Una ricevuta riuscita riporta `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.

## Campagne email

La creazione e la configurazione di campagne email tramite API restano operazioni su bozze inattive. Questo flusso di verifica e attivazione LinkedIn non avvia campagne email e non invia email.

## Guide correlate

* [Template e importazioni LinkedIn](https://docs.emailx.ai/it/overview/templates-and-linkedin-imports.md)
* [Configurazione campagne](https://docs.emailx.ai/it/overview/campaign-setup.md)
* [Idempotenza e recupero](https://docs.emailx.ai/it/api-reference/idempotency.md)


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