Connettori

Un connettore collega le tue app a un servizio che hai già: Stripe per i pagamenti, OpenAI per l’IA, Resend per le e-mail, Google Sheets per i dati. Lo colleghi una volta, sul tuo account, e ogni app che scegli può usarlo. Ce ne sono più di sessanta, dai pagamenti e dai negozi ai CRM, ai calendari, all’IA e agli strumenti di design.

Ogni app ha già un database, un accesso e delle e-mail suoi, senza niente da collegare: è Cloud, in cima all’elenco, integrato e sempre attivo. I connettori servono per ciò che viene da fuori.

Dove trovarli

• Nella dashboard o nell’editor: +, poi Connectors, per scegliere quali può usare questa app.
• Manage connectors, in fondo a quella finestra, apre la pagina Connectors vera e propria, dove si collegano i servizi. Si apre sopra l’editor o la dashboard, così non perdi il punto in cui eri.
• Nella pagina Connectors, l’elenco a sinistra filtra le schede per All, Enabled, Custom connectors, MCP servers e per tipo di servizio, e la casella di ricerca trova un servizio per nome.
• + in alto a destra ne aggiunge uno che non è nell’elenco: descrivilo tu con Custom connector, oppure chiedilo a noi con Request a connector. C’è anche MCP server, per l’IA che crea le tue app e non per le app.
• Nell’editor, Manage, poi Integrations, mostra cosa può usare questa app. Vedi Integrazioni.

Collega un servizio

Apri il servizio nella pagina Connectors. Ognuno dice cosa può farci la tua app, cosa non fa dove conta, e quanto lo hanno usato le tue app negli ultimi 30 giorni. Ci sono due modi per entrare: accedere al servizio oppure incollare le chiavi che ti dà. La pagina Connectors mostra quello che ha ogni servizio. Alcuni li hanno entrambi, e allora la pagina dice Sign in with the service, or add your own keys instead.

Con un pulsante. Stripe, Notion, Google Sheets, Airtable, Slack, Discord, Calendly, Google Calendar, Microsoft 365, HubSpot, Pipedrive, Zoho CRM, Zoho Books, Salesforce, Linear, Asana, Atlassian (Jira e Confluence), Figma, Canva, GitHub e GitLab si collegano accedendo al servizio e tornando indietro. Non vedi né copi mai una chiave. Per Stripe il pulsante è Set up Stripe: vedi Negozi online. Salesforce chiede al tuo admin di installare una volta il pacchetto di Setherion prima del primo accesso.

Con le chiavi. Per gli altri, incolla le chiavi che il servizio ti dà sotto Credentials. Where do I find these? apre la pagina giusta del servizio, e ogni casella ha un suggerimento che dice esattamente quale chiave vuole. Test connection le prova prima che ci faccia affidamento, e Connect le conserva. Una volta collegato, Update le cambia e Remove le toglie. Se Connect è grigio, una casella è vuota o non hai ancora spuntato la riga che dice che hai capito i termini del servizio: Take me there ti porta lì.

Un servizio collegato mostra un puntino verde sulla sua scheda, e Enabled accanto al suo nome. Prima del primo collegamento, ogni servizio dice in parole semplici cosa significa per te, e tu spunti di aver capito. Un badge lo riassume: Billed by il servizio quando ti addebita l’uso, per esempio Billed by Supabase, Handles real money per pagamenti e negozi, e No usage charges per tutti gli altri.

Il passo successivo dopo Connect

Subito dopo aver collegato un servizio nella sua pagina, una scheda dice Stripe is connected. Next: use it in this app, oppure build an app with it quando arrivi dalla dashboard. Il suo pulsante, Use in this app o Build an app with it, scrive per te nella chat una richiesta iniziale, come “Use Stripe in this app: online payments, subscriptions and invoices”, e mette il servizio nell’elenco dell’app. La richiesta aspetta nella casella del messaggio. Non viene creato né speso nulla finché non premi Send. Puoi chiudere la scheda, e non torna nelle visite successive. I servizi di design e di codice, come Figma e GitHub, non hanno una scheda così, perché vengono letti mentre un’app viene creata e non usati da essa.

Cosa non fa un servizio

Dove un servizio ha un limite evidente, la sua pagina lo dice in una nota grigia, con un pulsante verso i connettori che fanno invece quel lavoro. PayPal è l’esempio: ogni pulsante compra un solo articolo, non c’è un carrello e la tua app non viene avvisata quando qualcuno paga, quindi la nota rimanda a Stripe e Paddle.

Scegli quali app lo usano

Collegare un servizio non lo mette in ogni app. Nell’app, apri +, poi Connectors, spunta quelli che questa app può usare e premi Done. Tutto ciò che lasci fuori resta fuori dal codice e dalle chiavi dell’app. Un servizio non ancora collegato ha accanto Connect, che ti porta alla sua pagina.

Poi chiedi nella chat cosa deve fare:

Non devi spuntare prima. Se il tuo messaggio nomina un servizio che l’app non può ancora raggiungere, una barra sopra la casella del messaggio dice This needs Stripe e offre tre risposte: Use it here quando è già collegato, Connect con una chiave o con l’accesso del servizio stesso, proprio lì, oppure Build without it. Senza, l’app dice che la funzione non è configurata invece di fingere che funzioni.

Permissions

Alcuni servizi elencano cosa possono farci le tue app, sotto Permissions nella loro pagina una volta collegati. Ogni riga ha due pulsanti: la spunta lo consente, il cerchio barrato lo disattiva.

• Una modifica viene salvata appena la premi, e vale subito per ogni app che usa la connessione, comprese quelle pubblicate.
• Un’app che prova qualcosa di disattivato riceve un errore che lo dice, e dove riattivarlo. Le nuove creazioni lo sanno e lo escludono.
• Il servizio concede comunque alla tua chiave o al tuo accesso tutto ciò che gli è stato dato. Questi limiti sono di Setherion, tenuti sopra a quelli.
• Rimuovere la connessione riattiva tutto.

Shopify è diverso. Le tue app lo chiamano direttamente dalla pagina con il suo Storefront token, pubblico per natura, quindi i suoi limiti si impostano in Shopify: apri Sales channels, poi Headless, poi la tua vetrina, premi Manage accanto a Storefront API e modifica Permissions. La sua pagina su Setherion mostra gli stessi passaggi.

Lo stesso vale per Supabase, Firebase, Google Maps e Cloudinary: le tue app li chiamano direttamente dalla pagina, quindi i loro limiti si impostano in ciascun servizio, e la loro pagina su Setherion dice dove.

Ogni altro servizio dice in una frase, sotto Permissions, tutto ciò che le tue app possono fare con esso, per esempio solo inviare email o solo leggere i tuoi prodotti. Canva, Figma, GitHub e GitLab dicono che le tue app non li usano mai: solo tu, dall’editor.

HubSpot

HubSpot porta il tuo CRM nelle tue app: contatti, aziende, trattative e ticket. Ci sono due modi per collegarlo.

• Connect with HubSpot: accedi a HubSpot, scegli l’account e approva. Finché HubSpot non ha finito di esaminare Setherion, la sua schermata avverte che l’app non è ancora verificata e ti chiede di scrivere “I accept the risk” per proseguire.
• Una service key: in HubSpot, apri Development, poi Keys, poi Service keys, e creane una con lettura e scrittura per contatti, aziende, trattative e ticket. Incollala sotto Credentials. Le chiavi di HubSpot iniziano con pat-.

Chi può usarlo in un’app pubblicata:

• Chiunque: un modulo sul tuo sito può aggiungere un contatto o un ticket.
• Solo il tuo team: leggere il CRM e cambiarne qualsiasi cosa. Segna gli account che sono il tuo team in Manage, poi Cloud, poi Users. Vedi Lavorare in team.

Per impedire alle app di cambiare le tue trattative pur continuando a leggerle, disattiva Change per le trattative in Permissions.

Il tuo Supabase

Supabase è facoltativo: ogni app ha già un backend. Collegalo quando vuoi i dati di un’app in un progetto Supabase tutto tuo.

• Credentials: l’indirizzo del progetto e la sua anon key, pubblica per natura. La service role key è facoltativa.
• Connect Supabase account, sotto Creating the tables, permette a Setherion di creare nel tuo progetto le tabelle che serve a un’app, da Manage, poi Cloud, ogni volta che premi il pulsante lì. Accedi a Supabase e approvi. Il permesso resta sui server di Setherion e non viene mai consegnato alle app che pubblichi. Senza, le tabelle sono comunque lì da copiare e incollare in Supabase da solo.

Per spostare un’app che ha già dei dati sul tuo Supabase, vedi Impostazioni avanzate.

Cosa c’è

Ogni connettore, raggruppato come le pagine che lo descrivono. Ogni pagina ha un menu a tendina per servizio: a cosa serve, quali chiavi vuole e dove trovarle, cosa chiedere, i suoi interruttori e i suoi limiti.

Per un servizio che non è nell’elenco, descrivilo tu: vedi Connettori personalizzati. Per una singola chiave che serve a una sola app, bastano Chiavi e segreti.

Chi può usare una connessione

Le tue chiavi non raggiungono mai un visitatore, quindi un’app pubblicata chiama un servizio tramite Setherion, e Setherion decide cosa è consentito.

• Solo i percorsi che un’app richiede. Un’app che invia e-mail può inviare, e non può raggiungere il tuo account, le tue chiavi o i tuoi domini. Una vetrina legge i prodotti e non può leggere ordini o clienti.
• Il mittente e l’account sono fissi. Un’app non può scegliere un indirizzo From, un numero di telefono, un calendario o una lista diversi da quello che hai salvato.
• Il tuo team e i tuoi visitatori sono diversi. Per un CRM, il modulo di un visitatore può lasciare un lead e solo il tuo team può leggere o cambiare qualsiasi cosa. Segna il tuo team in Manage, poi Cloud, poi Users. La pagina di ogni connettore dice quali sue azioni sono pubbliche.
• Tutto ciò che raggiunge una persona o costa denaro ha un limite di frequenza. E-mail, SMS, messaggi di chat, iscrizioni e pagamenti sono limitati a circa dieci chiamate all’ora per ogni visitatore. Le letture dei tuoi dati ne consentono molte di più. Un’app che supera il limite riceve l’invito a riprovare più tardi.
• Un fusibile giornaliero e uno mensile. Un’app può fare qualche migliaio di chiamate ai servizi al giorno, e le chiamate di un’app pubblicata usano crediti di integrazione.

In uno spazio di lavoro di team

Con il piano Business, Settings, poi Connector settings, offre a uno spazio di lavoro di team due scelte. Solo il proprietario o un admin può cambiare la prima, e solo il proprietario può prestare.

• Quali connettori possono usare le app dello spazio di lavoro. Un connettore non consentito viene escluso da ogni creazione, non mette nessuna chiave in un’app pubblicata, e ogni chiamata verso di esso viene rifiutata.
• Prestare le connessioni del proprietario. L’app di un membro può usare la connessione del proprietario a un servizio che il membro non ha collegato di persona. Le chiavi restano sui nostri server e non raggiungono mai il membro. Il fornitore addebita quelle chiamate all’account del proprietario, e contano sui crediti di integrazione di chi ha creato l’app.

Pagamenti, negozi e database non vengono mai prestati: i loro account, i loro incassi e i loro dati appartengono a chi li ha collegati. Vedi Spazi di lavoro.

Connettori personalizzati e server MCP

Per un servizio che non è nell’elenco, descrivilo tu: vedi Connettori personalizzati. Per dare all’IA che crea le tue app i suoi strumenti, aggiungi un server MCP.

Da sapere

• Una chiamata che un’app pubblicata fa a un servizio collegato usa un credito di integrazione. Vedi Crediti. Quanto ha speso ogni app lo vedi in Consumo.
• I servizi che ti addebitano l’uso, come Resend, Twilio o OpenAI, addebitano il tuo account, ai loro prezzi. Imposta lì un limite di spesa: Setherion limita la velocità con cui un’app può chiamare, il che ferma gli abusi, ma non può mettere un tetto a ciò che spendi.
• Quando un’app chiama un servizio non collegato, Manage, poi Integrations, lo dice, con Add the key.
• Scollegare un servizio impedisce subito a ogni app che lo usa di raggiungerlo.