Integrationen aktivieren

Die App kann den Checkout-Bildschirm, das Adressfeld oder den Knopf zum Senden einer Nachricht fertig haben und trotzdem nicht funktionieren: Diese Aktionen führt der Anbieter aus, mit Ihrem Konto. Ohne gespeicherte Zugangsdaten existiert der Bildschirm, aber die Aktion passiert nicht.

Wo es liegt

Der Tab Integrationen im Editor. Er hat zwei Unter-Tabs:

• Anbieter: eine Karte pro Dienst aus dem Katalog, mit Suche nach Namen, den Filtern Alle, Verbunden und Nicht verbunden und den Kategorien (Zahlungen, Standort, Benachrichtigungen, Produktivität und weitere);
• Externe APIs: um eine API einzutragen, die nicht im Katalog ist, mit dem Schlüssel auf dem Server gespeichert und von einer Backend-Funktion genutzt.

Zwei ähnliche Themen wohnen in anderen Tabs: Der Social Login (Google, Apple, Microsoft und andere) liegt unter Authentifizierung, und die Versanddomain für E-Mails unter Domains.

Tarif

Der Tab Integrationen öffnet sich in jedem Tarif, und ein Teil der Karten funktioniert in allen, auch im Free. Die übrigen verlangen den Tarif Builder.

In den Tarifen Free und Starter erscheinen die Karten, die den Builder verlangen, abgeblendet, oben im Tab steht der Hinweis „Integrationen sind eine Funktion des Builder-Plans“, und ein Klick auf eine dieser Karten führt zu den Tarifen. Die übrigen öffnen und verbinden sich ganz normal.

Auch der Unter-Tab Externe APIs gehört zum Tarif Builder.

Bei WhatsApp, Telegram, Shopify, Meta, Notion, Airtable, Mailchimp und Webhook (ausgehend) prüft der Server den Tarif außerdem bei jeder Nutzung. Verlässt das Konto den Builder, antworten diese Integrationen in der veröffentlichten App nicht mehr, auch wenn die Zugangsdaten noch gespeichert sind.

E-Mail mit eigener Domain ist ein Sonderfall: Sie liegt im Tab Domains und gilt für jeden bezahlten Tarif. Siehe E-Mail mit eigener Domain.

Eine Karte verbinden

1. klicken Sie auf die Karte;
2. füllen Sie die Felder aus, die sie verlangt (jeder Leitfaden unten sagt, woher Sie jedes einzelne bekommen);
3. klicken Sie auf Speichern und aktivieren.

Die Plattform speichert und testet die Zugangsdaten sofort, bei den Anbietern, die das erlauben. Ein bereits gespeichertes geheimes Feld erscheint danach mit „· konfiguriert“ neben dem Namen. Trennen, unten auf der Karte, löscht die Zugangsdaten von der Plattform.

Um einen Schlüssel auf einer bereits verbundenen Karte zu ändern, geben Sie nur dieses Feld ein und speichern Sie. Ein leer gelassenes Feld behält seinen gespeicherten Wert, und was die Plattform selbst speichert (etwa das Webhook-Signaturgeheimnis von Stripe und den autorisierten Zugriff der Verbindungen per Autorisierung), bleibt erhalten.

Die Schlüssel liegen verschlüsselt auf dem Server und kommen nie auf den Bildschirm zurück oder in den Browser der Menschen, die die App nutzen.

Was jeder Zustand bedeutet

Nicht jede Karte kann die Zugangsdaten beim Speichern testen, und das ändert, was Verbunden garantiert:

• testen wirklich, im Gespräch mit dem Anbieter: Stripe, Mercado Pago, Pagar.me, Hotmart und Google Maps;
• prüfen nur das Format der ID: Meta Pixel, Google Analytics, Google AdSense, Google Tag Manager, Microsoft Clarity, Hotjar und die Chats (Baseportal Chat, Crisp, Tawk.to);
• speichern nur, ohne Test: SMS (Twilio), WhatsApp, Slack, Discord, Telegram, Notion, Airtable, Mailchimp, Webhook (ausgehend), Shopify, Meta (Facebook/Instagram) und Google Workspace. Bei diesen bedeutet Verbunden „gespeichert“, und der Beweis, dass es funktioniert, ist der erste echte Versand.

Schlägt der Test fehl, zeigt das Fenster „Gespeichert, aber die Validierung ist fehlgeschlagen“, gefolgt vom Grund, den der Anbieter genannt hat. Der Weg ist dann, die Zugangsdaten beim Anbieter zu korrigieren, nicht denselben Wert erneut einzufügen.

Test- und Produktionsschlüssel

Viele Anbieter geben zwei Sätze von Zugangsdaten aus: einen zum Testen, der kein Geld bewegt und nichts wirklich zustellt, und einen für die Produktion.

• Stripe, Mercado Pago und Pagar.me haben keinen Umgebungsschalter auf der Karte: Entscheidend ist, welchen Schlüssel Sie einfügen. Testschlüssel, Testzahlung. Wechseln Sie vor dem Verkaufen zu den Produktionsschlüsseln;
• Hotmart hat die Option „Testumgebung verwenden (Sandbox)“. Lassen Sie sie bei Produktionszugangsdaten deaktiviert;
• WhatsApp und Twilio haben im Testmodus Grenzen (erlaubte Zielnummern, ablaufender Token). Die jeweiligen Leitfäden erklären das.

Integrations-Credits

Eine Integration einzurichten kostet keinerlei Credits. Was verbraucht wird, sind die Integrations-Credits, die Währung für das Betreiben der App, wenn die veröffentlichte App den Anbieter nutzt: jede SMS (einschließlich des Anmeldecodes per SMS), jede Automations-E-Mail oder Benachrichtigung, die die App verschickt, jede Nachricht in Slack oder Discord, jede WhatsApp- oder Telegram-Nachricht und jeder Aufruf an Shopify, Meta, Notion, Airtable, Mailchimp, Webhook (ausgehend), Google Workspace und externe APIs.

Abgebucht wird nur, wenn der Anbieter annimmt. Ein fehlgeschlagener Aufruf wird nicht berechnet. Ist das Guthaben aufgebraucht, werden diese Sendungen abgelehnt, bis wieder Guthaben da ist.

Zahlungen und Google Maps verbrauchen keine Integrations-Credits. Maps nutzt das Kontingent und die Abrechnung Ihres Projekts bei Google.

Guthaben und Verbrauch des Monats stehen im Panel unter Abrechnung. Siehe Credits.

Der Assistent sagt, was fehlt

Nach einem Build zeigt der Chat die Karte Damit es wirklich funktioniert, mit jeder Integration, die der Code der App nutzt und die noch nicht aktiv ist. Jeder Eintrag hat zwei Knöpfe:

• In Integrationen aktivieren: öffnet den Tab Integrationen direkt auf der Karte dieser Integration (bei Zahlungen in der Kategorie Zahlungen, wo Sie den Zahlungsanbieter wählen);
• So aktivieren Sie es: öffnet den Leitfaden dieses Anbieters in dieser Dokumentation.

Sobald eine Integration aktiv ist, bestätigt der Assistent das im Chat.

Der Assistent liest außerdem bei jedem Gespräch den Zustand Ihrer Integrationen: welche verbunden sind, welche gespeichert, aber fehlerhaft sind, und welche nicht verbunden wurden. Sie können im Chat fragen „ist Stripe aktiv?“. Er sieht den Zustand, nie den Wert der Schlüssel.

Leitfäden nach Anbieter

Die Analytics-Karten (Meta Pixel, Google Analytics, Google Tag Manager, Microsoft Clarity, Hotjar), die Chat-Karten und die Karte Cookie-Einwilligung verlangen nur eine ID, und die Beschreibung auf der Karte selbst sagt, wo Sie sie finden.

Häufige Probleme

• Die Karte ist grün und nichts passiert. Sehen Sie nach, in welcher Gruppe der Liste oben sie steht: Bei den Karten, die nur speichern, beweist Verbunden nicht, dass der Schlüssel stimmt. Lösen Sie einen echten Versand aus und lesen Sie den Fehler;
• Ich habe einen Zahlungsanbieter gespeichert und der andere ist verschwunden. Stripe, Mercado Pago und Pagar.me teilen sich denselben Platz: Pro App ist nur einer aktiv, und das Speichern eines anderen ersetzt den vorherigen. Die Schlüssel des alten Zahlungsanbieters werden nicht übernommen: Füllen Sie die Felder des neuen aus;
• Die Karte öffnet die Tarifseite. Das Konto ist im Free oder Starter, und diese Karte verlangt den Builder. Siehe die Tabelle im Abschnitt Tarif oben.