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

# Creare link di candidatura

> Scopri come sono strutturati i link di candidatura PastaHR e come crearli.

## Struttura di un link di candidatura PastaHR

Un link di candidatura PastaHR è un URL che determina quale flusso avvia e a quale posizione viene collegata la candidatura.

**Esempio :**

```text theme={null}
https://conv.pastahr.com/r/ORGXXXX?remote_job_id={ID_POSIZIONE_ATS}&remote_job_name={NOME_POSIZIONE}&utm_source=linkedin&utm_medium=social&utm_campaign=assunzioni-estate
```

L'identificativo di flusso segue lo schema `ORGXXXX`, dove `ORG` è il prefisso univoco della tua organizzazione (lo stesso per tutti i tuoi flussi) e `XXXX` è l'identificativo individuale del flusso.

| Parametro         | Descrizione                                                                                                                              |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `ID flusso`       | Il codice univoco del flusso di conversazione PastaHR da avviare (per es. `TEST0001`).                                                   |
| `remote_job_id`   | L'identificativo della posizione nel tuo ATS.<br />È così che PastaHR trasferisce la candidatura completata alla posizione corretta.     |
| `remote_job_name` | Il nome visualizzato della posizione.                                                                                                    |
| `platform`        | Specifica il canale : `wa` per WhatsApp, `web` per la candidatura online, `insta` per Instagram.<br />Predefinito su WhatsApp se omesso. |
| `utm_source`      | La fonte del traffico (per es. `linkedin`, `facebook`, `email`).                                                                         |
| `utm_medium`      | Il canale marketing (per es. `social`, `cpc`, `newsletter`).                                                                             |
| `utm_campaign`    | Il nome della campagna (per es. `assunzioni-estate-2026`).                                                                               |
| `utm_content`     | Distingue gli annunci o i link all'interno della stessa campagna.                                                                        |
| `utm_term`        | Cattura la parola chiave che ha attivato l'annuncio.                                                                                     |

<Warning>
  **Con integrazione ATS** : se condividi un link di candidatura **senza** `remote_job_id`, PastaHR non può associare in modo affidabile la candidatura in arrivo a una posizione specifica nel tuo ATS.

  **Senza integrazione ATS** : senza `remote_job_name`, la candidatura non può essere filtrata per posizione nella panoramica delle candidature. Imposta quindi `remote_job_name` su ogni link.
</Warning>

## Generare un link di candidatura in PastaHR

Il Link Builder integrato di PastaHR si occupa di costruire l'URL, incluso l'identificativo di flusso corretto, il `remote_job_id` dal tuo ATS collegato ed eventuali parametri UTM.

<Steps>
  <Step title="Vai al Link Builder">
    <Tabs>
      <Tab title="Con integrazione ATS">
        Clicca su **Lavori** nella barra laterale sinistra, seleziona la posizione che vuoi condividere e clicca su **Crea link**. Il Link Builder si apre con l'ID posizione ATS e il nome della posizione già precompilati.
      </Tab>

      <Tab title="Senza integrazione ATS">
        Clicca direttamente su **Collegamenti** nella barra laterale sinistra, poi su **Crea link**.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Seleziona un flusso e confermare l'associazione alla posizione">
    Scegli il flusso di candidatura che vuoi usare.
  </Step>

  <Step title="Aggiungi parametri UTM (opzionale)">
    Compila i campi UTM per fonte, canale e campagna se vuoi monitorare la provenienza dei candidati. Vedi [Tracciamento UTM](/it/recruiters/utm-tracking) per maggiori informazioni.
  </Step>

  <Step title="Copia e distribuisci il link">
    Clicca su **Copia link**.
  </Step>
</Steps>

## Verificare che un link funzioni

Dopo aver generato un link, è utile testarlo prima di lanciare una campagna.

<Steps>
  <Step title="Apri il link in una finestra privata/di navigazione in incognito">
    Questo evita sessioni memorizzate nella cache che potrebbero interferire con il test.
  </Step>

  <Step title="Verifica che il flusso si avvii correttamente">
    Conferma che il titolo della posizione corretto e le domande giuste appaiano nella conversazione.
  </Step>

  <Step title="Controlla l'ATS dopo aver completato una candidatura di prova">
    Invia una candidatura di prova e verifica che appaia sotto la posizione corretta nel tuo ATS entro pochi minuti.
  </Step>
</Steps>

<Note>
  Se il link mostra un messaggio «posizione non attiva», verifica che la posizione sia pubblicata e attiva nel tuo ATS **e** che il `remote_job_id` nel link corrisponda esattamente all'ID della posizione nell'ATS. Vedi la [guida alla risoluzione dei problemi ATS](/it/recruiters/ats-troubleshooting) per maggiori dettagli su questo errore.
</Note>