Verbindungen per Autorisierung: Shopify, Meta und Google Workspace

Diese Verbindungen sind dafür da, dass die App Daten aus Ihrem Konto liest (Produkte und Bestellungen Ihres Shops, die Beiträge Ihrer Seite). Verwechseln Sie das nicht mit dem Social Login, bei dem sich Ihr Kunde mit seinem eigenen Konto in der App anmeldet: Das liegt im Tab Authentifizierung, in Registrierung und Anmeldung in Ihrer App.

Bevor Sie anfangen

• Tarif: Builder. Der Tarif wird bei jeder Nutzung geprüft: Verlässt das Konto den Builder, hört die App auf, diese Daten zu lesen;
• Kosten: Die Apps bei den Anbietern anzulegen ist kostenlos. Jeder Aufruf der App an diese Konten verbraucht Integrations-Credits;
• Sie müssen selbst dabei sein, wenn autorisiert wird: Sie genehmigen den Zugriff, angemeldet in Ihrem Konto beim Anbieter.

Wie die Autorisierung funktioniert

Der Weg ist bei Shopify und Meta derselbe und hat zwei Stufen:

1. die Schlüssel der App speichern, die Sie beim Anbieter angelegt haben, auf der Karte, mit Speichern und aktivieren;
2. das Konto verbinden: Klicken Sie auf derselben Karte auf Konto verbinden. Ein Fenster des Anbieters öffnet sich, Sie melden sich in Ihrem Konto an und genehmigen den Zugriff. Das Fenster schließt sich von selbst, und die Karte zeigt „Integration aktiv.“

Der Knopf Konto verbinden bleibt deaktiviert, bis die Schlüssel gespeichert sind („Zuerst die Schlüssel speichern, dann das Konto verbinden.“). Die Schlüssel zu speichern reicht nicht: Ohne Stufe 2 antwortet die App, dass zuerst das Konto verbunden werden muss.

Shopify

Felder der Karte: Shop domain, API key und API secret key.

Die App kann Produkte auflisten, ein Produkt ansehen, Bestellungen auflisten und Kunden des Shops auflisten. Nur lesend: Der angeforderte Zugriff auf den Shop ist das Lesen von Produkten, Bestellungen und Kunden.

1. legen Sie in partners.shopify.com eine App an (zum Testen ist ein Entwicklungsshop kostenlos);
2. kopieren Sie die Client ID (kommt in das Feld API key) und das Client secret (kommt in API secret key);
3. öffnen Sie im Editor der App, Tab Integrationen, Kategorie E-Commerce, die Karte Shopify;
4. tragen Sie unter Shop domain die Domain des Shops im Format ihr-shop.myshopify.com ein. Es muss die .myshopify.com-Adresse sein, nicht die eigene Domain des Shops;
5. füllen Sie die beiden Schlüssel aus und klicken Sie auf Speichern und aktivieren;
6. klicken Sie auf Konto verbinden und genehmigen Sie die Installation im Shop.

Meta (Facebook/Instagram)

Felder der Karte: App ID und App Secret.

Die App kann die Facebook-Seiten auflisten, die Sie verwalten, und die Beiträge einer Seite lesen. Der angeforderte Zugriff umfasst das Ansehen der Seitenliste, das Lesen ihres Engagements und die Verwaltung des Unternehmens.

1. legen Sie in developers.facebook.com eine App an (es kann dieselbe wie für WhatsApp sein);
2. fügen Sie der App das Produkt Facebook Login hinzu;
3. kopieren Sie unter Einstellungen → Allgemeines die App ID und das App Secret;
4. öffnen Sie im Editor der App, Tab Integrationen, Kategorie Social Media, die Karte Meta (Facebook/Instagram);
5. fügen Sie beide Schlüssel ein und klicken Sie auf Speichern und aktivieren;
6. klicken Sie auf Konto verbinden, melden Sie sich mit dem Facebook-Konto an, das die Seiten verwaltet, und genehmigen Sie.

Solange die Meta-App im Entwicklungsmodus ist, können nur Personen mit einer Rolle in der App (Administrator, Entwickler, Tester) autorisieren. Für Ihre eigene Nutzung genügt das.

Google Workspace

Felder der Karte: Client ID und Client Secret.

Die Verbindung dient dazu, dass die App Sheets, Calendar, Drive und Gmail mit einem Google-Konto nutzt.

1. gehen Sie in console.cloud.google.com, im Projekt, das Sie nutzen (es kann dasselbe wie für Maps sein), zu APIs & Dienste → Anmeldedaten → Anmeldedaten erstellen → OAuth-Client-ID, Typ Webanwendung;
2. aktivieren Sie im Projekt die APIs, die die App nutzen wird (zum Beispiel Google Sheets API und Google Calendar API);
3. öffnen Sie im Editor der App, Tab Integrationen, Kategorie Produktivität, die Karte Google Workspace, fügen Sie Client ID und Client Secret ein und klicken Sie auf Speichern und aktivieren.

⚠️ Anders als bei Shopify und Meta hat die Karte von Google Workspace derzeit keinen Knopf Konto verbinden: Sie speichert die Schlüssel, aber die Stufe, in der das Google-Konto autorisiert wird, ist dort nicht verfügbar. Hängt Ihre App von dieser Verbindung ab, sprechen Sie mit dem Support, bevor Sie darauf aufbauen.

Verwenden Sie hier nicht die Callback-URL der Anmeldung mit Google aus dem Tab Authentifizierung: Sie gehört zu einer anderen Verbindung.

Woran Sie erkennen, dass es funktioniert

• nach Konto verbinden zeigt das Fenster des Anbieters „Verbunden! Du kannst dieses Fenster schließen.“ und schließt sich von selbst;
• die Karte zeigt „Integration aktiv.“ und das Abzeichen Verbunden. Achtung: Das Abzeichen erscheint schon beim Speichern der Schlüssel, vor der Autorisierung. Allein beweist es nicht, dass das Konto verbunden wurde;
• der endgültige Beweis ist, dass die App die Daten zeigt: Bitten Sie im Chat zum Beispiel „liste die Produkte meines Shopify-Shops auf“.

Den Zugriff widerrufen

Zwei Enden, und es lohnt sich, beide zu erledigen:

1. auf der Plattform: Öffnen Sie die Karte und klicken Sie auf Trennen. Die Schlüssel und der autorisierte Zugriff werden hier gelöscht;
2. beim Anbieter: Entfernen Sie die Autorisierung auf seiner Seite, damit der Zugriff endgültig nicht mehr besteht. Bei Shopify deinstallieren Sie die App in den App-Einstellungen des Shops. Bei Facebook entfernen Sie die App in den Business-Integrationen Ihres Kontos.

Häufige Probleme

• Das Fenster des Anbieters zeigt einen Fehler zur Weiterleitungsadresse. Der Anbieter verlangt, dass die Rücksprungadresse in der von Ihnen angelegten App eingetragen ist, und diese Adresse erscheint derzeit nicht auf der Karte. Wenden Sie sich an den Support, um die Rücksprungadresse Ihres Projekts zu erhalten, und tragen Sie sie in der App des Anbieters ein;
• Das Fenster schließt sich mit „Fehlgeschlagen:“ und einem Grund. Der Grund kommt vom Anbieter. Am häufigsten: Die Autorisierung wurde abgebrochen, oder der gespeicherte geheime Schlüssel gehört nicht zu der App, bei der Sie sich angemeldet haben;
• „fülle … aus, bevor du verbindest“. Ein gespeichertes Feld fehlt. Bei Shopify ist auch Shop domain Pflicht;
• „shop_domain muss eine gültige .myshopify.com-Domain sein“. Verwenden Sie die Adresse ihr-shop.myshopify.com;
• Bei Meta kann niemand außer mir autorisieren. Die Meta-App ist im Entwicklungsmodus.