Connectors

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

Connectors ermöglichen es dir, externe Dienste in deine App zu integrieren, ohne rohe API-Keys im Code verwalten zu müssen. Du richtest eine Verbindung einmal ein, bindest sie an dein Projekt und rufst vorgefertigte Aktionen aus deiner App auf. Zugangsdaten werden verschlüsselt gespeichert und sind für deinen Frontend-Code niemals sichtbar.

Verfügbare Connectors

Connector	Kategorie	Auth-Typ	Funktionen
Resend	Kommunikation	API-Key	Transaktions-E-Mails senden, Massen-E-Mails versenden, verifizierte Domains auflisten
Slack	Kommunikation	OAuth	Nachrichten posten, Channels und Nutzer auflisten, auf Nachrichten reagieren, Threads lesen
ElevenLabs	KI	API-Key	Text-to-Speech, verfügbare Stimmen auflisten, Soundeffekte generieren

Weitere Connectors werden regelmäßig hinzugefügt.

So funktionieren Connectors

1. Du erstellst eine Verbindung — gibst Zugangsdaten an (ein API-Key oder eine Anmeldung über OAuth)
2. Du bindest die Verbindung an ein Projekt — damit autorisierst du das Projekt zur Nutzung dieser Zugangsdaten
3. Deine App ruft Aktionen auf — die Anfrage läuft über Proyecta Cloud, das die Zugangsdaten serverseitig einfügt

Dein App-Code kommt niemals mit dem rohen API-Key oder OAuth-Token in Berührung. 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. Wähle einen Connector aus dem Katalog (z. B. Resend)
4. Gib deine Zugangsdaten ein:
   • API-Key-Connectors (Resend, ElevenLabs): Füge deinen Secret-Key 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

Über einen Connector aus deiner App lesen

Deine App kann eine Drittanbieter-API direkt aus dem Browser lesen, ohne dass der API-Key jemals ins Bundle gelangt. Die Zugangsdaten bleiben verschlüsselt auf der Plattform; deine App nennt nur den Connector, die Aktion und eine typisierte Eingabe – den Aufruf übernimmt die Plattform für dich.

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

Zwei Leitplanken solltest du kennen, denn sie sind Absicht:

• Nur Lesezugriffe. Erreichbar sind ausschließlich Aktionen, die die Plattform als browser-sicher markiert hat – alles andere gibt 403 zurück. Schreibende Aktionen (in Slack posten, Mails versenden, eine Karte belasten) sind aus dem Browser grundsätzlich nicht erreichbar.
• Du kannst keine URL und keinen Host übergeben. Beim generischen http-read-Connector ist die Eingabe { endpointKey, params }, und die URL hinter endpointKey konfigurierst du als App-Inhaber – nicht der App-Code. Antworten werden serverseitig gecacht und ratenbegrenzt, da Drittanbieter-Keys kontingentiert sind.

Ein 404 bedeutet, dass der Inhaber diesen Connector noch nicht verbunden hat – genau dieser Fall lohnt sich in deiner UI abzufangen.

Den KI-Builder die Verdrahtung überlassen

Du musst Connector-Code nicht von Hand schreiben. Der KI-Builder kennt, welche Connectors an dein Projekt gebunden 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 (connectorId: 'resend')

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

Slack (connectorId: 'slack')

Aktion	Seiteneffekte	Beschreibung
postMessage	write	Eine Nachricht in einen Channel posten
listChannels	read	Channels im Workspace auflisten
listUsers	read	Workspace-Mitglieder auflisten
reactToMessage	write	Eine Emoji-Reaktion hinzufügen
getThread	read	Antworten in einem Thread abrufen

ElevenLabs (connectorId: 'eleven-labs')

Aktion	Seiteneffekte	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 zum Wiederherstellen

Sicherheit

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

FAQ

Kann ich dieselbe Verbindung für mehrere Projekte verwenden?

Ja. Erstelle die Verbindung einmal und binde sie an beliebig viele Projekte im selben Workspace.

Was passiert, wenn mein API-Key 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?

Deine App hält die Zugangsdaten nie selbst. Browser-sichere Lese-Aktionen werden über Proyecta Cloud geleitet, das die Zugangsdaten serverseitig einfügt – der Key landet also nie in deinem Bundle. Schreibende Aktionen sind aus dem Browser überhaupt nicht erreichbar.

Kann ich eigene benutzerdefinierte Connectors hinzufügen?

Noch nicht. Benutzerdefinierte Connector-Definitionen stehen auf der Roadmap.

Demnächst verfügbar

• Weitere Connectors (Google, Twilio, SendGrid und mehr)
• Benutzerdefinierte Connector-Definitionen — bringe deine eigene API mit
• Webhook-Ingestion für eingehende Events von verbundenen Diensten
• OAuth-Gateway — Token auch bei client-initiierten Flows serverseitig halten