Auf dieser Seite
- Verbindung anlegen
- Mit Login-Fenster verbinden
- Was du je Dienst brauchst
- Google Sheets: Schlüssel finden
- Airtable: Token erstellen
- Notion: Integration anlegen
- HubSpot: private App anlegen
- Pipedrive: API-Token finden
- Trello: Schlüssel und Token
- Asana: Zugriffstoken
- WhatsApp Business: Cloud API
- SMS: Twilio, MessageBird oder Vonage
- App-Schritt einfügen
- Testen und Fehler
- SMS und WhatsApp
- Datenschutz
- Häufige Fragen
Verbindung anlegen
Öffne Studio → Automatisierungen → Integrationen. Im Abschnitt Apps stehen die Dienste nach Bereich: Tabellen und Notizen (Google Sheets, Airtable, Notion), CRM (HubSpot, Pipedrive), Aufgaben (Trello, Asana) und Nachrichten (WhatsApp Business, SMS). Ein Klick auf „Verbinden“ öffnet ein Fenster mit einer kurzen Anleitung, wo du den Schlüssel beim Dienst findest, und den passenden Feldern. „Verbinden und prüfen“ speichert die Verbindung und macht gleich einen harmlosen Lese-Aufruf beim Dienst – so siehst du sofort „Verbunden als …“ oder den Grund, warum es nicht klappt. Später prüfst du jederzeit mit „Verbindung prüfen“.
Schlüssel und Token liegen nur auf dem Server, zusätzlich verschlüsselt, und kommen nie zurück in den Browser. Sichtbar bleiben nur der Name, die letzten Zeichen und nicht geheime Angaben wie die Adresse des Google-Dienstkontos oder der SMS-Absender. Name, Absender und Pipedrive-Subdomain speichern automatisch; den Schlüssel tauschst du über „Schlüssel ersetzen“ aus. Jede Verbindung geht nur an die festen Adressen ihres Dienstes.
Mit Login-Fenster verbinden
Bei Google Sheets, Airtable, Notion, Asana, HubSpot, Pipedrive, Trello und SMS (seven.io) heißt der Knopf im Fenster „Mit Google verbinden“ (bzw. mit Airtable, Notion, Asana, HubSpot, Pipedrive, Trello oder seven.io), sobald BirdBuild den Login für den Dienst eingerichtet hat. Es öffnet sich ein Login-Fenster des Dienstes: anmelden, Zugriff erlauben – das Fenster schließt sich, und die Verbindung steht mit dem angemeldeten Konto in der Liste. Ist die Anmeldung abgelaufen oder beim Dienst widerrufen, steht bei der Verbindung „Neu verbinden“; die Schritte behalten die Verbindung. Wer lieber einen eigenen Schlüssel nutzt, wählt darunter „Stattdessen Token einfügen“ (bei Google „Stattdessen Dienstkonto-Schlüssel einfügen“, bei SMS „Stattdessen Twilio, MessageBird oder Vonage“) – dann gelten die Schritte unten.
- Google Sheets: BirdBuild sieht nur Tabellen, die du freigibst. Im Google-Sheets-Schritt wählst du die Tabelle über „Tabelle auswählen“ aus, die Adresse wird eingetragen.
- Notion: Im Login-Fenster die Seiten und Datenbanken auswählen, die BirdBuild nutzen darf. Weitere Datenbanken teilst du später in Notion über … › Verbindungen.
- Airtable: Im Login-Fenster die Bases auswählen, die BirdBuild nutzen darf.
- Pipedrive: Die Verbindung gilt für die Firma, mit der du dich anmeldest. BirdBuild spricht nur deren Pipedrive-Adresse an; sie steht bei der Verbindung.
- SMS über seven.io: Vor dem Login-Fenster den Absender eintragen (Nummer mit + oder Name bis 11 Zeichen). Er lässt sich danach bei der Verbindung ändern. Die SMS laufen über das Guthaben deines seven-Kontos.
Beim Löschen einer Login-Verbindung widerruft BirdBuild den Zugriff bei Google, Notion, Asana, HubSpot, Pipedrive, Trello und seven.io, sofern keine andere Verbindung ihn noch braucht. Bei Airtable entfernst du die Freigabe bei Bedarf selbst in Airtable. Verbinden geht nur im Browser – nicht über die KI-Anbindung (MCP).
Was du je Dienst brauchst
Ohne Login-Fenster braucht jeder Dienst einen eigenen Schlüssel, den du einmal bei ihm erzeugst. Die Schritte stehen auch im Fenster „Verbinden“. Den Schlüssel legst du nur im Browser an – nicht über die KI-Anbindung (MCP).
Google Sheets: Schlüssel finden
- In der Google Cloud Console ein Projekt wählen und die „Google Sheets API“ aktivieren.
- IAM und Verwaltung › Dienstkonten › Dienstkonto erstellen.
- Beim Dienstkonto Schlüssel › Schlüssel hinzufügen › JSON wählen und den Inhalt der Datei in BirdBuild einfügen.
- Jede Tabelle für die angezeigte Adresse des Dienstkontos als Bearbeiter freigeben.
Airtable: Token erstellen
airtable.com/create/tokensöffnen und Token erstellen.- Bereiche wählen:
data.records:read,data.records:writeundschema.bases:read. - Unter Zugriff die Bases wählen, die die Automatisierung nutzen darf.
Notion: Integration anlegen
notion.so/profile/integrationsöffnen und eine neue interne Integration anlegen.- Den „Internal Integration Secret“ kopieren.
- In Notion jede Datenbank mit der Integration teilen: … › Verbindungen und die Integration wählen.
HubSpot: private App anlegen
- In HubSpot Einstellungen › Integrationen › Private Apps › Private App erstellen.
- Bereiche:
crm.objects.contactsundcrm.objects.deals, jeweils lesen und schreiben. - Die App erstellen und den Zugriffstoken kopieren.
Pipedrive: API-Token finden
- In Pipedrive auf das Profilbild › Persönliche Einstellungen › API.
- Den persönlichen API-Token kopieren.
- Optional die Subdomain aus der Adresse eintragen, z. B.
meinefirmaausmeinefirma.pipedrive.com– dann führen die Links im Ergebnis direkt zum Datensatz.
Trello: Schlüssel und Token
trello.com/power-ups/adminöffnen und unter Neu ein Power-Up anlegen.- Unter „API-Schlüssel“ den Schlüssel erzeugen und kopieren.
- Daneben einen Token erzeugen, den Zugriff erlauben und den Token kopieren.
Asana: Zugriffstoken
app.asana.com/0/my-appsöffnen.- Neues Zugriffstoken erstellen, einen Namen vergeben und den Token kopieren.
WhatsApp Business: Cloud API
- Auf
developers.facebook.comunter Meine Apps die App mit WhatsApp öffnen und bei API-Einrichtung die „Telefonnummer-ID“ kopieren. - In den Business-Einstellungen unter Systemnutzer einen Token mit der Berechtigung
whatsapp_business_messagingerzeugen. - Nachrichten-Vorlagen im WhatsApp Manager anlegen und freigeben lassen – gesendet werden nur freigegebene Vorlagen.
SMS: Twilio, MessageBird oder Vonage
- Twilio: in
console.twilio.comunter „Account Info“ Account SID und Auth Token kopieren; als Absender eine Twilio-Nummer, einen Messaging-Service oder einen Absendernamen eintragen. - MessageBird: im Dashboard unter Developers › API access einen Live-Schlüssel kopieren; Absender ist deine Nummer oder ein Name bis 11 Zeichen.
- Vonage: in
dashboard.nexmo.comunter „API Settings“ API Key und API Secret kopieren; Absender ist deine Vonage-Nummer oder ein Name bis 11 Zeichen.
App-Schritt einfügen
Unter Schritt hinzufügen → Apps wählst du den Dienst. Im Schritt stellst du die Verbindung und die Aktion ein, etwa Zeile anhängen, Datensatz suchen, Kontakt anlegen oder aktualisieren, Karte anlegen oder SMS senden. Die Felder füllst du mit der Datenauswahl, zum Beispiel {{contact.email}}. Tabellen, Bases und Datenbanken gibst du als Adresse aus der Browserzeile oder als ID an. Spalten, Felder und Eigenschaften ordnest du in einer Liste zu: links der Name beim Dienst, rechts der Wert.
Das Ergebnis steht späteren Schritten bereit, etwa {{steps.sheets_1.rowNumber}}, {{steps.hubspot_1.id}} oder {{steps.trello_1.url}}. Such-Aktionen liefern zusätzlich .found und .count. Fehlt eine Verbindung, meldet „Startklar prüfen“ das mit einem Button „Verbinden“ – aktivieren lässt sich die Automatisierung erst danach.
Testen und Fehler
„Schritt testen“ führt die Aktion einmal echt beim Dienst aus. Legt sie etwas an oder sendet sie eine Nachricht, fragt BirdBuild vorher nach. Das Ergebnis erscheint direkt im Fenster und steht danach in der Datenauswahl. Lehnt der Dienst ab, siehst du den Grund, etwa „Zugang abgelehnt – Token prüfen“ oder „Beim Dienst nicht gefunden – ID und Freigabe prüfen“. Meldet der Dienst „zu viele Anfragen“ oder einen kurzen Ausfall, versucht BirdBuild es von selbst noch einmal. Danach entscheidet „Bei Fehler“: anhalten, weiter oder Fehler-Weg. App-Schritte laufen auch in Schleifen.
SMS und WhatsApp
Nachrichten gehen an die Telefonnummer des Kontakts. BirdBuild bringt sie ins internationale Format; fehlt die Ländervorwahl, gilt das Land des Kontakts, sonst das Land deines Kontos. Eine ungültige Nummer lässt den Schritt mit einem klaren Hinweis scheitern. Kontakte ohne Nummer sowie abgemeldete, gesperrte, pausierte und archivierte Kontakte werden übersprungen, der Ablauf geht weiter. Eine SMS hat höchstens 480 Zeichen. Gegen Missbrauch gilt eine Tagesgrenze von 1.000 SMS und 2.000 WhatsApp-Nachrichten je Konto. Werbung per SMS oder WhatsApp darfst du nur mit vorheriger ausdrücklicher Einwilligung des Kontakts senden; Nachrichten zu einer Anfrage, Bestellung oder Buchung, etwa eine Terminerinnerung, sind keine Werbung. Bei WhatsApp gelten zusätzlich die Regeln von Meta für Vorlagen und Einwilligungen.
Datenschutz
An den Dienst geht nur, was du im Schritt einsetzt, bei SMS und WhatsApp zusätzlich die Telefonnummer. Du bist dafür Verantwortlicher und brauchst eine Rechtsgrundlage sowie gegebenenfalls einen AV-Vertrag mit dem Anbieter. Die Dienste, die du verbindest, sind deine Empfänger und keine Unterauftragsverarbeiter von BirdBuild; für sie gelten ihre eigenen Bedingungen und Preise. Im Rechtstexte-Assistenten wird der Baustein „Automatisierungen an externe Dienste“ vorgeschlagen, sobald eine aktive Automatisierung einen App-Schritt enthält. Die Datenschutzerklärung nennt die verbundenen Apps dann beim Namen, Dienste mit Sitz in den USA zusätzlich bei den Drittländern, und bei SMS oder WhatsApp einen Satz zur Einwilligung für Werbung. Unveränderte Texte aktualisiert BirdBuild von selbst; hast du die Erklärung bearbeitet, erscheint in der Übersicht der Rechtstexte der Hinweis „Automatisierungen fehlen in der Datenschutzerklärung“. Im Protokoll stehen nur gekürzte Antworten, die Nummer maskiert und nie Schlüssel.
Häufige Fragen
Warum findet der Google-Sheets-Schritt meine Tabelle nicht?
Meist fehlt die Freigabe. Mit Google-Login sieht BirdBuild nur Tabellen, die du im Schritt über „Tabelle auswählen“ ausgewählt hast – wähle sie dort aus. Mit Dienstkonto gibst du die Tabelle in Google Sheets für die Dienstkonto-Adresse frei, die unter Integrationen bei der Verbindung steht (Rolle Bearbeiter), und prüfst, ob die Google Sheets API im Cloud-Projekt aktiviert ist.
Was heißt „Verbindung abgelaufen – neu verbinden“?
Die Anmeldung beim Dienst gilt nicht mehr, etwa weil der Zugriff dort widerrufen wurde. Klicke unter Integrationen bei der Verbindung auf „Neu verbinden“ und melde dich erneut an. Die Schritte nutzen danach wieder dieselbe Verbindung.
Kann ich meinen Schlüssel später wieder ansehen?
Nein. Schlüssel und Token liegen nur auf dem Server, zusätzlich verschlüsselt, und werden nie wieder angezeigt. Mit „Schlüssel ersetzen“ trägst du einen neuen ein; alle Schritte, die die Verbindung nutzen, verwenden ab dann den neuen.
Warum wurde eine SMS nicht gesendet?
Der Kontakt hat keine Telefonnummer, ist abgemeldet, gesperrt, pausiert oder archiviert – dann wird der Schritt übersprungen und im Protokoll steht der Grund. Fehlt bei einer Nummer ohne +-Vorwahl ein Land am Kontakt und im Konto, ist die Nummer ungültig.
Werden beim Testen echte Daten angelegt?
Ja. „Schritt testen“ führt die Aktion einmal echt aus und fragt bei schreibenden Aktionen und Nachrichten vorher nach. Der Testlauf der ganzen Automatisierung ruft die Dienste dagegen nicht auf, sondern nimmt das letzte Testergebnis.
Wo finde ich den Schlüssel für meinen Dienst?
Im Fenster „Verbinden“ steht für jeden Dienst eine kurze Anleitung. Dieselben Schritte findest du hier im Abschnitt des jeweiligen Dienstes, etwa „HubSpot: private App anlegen“ oder „SMS: Twilio, MessageBird oder Vonage“.
Muss ich meine Datenschutzerklärung anpassen?
Ja, sobald eine aktive Automatisierung Daten an eine App schickt. Mit dem Rechtstexte-Assistenten geht das von selbst: Er nennt die verbundenen Apps und ergänzt unveränderte Texte automatisch. Hast du die Erklärung bearbeitet, zeigt die Übersicht der Rechtstexte einen Hinweis mit einem Klick zum Aktualisieren.
Kann die KI-Anbindung (MCP) eine App verbinden?
Nein. Schlüssel gibst du nur im Studio ein. Über die KI-Anbindung lassen sich die vorhandenen Verbindungen auflisten (ohne Schlüssel) und in App-Schritten auswählen.