Cos'e'
Questa guida spiega come collegare servizi esterni al workspace tramite i connettori disponibili in Xevora.
Quando usarla
Usa questa guida quando vuoi:
- collegare un servizio esterno al tuo workspace
- configurare un provider supportato
- testare la connessione
- rimuovere o aggiornare un'integrazione esistente
- capire dove guardare quando una connessione non funziona
Tipi di integrazioni disponibili
In base al provider, Xevora puo' gestire integrazioni legate a:
- ecommerce
- pagamenti
- sviluppo e repository
- messaggistica
- automazioni
- webhook personalizzati
Tra gli esempi visibili in piattaforma rientrano servizi come Shopify, Stripe, PayPal, GitHub, GitLab, Telegram, n8n, Zapier, Make e Webhook.
Prima di iniziare
Prima di configurare un connettore prepara:
- il workspace corretto
- le credenziali o le informazioni richieste dal servizio esterno
- una persona responsabile del collegamento
- un test semplice per verificare il risultato finale
Come configurare un connettore
1. Apri la sezione Connettori
Dal workspace vai nelle impostazioni e apri l'area dedicata ai connettori. Qui trovi sia quelli gia' installati sia quelli ancora disponibili.
2. Scegli il provider giusto
Prima di installare chiediti cosa deve fare l'integrazione. Per esempio:
- gestire pagamenti
- collegare codice o repository
- inviare dati verso automazioni
- attivare scambi con servizi esterni
3. Inserisci la configurazione richiesta
Ogni provider richiede dati specifici. La procedura migliore e' sempre questa:
- compila solo i campi richiesti
- usa un'etichetta riconoscibile se il servizio verra' usato da piu' persone
- salva e passa subito al test
4. Esegui il test di connessione
Dopo l'installazione usa la funzione di test. Questo passaggio e' fondamentale per verificare che il collegamento sia effettivamente valido e pronto all'uso.
5. Controlla stato e log
Se qualcosa non funziona, parti sempre dallo stato del connettore e dagli eventuali log o esiti disponibili nell'interfaccia. Ti aiutano a capire se il problema e' di configurazione, credenziali o collegamento esterno.
Esempio pratico
Immagina di voler collegare un sistema di automazione al tuo workspace.
Il flusso corretto potrebbe essere:
- apri Connettori
- selezioni il provider di automazione desiderato
- inserisci i dati richiesti
- salvi con un'etichetta chiara, per esempio Automazione lead sito
- esegui il test di connessione
- controlli che lo stato risulti coerente con il risultato atteso
Note utili
- Mantieni pochi connettori ma ben configurati.
- Usa etichette chiare quando colleghi piu' servizi simili.
- Se una connessione e' critica per il progetto, verifica periodicamente il suo stato.
Problemi comuni
Il test non va a buon fine
Controlla prima i dati inseriti. Molti errori dipendono da campi incompleti o non aggiornati.
Non ricordo piu' a cosa serve un connettore gia' installato
Usa etichette descrittive fin dall'inizio. Aiuta molto quando il workspace cresce.
Voglio rimuovere un connettore
Prima di eliminarlo verifica se il progetto o il team stanno ancora facendo affidamento su quel collegamento.