Conectori

Un conector leagă aplicațiile tale de un serviciu pe care îl ai deja: Stripe pentru plăți, OpenAI pentru AI, Resend pentru e-mail, Google Sheets pentru date. Îl conectezi o singură dată, în contul tău, și fiecare aplicație pe care o alegi îl poate folosi. Sunt peste șaizeci, de la plăți și magazine până la CRM-uri, calendare, AI și unelte de design.

Fiecare aplicație are deja o bază de date, autentificare și e-mailuri proprii, fără nimic de conectat: asta este Cloud, în fruntea listei, încorporat și mereu pornit. Conectorii sunt pentru ce vine din afară.

Unde îi găsești

• În panoul de control sau în editor: +, apoi Connectors, ca să alegi pe care îi poate folosi această aplicație.
• Manage connectors, la baza ferestrei aceleia, deschide chiar pagina Connectors, unde se conectează serviciile. Se deschide peste editor sau peste panoul de control, așa că îți păstrezi locul.
• Pe pagina Connectors, lista din stânga filtrează plăcile după All, Enabled, Custom connectors, MCP servers și după felul de serviciu, iar caseta de căutare găsește un serviciu după nume.
• + din dreapta sus adaugă unul care nu este în listă: descrie-l tu cu Custom connector sau cere-ne-l cu Request a connector. Acolo este și MCP server, pentru AI-ul care îți construiește aplicațiile, nu pentru aplicații.
• În editor, Manage, apoi Integrations, arată ce poate folosi această aplicație. Vezi Integrări.

Conectează un serviciu

Deschide serviciul pe pagina Connectors. Fiecare spune ce poate face aplicația ta cu el, ce nu face acolo unde contează, și cât l-au folosit aplicațiile tale în ultimele 30 de zile. Sunt două feluri de a intra: te autentifici în serviciu sau lipești cheile pe care ți le dă. Pagina Connectors îl arată pe cel pe care îl are fiecare serviciu. Unele le au pe amândouă, și atunci pagina spune Sign in with the service, or add your own keys instead.

Cu un buton. Stripe, Notion, Google Sheets, Airtable, Slack, Discord, Calendly, Google Calendar, Microsoft 365, HubSpot, Pipedrive, Zoho CRM, Zoho Books, Salesforce, Linear, Asana, Atlassian (Jira și Confluence), Figma, Canva, GitHub și GitLab se conectează autentificându-te în serviciu și întorcându-te. Nu vezi și nu copiezi niciodată o cheie. Pentru Stripe butonul este Set up Stripe: vezi Magazine online. Salesforce cere administratorului tău să instaleze o dată pachetul Setherion înainte de prima autentificare.

Cu chei. Pentru celelalte, lipește cheile pe care ți le dă serviciul sub Credentials. Where do I find these? deschide pagina potrivită a serviciului, iar fiecare casetă are un indiciu care spune exact ce cheie vrea. Test connection le încearcă înainte să te bazezi pe ele, iar Connect le păstrează. După ce este conectat, Update le schimbă și Remove le scoate. Dacă Connect este gri, o casetă este goală sau nu ai bifat încă rândul care spune că ai înțeles termenii serviciului: Take me there sare la el.

Un serviciu conectat arată un punct verde pe placa lui și Enabled lângă nume. Înainte de prima conectare, fiecare serviciu spune pe înțelesul tuturor ce înseamnă pentru tine, iar tu bifezi că ai înțeles. O insignă rezumă: Billed by serviciul când te taxează pentru folosire, de exemplu Billed by Supabase, Handles real money pentru plăți și magazine, și No usage charges pentru restul.

Pasul următor după Connect

Imediat după ce conectezi un serviciu pe pagina lui, un card spune Stripe is connected. Next: use it in this app, sau build an app with it când ai venit din panoul de control. Butonul lui, Use in this app sau Build an app with it, scrie pentru tine o cerere de pornire în chat, ca „Use Stripe in this app: online payments, subscriptions and invoices", și pune serviciul pe lista aplicației. Cererea așteaptă în caseta de mesaj. Nu se construiește și nu se consumă nimic până nu apeși Send. Poți închide cardul, iar el nu mai revine la vizitele următoare. Serviciile de design și de cod, ca Figma și GitHub, nu au un asemenea card, pentru că sunt citite cât timp se construiește o aplicație, nu folosite de ea.

Ce nu face un serviciu

Unde un serviciu are o limită evidentă, pagina lui o spune într-o notă gri, cu un buton spre conectorii care fac treaba în schimb. PayPal este exemplul: fiecare buton cumpără un singur articol, nu există coș, iar aplicația ta nu este înștiințată când plătește cineva, așa că nota trimite spre Stripe și Paddle.

Alege ce aplicații îl folosesc

Conectarea unui serviciu nu îl pune în fiecare aplicație. În aplicație, deschide +, apoi Connectors, bifează-i pe cei pe care îi poate folosi această aplicație și apasă Done. Tot ce lași nebifat rămâne în afara codului aplicației și a cheilor ei. Un serviciu care nu este încă conectat are lângă el Connect, care te duce la pagina lui.

Apoi cere în chat ce ar trebui să facă:

Nu trebuie să bifezi întâi. Dacă mesajul tău numește un serviciu pe care aplicația nu îl poate încă atinge, o bară deasupra casetei de mesaj spune This needs Stripe și oferă trei răspunsuri: Use it here când este deja conectat, Connect cu o cheie sau cu autentificarea proprie a serviciului, chiar acolo, sau Build without it. Fără el, aplicația spune că funcția nu este configurată, în loc să se prefacă că merge.

Permisiuni

Unele servicii listează ce pot face aplicațiile tale cu ele, sub Permissions pe pagina lor, după ce sunt conectate. Fiecare rând are două butoane: bifa îl permite, cercul tăiat îl oprește.

• O schimbare se salvează în clipa în care o apeși și se aplică imediat fiecărei aplicații care folosește conexiunea, inclusiv celor publicate.
• O aplicație care încearcă ceva oprit primește o eroare care spune asta și unde se poate porni la loc. Construirile noi sunt înștiințate și lasă lucrul acela deoparte.
• Serviciul îți acordă în continuare cheii sau autentificării tale tot ce i-a fost dat. Aceste limite sunt ale Setherion, ținute peste ele.
• Scoaterea conexiunii pornește la loc totul.

Shopify este diferit. Aplicațiile tale îl apelează direct din pagină cu tokenul lui Storefront, care este public prin construcție, așa că limitele lui se setează în Shopify: deschide Sales channels, apoi Headless, apoi vitrina ta, apasă Manage lângă Storefront API și modifică Permissions. Pagina lui din Setherion arată aceiași pași.

La fel e cu Supabase, Firebase, Google Maps și Cloudinary: aplicațiile tale le apelează direct din pagină, așa că limitele lor se setează în fiecare serviciu, iar pagina lor din Setherion spune unde.

Orice alt serviciu spune într-o propoziție, sub Permissions, tot ce pot face aplicațiile tale cu el, de exemplu doar să trimită emailuri sau doar să citească produsele tale. Canva, Figma, GitHub și GitLab spun că aplicațiile tale nu le folosesc niciodată: doar tu, din editor.

HubSpot

HubSpot îți aduce CRM-ul în aplicații: contacte, companii, tranzacții și tichete. Există două feluri de a-l conecta.

• Connect with HubSpot: autentifică-te la HubSpot, alege contul și aprobă. Până când HubSpot termină de verificat Setherion, ecranul lui avertizează că aplicația nu este încă verificată și îți cere să scrii „I accept the risk" ca să continui.
• A service key: în HubSpot, deschide Development, apoi Keys, apoi Service keys, și creează una cu citire și scriere pentru contacte, companii, tranzacții și tichete. Lipește-o sub Credentials. Cheile HubSpot încep cu pat-.

Cine îl poate folosi într-o aplicație publicată:

• Oricine: un formular de pe site-ul tău poate adăuga un contact sau un tichet.
• Doar echipa ta: citirea CRM-ului și schimbarea oricărui lucru din el. Marchează conturile care sunt ale echipei tale în Manage, apoi Cloud, apoi Users. Vezi Lucrul în echipă.

Ca să oprești aplicațiile să-ți schimbe tranzacțiile cât timp încă le citesc, oprește Change pentru tranzacții sub Permisiuni.

Propriul tău Supabase

Supabase este opțional: fiecare aplicație are deja un backend. Conectează-l când vrei datele unei aplicații într-un proiect Supabase al tău.

• Credentials: adresa proiectului și cheia lui anon, care este publică prin construcție. Cheia service role este opțională.
• Connect Supabase account, sub Creating the tables, îi lasă lui Setherion să creeze în proiectul tău tabelele de care are nevoie o aplicație, din Manage, apoi Cloud, de fiecare dată când apeși acolo butonul. Te autentifici la Supabase și aprobi. Permisiunea rămâne pe serverele Setherion și nu este dată niciodată aplicațiilor pe care le publici. Fără ea, tabelele sunt tot acolo, ca să le copiezi și să le lipești singur în Supabase.

Ca să muți în propriul tău Supabase o aplicație care are deja date, vezi Setări avansate.

Ce există

Fiecare conector, grupat așa cum sunt grupate paginile care îi descriu. Fiecare pagină are câte o listă derulantă pentru fiecare serviciu: la ce folosește, ce chei vrea și unde le găsești, ce să ceri, comutatoarele lui și limitele lui.

Pentru un serviciu care nu este în listă, descrie-l tu: vezi Conectori proprii. Pentru o singură cheie de care are nevoie o aplicație, Chei și secrete este de ajuns.

Cine poate folosi o conexiune

Cheile tale nu ajung niciodată la un vizitator, așa că o aplicație publicată apelează un serviciu prin Setherion, iar Setherion hotărăște ce este permis.

• Doar căile de care are nevoie o aplicație. O aplicație care trimite e-mail poate trimite, dar nu poate ajunge la contul tău, la cheile tale sau la domeniile tale. O vitrină de magazin citește produsele și nu poate citi comenzile sau clienții.
• Expeditorul și contul sunt fixe. O aplicație nu poate alege o altă adresă From, un alt număr de telefon, calendar sau listă decât cea pe care ai salvat-o tu.
• Echipa ta și vizitatorii tăi sunt diferiți. Pentru un CRM, formularul unui vizitator poate lăsa un lead, iar doar echipa ta poate citi sau schimba orice. Marchează-ți echipa în Manage, apoi Cloud, apoi Users. Pagina fiecărui conector spune care dintre acțiunile lui sunt publice.
• Tot ce ajunge la o persoană sau costă bani are o limită de frecvență. E-mailurile, SMS-urile, mesajele de chat, înscrierile și plățile sunt limitate la cam zece apeluri pe oră pentru fiecare vizitator. Citirile propriilor tale date permit mult mai multe. O aplicație care depășește este rugată să încerce mai târziu.
• O siguranță zilnică și una lunară. O aplicație poate face câteva mii de apeluri pe zi către servicii, iar apelurile unei aplicații publicate consumă credite pentru integrări.

Într-un spațiu de lucru de echipă

Pe Business, Settings, apoi Connector settings, dă unui spațiu de lucru de echipă două alegeri. Doar proprietarul sau un administrator o poate schimba pe prima, iar doar proprietarul poate împrumuta.

• Ce conectori pot folosi aplicațiile spațiului de lucru. Un conector care nu este permis este lăsat în afara oricărei construiri, nu pune nicio cheie într-o aplicație publicată, iar fiecare apel către el este refuzat.
• Împrumutarea conexiunilor proprietarului. Aplicația unui membru poate folosi conexiunea proprietarului la un serviciu pe care membrul nu l-a conectat el însuși. Cheile rămân pe serverele noastre și nu ajung niciodată la membru. Furnizorul taxează contul proprietarului pentru acele apeluri, iar ele se scad din creditele pentru integrări ale creatorului.

Plățile, magazinele și bazele de date nu sunt împrumutate niciodată: conturile, încasările și datele lor aparțin celui care le-a conectat. Vezi Spații de lucru.

Conectori proprii și servere MCP

Pentru un serviciu care nu este în listă, descrie-l tu: vezi Conectori proprii. Ca să dai AI-ului care îți construiește aplicațiile propriile unelte, adaugă un server MCP.

Bine de știut

• Un apel pe care o aplicație publicată îl face către un serviciu conectat consumă un credit de integrare. Vezi Credite. Vezi cât a consumat fiecare aplicație sub Consum.
• Serviciile care te taxează pentru folosire, ca Resend, Twilio sau OpenAI, taxează propriul tău cont, la prețurile lor. Setează acolo o limită de cheltuială: Setherion limitează cât de repede poate apela o aplicație, ceea ce oprește abuzul, dar nu poate plafona ce cheltuiești.
• Când o aplicație apelează un serviciu care nu este conectat, Manage, apoi Integrations, spune asta, cu Add the key.
• Deconectarea unui serviciu oprește imediat orice aplicație care îl folosește să mai ajungă la el.