Connectors

Anslut din app till tredjepartstjänster som Slack, Resend och ElevenLabs. Uppgifter krypteras och åtgärder är förautentiserade.

Connectors låter dig integrera externa tjänster i din app utan att hantera råa API-nycklar i koden. Du konfigurerar en anslutning en gång, binder den till ditt projekt och anropar färdigbyggda åtgärder från din app. Uppgifter krypteras i vila och exponeras aldrig för din frontend-kod.

Tillgängliga connectors

Connector	Kategori	Autentiseringstyp	Vad den gör
Resend	Kommunikation	API-nyckel	Skicka transaktionell e-post, skicka batch-e-post, lista verifierade domäner
Slack	Kommunikation	OAuth	Posta meddelanden, lista kanaler och användare, reagera på meddelanden, läsa trådar
ElevenLabs	AI	API-nyckel	Text-till-tal, lista tillgängliga röster, generera ljudeffekter

Fler connectors läggs till löpande.

Hur connectors fungerar

1. Du skapar en anslutning — ange uppgifter (en API-nyckel eller logga in via OAuth)
2. Du binder anslutningen till ett projekt — detta ger projektet behörighet att använda dessa uppgifter
3. Din app anropar åtgärder — begäran går via Proyecta Cloud, som injicerar uppgifterna på serversidan

Din appkod rör aldrig den råa API-nyckeln eller OAuth-token. Connector-systemet hanterar autentisering, rate limiting och revisionsloggning.

Konfigurera en connector

1. Öppna ditt projekt i Builder
2. Gå till Settings > Connectors
3. Klicka på en connector i katalogen (t.ex. Resend)
4. Ange dina uppgifter:
   • API-nyckel-connectors (Resend, ElevenLabs): Klistra in din hemliga nyckel
   • OAuth-connectors (Slack): Logga in och auktorisera åtkomst
5. Ge anslutningen ett namn (t.ex. “Production Resend”)
6. Anslutningen testas automatiskt och markeras som Active om den är giltig

Läs via en connector från din app

Din app kan läsa ett tredjeparts-API direkt från webbläsaren utan att API-nyckeln någonsin hamnar i bundlen. Uppgiften stannar krypterad på plattformen; din app anger bara connectorn, åtgärden och en typad indata, och plattformen gör anropet åt dig.

import { useConnectorData, useHttpRead } from '@/hooks/useConnector.ts';

// A connector's own read action, as a cached query
const { data, isLoading, error } = useConnectorData('eleven-labs', 'listVoices');

// The generic HTTP-read connector, by endpoint name
const { data: feed } = useHttpRead('news-feed', { limit: 10 });

Två skyddsräcken är värda att känna till, eftersom de är medvetna:

• Endast läsning. Bara åtgärder som plattformen har markerat som säkra för webbläsaren är nåbara — allt annat ger 403. Skrivningar (posta till Slack, skicka mejl, debitera ett kort) är aldrig nåbara från webbläsaren.
• Du kan inte skicka en URL eller en värd. För den generiska http-read-connectorn är indatan { endpointKey, params }, och URL:en bakom endpointKey konfigureras av dig som appägare — inte av appkoden. Svar cachas på servern och rate-limitas, eftersom tredjepartsnycklar har kvoter.

En 404 betyder att ägaren inte har anslutit den connectorn ännu — det är det fall som är värt att hantera i ditt gränssnitt.

Låt AI:n koppla ihop det

Du behöver inte skriva connector-kod för hand. AI Builder känner till vilka connectors som är bundna till ditt projekt och kan generera integrationen åt dig:

• "Skicka ett välkomstmejl när användare registrerar sig" — använder Resend-connectorn
• "Posta ett Slack-meddelande när en ny order kommer in" — använder Slack-connectorn
• "Spela upp ljudberättelse på artikelsidan" — använder ElevenLabs-connectorn

Referens för connector-åtgärder

Resend (connectorId: 'resend')

Åtgärd	Sidoeffekter	Beskrivning
sendEmail	write	Skicka ett enskilt transaktionellt mejl
sendBatch	write	Skicka flera mejl på en gång
listDomains	read	Lista verifierade avsändardomäner

Slack (connectorId: 'slack')

Åtgärd	Sidoeffekter	Beskrivning
postMessage	write	Posta ett meddelande i en kanal
listChannels	read	Lista kanaler i arbetsytan
listUsers	read	Lista medlemmar i arbetsytan
reactToMessage	write	Lägg till en emoji-reaktion
getThread	read	Hämta svar i en tråd

ElevenLabs (connectorId: 'eleven-labs')

Åtgärd	Sidoeffekter	Beskrivning
textToSpeech	write	Konvertera text till talljud
listVoices	read	Lista tillgängliga röster
generateSoundEffect	write	Generera en AI-skapad ljudeffekt

Anslutningsstatusar

Status	Innebörd
Active	Uppgifterna är giltiga och anslutningen är redo att användas
Broken	Uppgifterna har gått ut eller återkallats — uppdatera dem för att återställa

Säkerhet

• Uppgifter krypteras med AES-256-GCM i vila
• Åtgärder är rate-limitade till 1 000 förfrågningar per minut per connector per projekt
• Varje åtgärdsanrop loggas med ett revisionsspår (anslutning, åtgärd, varaktighet, status)
• Anslutningar är begränsade till hela arbetsytan

Vanliga frågor

Kan jag använda samma anslutning i flera projekt?

Ja. Skapa anslutningen en gång och bind den till valfritt antal projekt inom samma arbetsyta.

Vad händer om min API-nyckel går ut eller återkallas?

Anslutningens status ändras till Broken. Uppdatera uppgifterna under Settings > Connectors för att återställa den.

Kan jag anropa connector-åtgärder från frontend?

Din app håller aldrig uppgifterna. Läsåtgärder som är säkra för webbläsaren proxas via Proyecta Cloud, som injicerar uppgifterna på serversidan, så nyckeln hamnar aldrig i din bundle. Skrivåtgärder är över huvud taget inte nåbara från webbläsaren.

Kan jag lägga till egna anpassade connectors?

Inte ännu. Anpassade connector-definitioner finns på roadmap.

Kommer snart

• Fler connectors (Google, Twilio, SendGrid med flera)
• Anpassade connector-definitioner — ta med ditt eget API
• Webhook-inmatning för inkommande händelser från anslutna tjänster
• OAuth-gateway — håll tokens på serversidan även för klientinitierade flöden