Connectors

Anslut din app till tjänster från tredje part som Slack, Resend och ElevenLabs. Inloggningsuppgifter krypteras och åtgärder är förautentiserade.

Connectors låter dig integrera externa tjänster i din app utan att hantera rå API-nycklar i koden. Du sätter upp en anslutning en gång, kopplar den till ditt projekt och anropar färdiga åtgärder från din app via Proyecta SDK. Inloggningsuppgifter 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 transaktionsmejl, skicka mejl i batch, 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 inloggningsuppgifter (en API-nyckel eller logga in via OAuth)
2. Du kopplar anslutningen till ett projekt — detta ger projektet behörighet att använda dessa uppgifter
3. Din app anropar åtgärder — SDK:n skickar begäran via Proyecta Cloud, som injicerar inloggningsuppgifterna på serversidan

Din appkod hanterar aldrig den rå API-nyckeln eller OAuth-token. Connector-systemet tar hand om autentisering, rate limiting och granskningsloggning.

Sätt upp 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 inloggningsuppgifter:
   • 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

Använd en connector i din app

Connector-åtgärder anropas från kod på serversidan (Convex-åtgärder) via Proyecta SDK:

'use node';
import { action } from './_generated/server';
import { v } from 'convex/values';
import Proyecta from '@proyecta-ai/sdk';

const proyecta = new Proyecta({ apiKey: process.env.PROYECTA_API_KEY ?? null });

export const notifySlack = action({
    args: {
        message: v.string(),
    },
    handler: async (ctx, args) => {
        const result = await proyecta.connectors.execute({
            connectorId: 'slack',
            actionId: 'postMessage',
            input: {
                channel: '#general',
                text: args.message,
            },
        });
        return result.output;
    },
});

Metoden execute returnerar:

Fält	Beskrivning
output	Åtgärdens returvärde (strukturen beror på åtgärden)
durationMs	Exekveringstid i millisekunder
invocationId	ID för granskningsloggposten

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 kopplade till ditt projekt och kan generera integrationen åt dig:

• "Send a welcome email when users sign up" — använder Resend-connectorn
• "Post a Slack message when a new order comes in" — använder Slack-connectorn
• "Play audio narration on the article page" — använder ElevenLabs-connectorn

Referens för connector-åtgärder

Resend

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

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

Å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	Betydelse
Active	Inloggningsuppgifterna är giltiga och anslutningen är redo att användas
Broken	Inloggningsuppgifterna har gått ut eller återkallats — uppdatera dem för att återställa

Säkerhet

• Inloggningsuppgifter krypteras med AES-256-GCM i vila
• Åtgärder är rate-limitade till 1 000 begäranden per minut per connector per projekt
• Varje åtgärdsanrop loggas med ett granskningsspå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 koppla den till valfritt antal projekt i samma arbetsyta.

Vad händer om min API-nyckel löper ut eller återkallas?

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

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

Nej. Connector-åtgärder måste anropas från kod på serversidan (Convex-åtgärder) för att hålla inloggningsuppgifterna säkra. SDK:n dirigerar via Proyecta Cloud, som injicerar autentisering på serversidan.

Kan jag lägga till egna anpassade connectors?

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

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