> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione Instantly

> Invia i contatti verificati da Enrow nelle tue campagne e liste di lead Instantly

## Panoramica

L'integrazione Instantly ti permette di inviare i contatti dalle tue liste Enrow direttamente in una **campagna o lista di lead** di Instantly, con email verificate, numeri di telefono e dati di personalizzazione mappati sulle variabili personalizzate. Niente esportazioni CSV, niente nuova verifica.

<Info>
  Le email trovate da Enrow sono **già verificate**, quindi riverificarle in fase di importazione servirebbe solo a consumare i tuoi crediti di verifica Instantly.
</Info>

## Configurazione

<Steps>
  <Step title="Ottieni la tua chiave API Instantly">
    In [Instantly](https://app.instantly.ai/app/settings/integrations), vai su **Settings → Integrations → API Keys** e crea una nuova chiave (API v2). Copiala subito, perché viene mostrata una sola volta.

    L'accesso all'API è incluso in **tutti i piani Instantly**. Ti consigliamo di creare la chiave con lo scope `all:all`; come minimo servono `campaigns:read`, `lead_lists:read` e `leads:create`.
  </Step>

  <Step title="Collega Instantly a Enrow">
    Nella [Dashboard di Enrow](https://app.enrow.io), vai su **Integrations** nel menu a sinistra, clicca su **Instantly** e incolla la tua chiave API. Enrow verifica la chiave con Instantly prima di salvarla.

    <Info>
      In un account team, solo gli **amministratori del team** collegano l'integrazione. In seguito ogni membro del team può inviare contatti tramite la connessione condivisa.
    </Info>
  </Step>

  <Step title="Configura (opzionale)">
    L'invio funziona da subito grazie a una mappatura predefinita ben calibrata. Dalla pagina dell'integrazione puoi anche impostare:

    * **Destinazione predefinita**: la campagna o lista di lead in cui finiscono gli invii per impostazione predefinita
    * **Mappatura dei campi**: quali campi Enrow alimentano quali campi e variabili personalizzate di Instantly
    * **Opzioni di invio**: come si comportano la deduplicazione e la verifica in fase di importazione
  </Step>
</Steps>

## Invio dei contatti

Da qualsiasi lista Enrow, invia un singolo contatto (riga del contatto → icona Instantly) oppure seleziona più righe e usa l'azione **Push** in blocco. Scegli la destinazione (sono supportate sia le campagne sia le liste di lead) e conferma.

* Il selettore di destinazione mostra un badge verde **“Already pushed”** su ogni campagna o lista di lead a cui il contatto è già stato inviato (con la data; per gli invii in blocco, un conteggio `pushed/selected`). Una destinazione che contiene già tutti i contatti selezionati appare in grigio ma resta selezionabile: rinviarli è un'operazione innocua e senza effetti grazie alla deduplicazione integrata di Instantly.
* I contatti **devono avere un'email**, quindi qualsiasi riga senza un'email trovata viene ignorata e segnalata.
* Dopo ogni invio ottieni il conteggio dei contatti aggiunti, duplicati e ignorati, e ogni invio compare nella scheda **History** dell'integrazione. Se raggiungi il limite di caricamento lead del tuo piano Instantly, Enrow te lo segnala.
* Le campagne gestite dalla funzione **AI SDR** di Instantly sono nascoste dal selettore, esattamente come Instantly le nasconde nel proprio elenco delle campagne.

<Info>
  Per impostazione predefinita, Instantly ignora un lead che esiste già **in qualsiasi punto del tuo workspace** (anche in un'altra campagna). Se vuoi usare lo stesso contatto in più campagne, disattiva “Skip leads already in your workspace” nelle opzioni di invio dell'integrazione.
</Info>

## Mappatura dei campi

Mappatura predefinita (modificabile dalla pagina dell'integrazione):

| Campo Enrow  | Campo Instantly                           |
| ------------ | ----------------------------------------- |
| Email        | `email`                                   |
| Nome         | `first_name`                              |
| Cognome      | `last_name`                               |
| Nome azienda | `company_name`                            |
| Telefono     | `phone`                                   |
| URL LinkedIn | `linkedin_url` (variabile personalizzata) |
| Headline     | `headline` (variabile personalizzata)     |
| Località     | `location` (variabile personalizzata)     |

Le variabili personalizzate vengono create automaticamente su ogni lead quando effettui l'invio, senza bisogno di configurare nulla in Instantly. Usale nelle tue sequenze come `{{linkedin_url}}`, `{{headline}}` ecc. (i nomi delle variabili fanno distinzione tra maiuscole e minuscole).

## Opzioni di invio

| Opzione                                    | Predefinito | Effetto                                                                                                                                         |
| ------------------------------------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Ignora i lead già presenti nel workspace   | **On**      | Ignora i contatti che esistono già in qualsiasi punto del tuo workspace Instantly, così la stessa persona non viene mai contattata due volte    |
| Ignora i lead già presenti in una campagna | Off         | Ignora i contatti che sono già presenti in un'altra campagna                                                                                    |
| Verifica i lead in fase di importazione    | Off         | Esegue la verifica di Instantly sui lead inviati (non necessaria per le email trovate da Enrow, e consuma i tuoi crediti di verifica Instantly) |

## Hai bisogno di aiuto?

* **Supporto Enrow**: [api@enrow.io](mailto:api@enrow.io)
