Cosa configurerai
- Una chiave API personale Linear collegata a Elido — senza OAuth, senza registrazione di app.
- Issue Linear create automaticamente quando un link tracciato supera una soglia di clic o una scansione URL fallisce.
- Assegnatario e label predefiniti opzionali applicati a ogni issue creata automaticamente.
In arrivo nel Q3 2026. Registrati per l'accesso anticipato in Dashboard → Integrazioni → Linear → Avvisami. La configurazione di seguito riflette il design pianificato.
L'integrazione Linear apre automaticamente issue su eventi specifici di Elido. Utile per i team che tracciano errori delle campagne e avvisi di scansione dei link come lavoro di primo livello. Sono supportati due eventi: soglia superata (un link raggiunge N clic — spesso un segnale per aumentare la promozione o scalare l'infrastruttura) e scansione fallita (un URL di destinazione è stato segnalato come malevolo).
Cosa ti serve#
- Un account Linear con l'autorizzazione a creare issue nel team di destinazione.
- Una chiave API personale Linear (richiede 30 secondi per generarla).
Genera una chiave API Linear#
- Vai su Linear → Settings → API → Personal API keys.
- Fai clic su Create key. Dagli un'etichetta come "Integrazione Elido".
- Copia la chiave. Linear la mostra solo una volta.
Configura in Elido#
- Vai su Dashboard → Integrazioni → Linear → Configura.
- Incolla la chiave API.
- Fai clic su Recupera team. Elido chiama l'API Linear ed elenca ogni team a cui la tua chiave ha accesso.
- Seleziona il team di destinazione. Le issue verranno create lì.
- (Opzionale) Imposta un assegnatario predefinito e un'etichetta. Entrambi vengono passati all'issue Linear.
- Fai clic su Salva.
Configura i trigger degli eventi#
In Dashboard → Integrazioni → Linear → Trigger:
- Soglia superata — Inserisci un conteggio di clic. Quando un link tracciato lo supera, Elido apre una issue Linear con il titolo "Milestone campagna: [slug] ha raggiunto [N] clic". Puoi impostare soglie diverse per ogni link.
- Scansione fallita — Attiva. Ogni link segnalato apre una issue con il titolo "Indaga segnalazione di scansione: [slug]" con il motivo dello scanner nella descrizione.
Cosa viene scritto su Linear#
Ogni issue creata automaticamente include:
- Titolo come descritto sopra.
- Descrizione con l'URL abbreviato, l'URL di destinazione e i dettagli dell'evento.
- Link diretto alla vista analisi Elido per il link.
- Assegnatario ed etichetta se configurati.
Elido non legge da Linear — non chiuderà le issue né traccerà lo stato delle issue. Questa parte dipende dal flusso di lavoro del tuo team.
Risoluzione dei problemi#
"Not authorized" durante il recupero dei team — La chiave API è errata o è stata revocata. Rigenerala da Linear Settings → API.
Issue che appaiono nel team sbagliato — Verifica la selezione del team in Dashboard → Integrazioni → Linear → Configura. Se una chiave ha accesso a più team, il selettore potrebbe aver puntato al primo.
Nessuna issue creata al superamento della soglia — Verifica che il link abbia una soglia impostata. Il trigger globale si attiva solo per i link dove è definita una soglia per link o è attivo il default globale.
Issue duplicate — Il trigger della soglia si attiva una volta per ogni superamento, non per ogni clic. Se vedi duplicati, controlla che lo stesso workspace Linear non sia connesso sotto due workspace Elido.