Deutsch (du)

Was sind Connectors?

Connectors verbinden deine condoo.Vibe-App mit Stripe, Resend, Twilio, Cloudinary, KI-Anbietern und weiteren Diensten, ohne geheime Zugangsdaten offenzulegen.

condoo.Vibe kann die Datenbank, Authentifizierung, Oberfläche, APIs und serverseitige Logik erstellen, die deine Anwendung benötigt.

Viele Produkte müssen aber auch mit Diensten außerhalb von condoo.Vibe kommunizieren.

Vielleicht möchtest du:

Connectors ermöglichen deinen condoo.Vibe-Anwendungen, mit diesen externen Diensten zu arbeiten.

Verbinde die Dienste, die dein Produkt benötigt. Dann teile condoo.Vibe mit, was du damit entwickeln möchtest.

Was ist ein Connector?

Ein Connector ist eine Verbindung zwischen deiner condoo.Vibe-Anwendung und einem externen Dienst.

Stell dir beispielsweise vor, du entwickelst eine SaaS-Anwendung und möchtest Kunden kostenpflichtige Abonnements anbieten.

condoo.Vibe kann Folgendes erstellen:

Die eigentliche Zahlungsabwicklung kann jedoch Stripe übernehmen.

Der Stripe-Connector stellt die Verbindung bereit, die deine Anwendung für die Zusammenarbeit mit Stripe benötigt.

Vereinfacht dargestellt:

Deine Anwendung
       ↓
     condoo.Vibe
       ↓
Stripe-Connector
       ↓
     Stripe

Dasselbe Prinzip gilt für andere unterstützte Dienste.

Warum Connectors benötigt werden

Einige Funktionen gehören zu deiner Anwendung.

Andere Funktionen hängen von spezialisierten externen Plattformen ab.

Zum Beispiel:

Bedarf deiner Anwendung Externer Dienst
Zahlungsabwicklung Stripe
Transaktions-E-Mails Resend
SMS und Kommunikation Twilio
Medienspeicherung und -auslieferung Cloudinary
KI-Funktionen OpenAI, Anthropic, Google, xAI
Terminplanung Calendly
Kalenderfunktionen Google Calendar
Besprechungen Google Meet
Dateien Google Drive

Anstatt diese Dienste nachzubauen, kann condoo.Vibe sie mit dem Produkt verbinden, das du entwickelst.

Einmal verbinden, dann entwickeln

Der Connector-Ablauf trennt die Konfiguration von der Produktentwicklung.

Statt beispielsweise bei jeder Änderung am Abrechnungssystem erneut Stripe-Zugangsdaten anzugeben, verbindest du Stripe über die Connector-Oberfläche von condoo.Vibe.

Anschließend kannst du dich auf Anforderungen wie diese konzentrieren:

Ein Pro-Abonnement für $49/Monat hinzufügen.

Später:

Eine Abrechnungsseite hinzufügen, auf der Kunden ihren aktuellen Tarif sehen und ihr Abonnement verwalten können.

Danach:

Das Analyse-Dashboard auf Pro-Abonnenten beschränken.

Du beschreibst dein Produkt.

Der Connector bietet Zugang zum externen Dienst, der die gewünschte Funktion ermöglicht.

Einen Dienst zu verbinden ist nicht dasselbe, wie damit Funktionen zu entwickeln

Diese Unterscheidung ist wichtig.

Die Verbindung mit Stripe fügt deiner Anwendung nicht automatisch Zahlungen hinzu.

Die Verbindung mit Resend startet nicht automatisch den E-Mail-Versand.

Die Verbindung mit OpenAI fügt nicht automatisch KI-Funktionen hinzu.

Ein Connector stellt den externen Dienst für die Nutzung durch deine Anwendung bereit.

Du teilst condoo.Vibe weiterhin mit, was du entwickeln möchtest.

Zum Beispiel:

STRIPE VERBINDEN
      ↓
Stripe wird verfügbar
      ↓
"Monatliche Abonnements hinzufügen"
      ↓
condoo.Vibe erstellt den Abrechnungsablauf
      ↓
Testen
      ↓
Veröffentlichen

Connectors geben deinem KI-Produktteam Zugang zu zusätzlichen Fähigkeiten.

Einen Dienst verbinden

condoo.Vibe Connectors

Welche Angaben genau benötigt werden, hängt vom Dienst ab, den du verbindest.

Ein Dienst benötigt möglicherweise Folgendes:

condoo.Vibe führt dich durch die Angaben, die der unterstützte Connector benötigt.

API-Schlüssel erklärt

Viele externe Dienste verwenden einen API-Schlüssel, um deine Anwendung zu identifizieren und zu autorisieren.

Ein API-Schlüssel kann etwa so aussehen:

sk_••••••••••••••••••••••

Er ist eine Art Zugangsnachweis, der deiner Anwendung die Kommunikation mit einem Dienst ermöglicht.

Resend muss beispielsweise wissen, dass deine Anwendung E-Mails über dein Resend-Konto versenden darf.

Der API-Schlüssel erteilt diese Berechtigung.

API-Schlüssel sind vertraulich

Viele API-Schlüssel ermöglichen den Zugriff auf wichtige Funktionen oder Kontoressourcen.

Behandle geheime API-Schlüssel wie Passwörter.

Schreib keine Prompts wie:

Mein geheimer Stripe-Schlüssel lautet sk_live_xxxxxxxxx. Direkt in den Checkout-Code einfügen.

Füge Zugangsdaten stattdessen über den unterstützten Connector oder die sichere Konfigurationsoberfläche von condoo.Vibe hinzu.

Öffentliche und geheime Schlüssel

Nicht jeder Schlüssel hat dieselben Sicherheitsanforderungen.

Manche Dienste stellen sowohl öffentliche als auch geheime Zugangsdaten bereit.

Zum Beispiel:

Publishable Key

Darf dort verwendet werden, wo der Dienst die clientseitige Nutzung ausdrücklich erlaubt.

Secret Key

Muss privat bleiben und sollte ausschließlich in sicheren serverseitigen Umgebungen verwendet werden.

Die Connector-spezifischen Anleitungen von condoo.Vibe erklären, welche Zugangsdaten benötigt werden.

Im Zweifel behandle Zugangsdaten als privat.

Wie condoo.Vibe Connectors verwendet

Sobald ein Dienst verbunden ist, kannst du die gewünschte Funktion beschreiben.

Nach dem Verbinden von Resend beispielsweise:

Wenn jemand das Kontaktformular absendet, dieser Person eine Bestätigungs-E-Mail senden und unser Vertriebsteam benachrichtigen.

condoo.Vibe kann den Ablauf rund um den verbundenen Dienst erstellen.

Vereinfacht dargestellt:

Kontaktformular
     ↓
Absenden
     ↓
In Neon speichern
     ↓
Serverseitige Logik
     ↓
Resend-Connector
     ↓
Bestätigungs-E-Mail

Der Nutzer sieht ein Kontaktformular.

Dahinter arbeiten mehrere Systeme zusammen.

Beispiel: Stripe

Angenommen, du entwickelst eine SaaS-Anwendung.

Zuerst verbindest du Stripe.

Dann teilst du condoo.Vibe mit:

Die Abonnements Starter, Pro und Business für $19, $49 und $99 pro Monat hinzufügen. Kunden sollen auf der Preisseite einen Tarif auswählen und ihr Abonnement unter Account Settings verwalten können.

condoo.Vibe kann beim Erstellen des benötigten Abrechnungsablaufs den verbundenen Stripe-Dienst nutzen.

Dein Produkt könnte schließlich Folgendes umfassen:

Preisseite
     ↓
Tarif auswählen
     ↓
Stripe Checkout
     ↓
Zahlung
     ↓
Zahlungsbestätigung
     ↓
Abonnement aktualisieren
     ↓
Funktionen freischalten

Die vollständige Stripe-Einrichtung behandeln wir auf der nächsten Seite.

Beispiel: Resend

Verbinde dein Resend-Konto.

Danach:

Jedes Mal eine Begrüßungs-E-Mail senden, wenn ein neuer Nutzer erfolgreich ein Konto erstellt.

Oder:

Kunden nach dem Erstellen ihrer Buchung eine Bestätigungs-E-Mail senden.

Oder:

Der zuständigen Vertriebskraft eine E-Mail senden, wenn ein neuer qualifizierter Lead ins CRM aufgenommen wird.

Der Connector stellt den Zugang zum E-Mail-Dienst bereit.

Dein Prompt legt fest, wann und wofür dieser verwendet werden soll.

Beispiel: KI-Modelle

Du kannst auch unterstützte KI-Anbieter verbinden, wenn deine Anwendung KI-Funktionen benötigt.

Nach dem Verbinden eines KI-Anbieters beispielsweise:

Dem Kundensupport-Dashboard einen KI-Assistenten hinzufügen. Er soll Mitarbeitenden helfen, anhand des Gesprächskontexts mit dem Kunden Antworten zu entwerfen.

Oder:

Einen Generator für Produktbeschreibungen hinzufügen. Nutzer sollen Produktname, Eigenschaften, Zielkunden und Ton angeben und anschließend drei Beschreibungen erzeugen können.

So lassen sich KI-Funktionen innerhalb der Anwendungen nutzen, die du mit condoo.Vibe erstellst.

Connectors können zusammenarbeiten

Dein Produkt ist nicht auf einen einzigen externen Dienst beschränkt.

Stell dir vor, du entwickelst eine KI-Vertriebsplattform.

Sie könnte Folgendes verwenden:

Neon
   ↓
Kunden- und Lead-Daten

OpenAI
   ↓
Personalisierte Kontaktansprache erzeugen

Resend
   ↓
E-Mails senden

Twilio
   ↓
SMS senden

Stripe
   ↓
Kundenabonnements verwalten

condoo.Vibe kann Abläufe erstellen, die mehrere Systeme kombinieren.

Zum Beispiel:

Wenn ein neuer Lead das Beratungsformular absendet, den Lead speichern, mit KI eine kurze Qualifizierungszusammenfassung erstellen, sie im CRM anzeigen und das Vertriebsteam per E-Mail informieren.

Eine einzige Nutzeraktion kann einen Ablauf auslösen, an dem mehrere Teile deines Produkts beteiligt sind.

Zugangsdaten und Sicherheit

Von Connectors verwendete Zugangsdaten sollten als vertrauliche Anwendungsgeheimnisse behandelt werden.

Die Connector-Oberfläche von condoo.Vibe ermöglicht es dir, die von deiner Anwendung benötigten Zugangsdaten zu konfigurieren, ohne geheime Werte bewusst in öffentlich zugänglichen Anwendungscode einzufügen.

Du solltest dennoch gute Sicherheitspraktiken befolgen:

Test- und Produktionszugangsdaten

Manche Dienste bieten unterschiedliche Umgebungen für Entwicklung und Produktion.

Stripe bietet beispielsweise Testmöglichkeiten, mit denen du Zahlungsabläufe entwickeln kannst, ohne echte Kunden zu belasten.

Wo dies unterstützt wird, eignet sich folgender Ablauf:

Testzugangsdaten verbinden
        ↓
Entwickeln
        ↓
Testen
        ↓
Überprüfen
        ↓
Produktionsumgebung konfigurieren
        ↓
Veröffentlichen

Teste kritische Zahlungsfunktionen nicht zum ersten Mal mit echten Kundentransaktionen.

Was passiert, wenn ein Connector nicht mehr funktioniert?

Eine externe Integration kann aus verschiedenen Gründen fehlschlagen.

Zum Beispiel:

Wenn eine vom Connector abhängige Funktion ausfällt, prüfe zunächst, ob das Problem bei:

deiner Anwendung

oder bei

der Verbindung zum externen Dienst liegt.

Zum Beispiel:

Buchungsdatensätze werden korrekt erstellt, aber Bestätigungs-E-Mails werden nicht mehr versendet.

Das deutet darauf hin, dass der Buchungsablauf selbst funktioniert, während der E-Mail-Teil untersucht werden muss.

Verwende den Debug-Modus und beschreib genau, was passiert.

condoo.Vibe hilfreiche Informationen zur Fehlersuche geben

Zum Beispiel:

Über Resend werden keine Bestätigungs-E-Mails mehr versendet. Buchungen werden weiterhin erfolgreich gespeichert. Den E-Mail-Teil des Buchungsablaufs untersuchen, ohne die bestehende Buchungsfunktion zu ändern.

Wenn du eine Fehlermeldung hast, füge sie hinzu.

Die geheimen Zugangsdaten selbst darfst du aber nicht einfügen.

Eine Verbindung entfernen oder ändern

Möglicherweise musst du später:

Verwende die Konfigurationsoberfläche des Connectors, um die Verbindung zu aktualisieren.

Teste nach einer Änderung an einer Integration, die eine produktive Anwendung nutzt, die betroffenen Abläufe.

Nach einer Änderung der Stripe-Konfiguration beispielsweise:

Checkout → Zahlungsbestätigung → Abonnementaktualisierung → Funktionszugriff

Geh nicht davon aus, dass die Aktualisierung der Zugangsdaten automatisch bedeutet, dass der gesamte Ablauf weiterhin korrekt funktioniert.

Vor dem Verbinden eines Dienstes

Frag dich:

Was soll der Dienst für meine Anwendung tun?

Buchungsbestätigungen senden.

Welcher Dienst bietet diese Funktion?

Resend.

Habe ich das erforderliche Konto?

Ja.

Welche Zugangsdaten oder Freigaben werden benötigt?

Die Connector-spezifische Anleitung befolgen.

Was soll in meiner Anwendung passieren?

Nach erfolgreicher Erstellung einer Buchung dem Kunden eine Bestätigung senden.

So bleibt die Integration an eine tatsächliche Produktanforderung gebunden.

Unterstützte Connectors

Dieser Abschnitt enthält Anleitungen zu folgenden Connectors:

Zahlungen

Kommunikation

Medien

KI

Terminplanung und Produktivität

Wir gehen jeden Dienst einzeln durch.

Ein weiterer Connector wird benötigt?

Falls der benötigte Dienst derzeit nicht unterstützt wird, kann condoo.Vibe möglicherweise trotzdem mit seiner API arbeiten. Das hängt von deiner Anwendung und den Anforderungen des Dienstes ab.

Am Ende dieses Abschnitts erklären wir außerdem, wie du einen neuen Connector anfragen kannst.

Als Nächstes: Stripe

Jetzt, da du weißt, wie Connectors funktionieren, beginnen wir mit einer der häufigsten Integrationen:

Stripe

Du erfährst, wie du Stripe mit condoo.Vibe verbindest und damit Folgendes entwickelst:

Stripe

Stripe verbinden und Einmalzahlungen, Abonnements und Abrechnung einrichten.