Connectors

Verbinde deine App mit Drittanbieterdiensten wie Slack, Resend und ElevenLabs. Zugangsdaten werden verschlüsselt gespeichert und Aktionen sind vorab authentifiziert.

Mit Connectors kannst du externe Dienste in deine App einbinden, ohne rohe API-Schlüssel im Code verwalten zu müssen. Du richtest eine Verbindung einmal ein, verknüpfst sie mit deinem Projekt und rufst vorgefertigte Aktionen aus deiner App über das Proyecta SDK auf. Zugangsdaten werden verschlüsselt gespeichert und sind für deinen frontend-Code niemals sichtbar.

Verfügbare Connectors

Connector	Kategorie	Authentifizierung	Funktion
Resend	Kommunikation	API-Schlüssel	Transaktions-E-Mails senden, Massen-E-Mails versenden, verifizierte Domains auflisten
Slack	Kommunikation	OAuth	Nachrichten posten, Kanäle und Nutzer auflisten, auf Nachrichten reagieren, Threads lesen
ElevenLabs	KI	API-Schlüssel	Text-to-Speech, verfügbare Stimmen auflisten, Soundeffekte generieren

Es werden regelmäßig weitere Connectors hinzugefügt.

Wie Connectors funktionieren

1. Du erstellst eine Verbindung — gib Zugangsdaten an (einen API-Schlüssel oder melde dich per OAuth an)
2. Du verknüpfst die Verbindung mit einem Projekt — damit autorisierst du das Projekt zur Nutzung dieser Zugangsdaten
3. Deine App ruft Aktionen auf — das SDK sendet die Anfrage über Proyecta Cloud, das die Zugangsdaten server-seitig einfügt

Dein App-Code kommt nie in Berührung mit dem rohen API-Schlüssel oder OAuth-Token. Das Connector-System übernimmt Authentifizierung, Rate-Limiting und Audit-Logging.

Einen Connector einrichten

1. Öffne dein Projekt im Builder
2. Gehe zu Settings > Connectors
3. Klicke auf einen Connector aus dem Katalog (z. B. Resend)
4. Gib deine Zugangsdaten ein:
   • API-Schlüssel-Connectors (Resend, ElevenLabs): Füge deinen geheimen Schlüssel ein
   • OAuth-Connectors (Slack): Melde dich an und erteile die Zugriffsberechtigung
5. Gib der Verbindung einen Namen (z. B. „Production Resend”)
6. Die Verbindung wird automatisch getestet und als Active markiert, wenn sie gültig ist

Einen Connector in deiner App verwenden

Connector-Aktionen werden aus server-seitigem Code (Convex Actions) über das Proyecta SDK aufgerufen:

'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;
    },
});

Die Methode execute gibt folgendes zurück:

Feld	Beschreibung
output	Der Rückgabewert der Aktion (Form abhängig von der Aktion)
durationMs	Ausführungszeit in Millisekunden
invocationId	ID des Audit-Log-Eintrags

Die KI die Verbindung herstellen lassen

Du musst den Connector-Code nicht selbst schreiben. Der AI Builder weiß, welche Connectors mit deinem Projekt verknüpft sind, und kann die Integration für dich generieren:

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

Referenz der Connector-Aktionen

Resend

Aktion	Nebeneffekte	Beschreibung
sendEmail	write	Eine einzelne Transaktions-E-Mail senden
sendBatch	write	Mehrere E-Mails auf einmal senden
listDomains	read	Verifizierte Versand-Domains auflisten

Slack

Aktion	Nebeneffekte	Beschreibung
postMessage	write	Eine Nachricht in einen Kanal posten
listChannels	read	Kanäle im Workspace auflisten
listUsers	read	Mitglieder des Workspace auflisten
reactToMessage	write	Eine Emoji-Reaktion hinzufügen
getThread	read	Antworten in einem Thread abrufen

ElevenLabs

Aktion	Nebeneffekte	Beschreibung
textToSpeech	write	Text in Sprachaudio umwandeln
listVoices	read	Verfügbare Stimmen auflisten
generateSoundEffect	write	Einen KI-Soundeffekt generieren

Verbindungsstatus

Status	Bedeutung
Active	Zugangsdaten sind gültig und die Verbindung ist einsatzbereit
Broken	Zugangsdaten sind abgelaufen oder wurden widerrufen — aktualisiere sie, um die Verbindung wiederherzustellen

Sicherheit

• Zugangsdaten werden mit AES-256-GCM verschlüsselt gespeichert
• Aktionen sind auf 1.000 Anfragen pro Minute pro Connector pro Projekt limitiert
• Jeder Aktionsaufruf wird mit einem Audit-Trail protokolliert (Verbindung, Aktion, Dauer, Status)
• Verbindungen gelten für den gesamten Workspace

FAQ

Kann ich dieselbe Verbindung für mehrere Projekte verwenden?

Ja. Erstelle die Verbindung einmal und verknüpfe sie mit beliebig vielen Projekten im selben Workspace.

Was passiert, wenn mein API-Schlüssel abläuft oder widerrufen wird?

Der Verbindungsstatus wechselt zu Broken. Aktualisiere die Zugangsdaten unter Settings > Connectors, um sie wiederherzustellen.

Kann ich Connector-Aktionen vom frontend aus aufrufen?

Nein. Connector-Aktionen müssen aus server-seitigem Code (Convex Actions) aufgerufen werden, um die Zugangsdaten sicher zu halten. Das SDK leitet die Anfragen über Proyecta Cloud weiter, das die Authentifizierung server-seitig einfügt.

Kann ich eigene benutzerdefinierte Connectors hinzufügen?

Noch nicht. Benutzerdefinierte Connector-Definitionen sind auf der Roadmap geplant.

Demnächst verfügbar

• Weitere Connectors (Google, Twilio, SendGrid und mehr)
• Benutzerdefinierte Connector-Definitionen — bring deine eigene API mit
• Webhook-Empfang für eingehende Ereignisse von verbundenen Diensten
• OAuth-Gateway — Token auch bei clientseitig initiierten Flows server-seitig halten