Cosa configurerai
- Un piano per collegare oggi Elido al tuo strumento di PM tramite un endpoint webhook generico, con uno strumento di automazione nel mezzo.
- Il token di autenticazione giusto per ogni strumento: Personal Access Token (Asana, Monday), token API + List ID (ClickUp) o chiave API + token + ID di board/lista (Trello).
- Quali eventi di Elido possono alimentare le attività oggi: link non funzionanti, link scaduti, limiti di clic raggiunti, errori di dominio e limiti di utilizzo.
Ogni strumento di PM funzionerà secondo lo stesso principio: Elido emette un evento in uscita e nel progetto scelto viene creata un'attività, una scheda o un elemento. Oggi puoi costruirlo da solo: aggiungi un endpoint per gli eventi in Settings → Webhooks e usa questi eventi: link.broken, link.expired, link.cap_reached, domain.ssl_failed, usage.threshold_80, usage.threshold_100. Consulta la guida ai webhook e la guida a n8n.
Confronto rapido
| Strumento | Autenticazione | Stato | Ideale per |
|---|---|---|---|
| Asana | Personal Access Token | Pianificato | Team che gestiscono già le campagne in Asana Projects |
| ClickUp | Token API + List ID | Pianificato | Team nativi ClickUp che usano le automazioni |
| Trello | Chiave API + token + ID board/lista | Pianificato | Semplici board kanban con il minimo di formalità |
| Monday.com | Token API personale | Pianificato | Board visuali con tracciamento dello stato a livello di elemento |
Asana
Ottieni un Personal Access Token:
- Asana → My Settings → Apps → Manage Developer Apps → Create New Personal Access Token.
- Chiamalo "Elido" e copia il token.
Configurazione in Elido (pianificata):
- Pianificato: Dashboard → Webhooks → Add Asana (non ancora disponibile).
- Incolla il token. Fai clic su Fetch projects: Elido elenca tutti i progetti visibili al tuo account.
- Scegli il progetto di destinazione e, facoltativamente, l'assegnatario.
- Scegli gli eventi. Pianificato: un evento di link non funzionante apre un'attività "Investigate broken link".
L'API di Asana usa tasks:write e projects:read: li vedrai elencati nella schermata degli scope del token.
ClickUp
Ottieni un token API:
- ClickUp → Settings → Apps → API Token → Generate.
Trova il tuo List ID:
Ti serve la lista in cui devono arrivare le attività. Il modo più semplice: apri la lista in ClickUp. L'URL contiene l'ID della lista, ad esempio https://app.clickup.com/1234/v/li/987654: il numero dopo /li/ è il List ID. In alternativa, chiama GET https://api.clickup.com/api/v2/team con il tuo token ed esplora spazi → cartelle → liste.
Configurazione in Elido (pianificata):
- Pianificato: Dashboard → Webhooks → Add ClickUp (non ancora disponibile).
- Incolla il token API e il List ID.
- Seleziona gli eventi e salva.
Trello
Trello usa un flusso in due passaggi con chiave + token.
Passaggio 1 - Chiave API:
Vai su https://trello.com/power-ups/admin → New → chiamalo "Elido" → copia la chiave API.
Passaggio 2 - Token:
Visita questo URL (sostituisci KEY con la tua chiave):
https://trello.com/1/authorize?key=KEY&name=Elido&expiration=never&scope=read,write&response_type=token
Trello mostra un token a schermo. Copialo.
Passaggio 3 - ID di board e lista:
Apri la board Trello di destinazione. Aggiungi .json all'URL:
https://trello.com/b/XXXX/your-board.json
Trova la lista che ti interessa sotto la chiave lists e copia il suo id.
Configurazione in Elido (pianificata):
- Pianificato: Dashboard → Webhooks → Add Trello (non ancora disponibile).
- Incolla la chiave API, il token e l'ID della lista.
- Seleziona gli eventi e salva.
Monday.com
Ottieni un token API personale:
- Monday → fai clic sul tuo avatar → Developers → My Access Tokens.
- Copia il token.
Trova l'ID della tua board:
Apri la board di destinazione. L'URL è https://monday.com/boards/1234567890: il numero è l'ID della board. Copialo.
Configurazione in Elido (pianificata):
- Pianificato: Dashboard → Webhooks → Add Monday (non ancora disponibile).
- Incolla il token API e l'ID della board.
- Seleziona gli eventi e salva. Ogni evento crea un nuovo elemento nel primo gruppo della board.
Risoluzione dei problemi
Asana - "Not a member of that project" - Il PAT appartiene a un utente che non ha accesso al progetto selezionato. Aggiungi l'utente al progetto in Asana oppure usa un PAT diverso.
ClickUp - attività create nella lista sbagliata - Verifica il List ID. È facile confonderlo con un Space ID o un Folder ID. Usa il metodo dell'URL descritto sopra per confermarlo.
Trello - token scaduto - I token creati con expiration=never scadono comunque se Trello rileva problemi di sicurezza. Riesegui l'URL di autorizzazione per ottenere un token nuovo.
Monday.com - "Error 200: invalid column value" - La board ha colonne obbligatorie senza valore predefinito. Compilale da Monday oppure scegli un altro gruppo o un'altra board che abbia valori predefiniti per tutte le colonne obbligatorie.