So verbinden Sie Slack mit Shopify Flow

Slack signiert jede Anfrage, die es an Ihre App sendet - Slash-Befehle, interaktive Nachrichten und Übermittlungen über die Events-API - mit dem Signaturschlüssel Ihrer App. „Workflow Webhooks“ wandelt diesen Aufruf in einen „Shopify Flow“-Trigger um, sodass Ihr Shop darauf reagieren kann: einen Kunden kennzeichnen, eine Bestellnotiz hinzufügen, eine interne E-Mail versenden, ein Metafeld aktualisieren - alles, was Shopify Flow leisten kann.

Diese Anleitung legt den gesamten Ablauf fest - Slack sendet, Workflow Webhooks empfängt und überprüft, Shopify Flow führt die Aktion aus -, wobei bei jeder Anfrage die HMAC-Signatur von Slack überprüft wird, sodass ausschließlich Slack Ihren Workflow starten kann.

Was Sie bauen können

• Ermöglichen Sie Ihrem Team, einen Shopify Flow-Workflow über einen Slash-Befehl in Slack zu starten, ohne jemandem Administratorrechte zu gewähren.
• Genehmigen Sie etwas in Slack, und lassen Sie Shopify Flow die genehmigte Bestellung oder den Kunden kennzeichnen.
• Verwandeln Sie eine Slack-Verknüpfung in eine Shop-Aktion - fügen Sie ein Tag hinzu, versenden Sie eine E-Mail, aktualisieren Sie ein Metafeld.

Typische Ereignisse, die gesendet werden können: ein Slash-Befehl wie beispielsweise /restock, ein Tastendruck in einer interaktiven Nachricht, ein Ereignis der Events-API.

Bevor Sie beginnen

• Workflow Webhooks in Ihrem Shopify-Shop installiert.
• Shopify Flow installiert, die kostenlos im App Store unter Shopify erhältlich ist.
• Ein Slack-Konto mit der Berechtigung, Webhooks zu erstellen.

Schritt 1 - Erstellen Sie den Webhook unter Workflow Webhooks

1. Öffnen Sie „Workflow Webhooks“** -> „Webhooks“ -> „Webhook erstellen“** und geben Sie ihm einen Namen, den Sie in Shopify Flow wiedererkennen, beispielsweise Slack events.
2. Wählen Sie unter „Authentifizierung“ die Option „HMAC“ aus.
3. Wählen Sie unter „Signaturanbieter“ die Option „Slack“ aus. Die App füllt die Felder „Header“, „Algorithmus“, „signierte Payload“ und „Wiederholungsfenster“ automatisch für Sie aus - es sind keine weiteren Einstellungen erforderlich.
4. Lassen Sie das Feld „Secret“ vorerst leer und klicken Sie auf „Speichern“. Kopieren Sie die auf der Seite angezeigte URL des Webhooks.

Informationen zu den anderen Authentifizierungsmodi finden Sie unter Authentifizierung, und unter Zuordnung der Payload-Daten und Flow-Variablen erfahren Sie, welche Felder an Shopify Flow übermittelt werden.

Schritt 2 - Fügen Sie den Endpunkt in Slack hinzu

Fügen Sie in der Konfiguration Ihrer Slack-App die URL als „Request URL“ für den Slash-Befehl, die Interaktivität oder die Events-API hinzu und kopieren Sie das Signierungsgeheimnis aus „Grundlegende Informationen“ -> „App-Anmeldeinformationen“.

So finden Sie Ihr Slack-Signaturgeheimnis

Signierungsgeheimnis der Slack-App (Grundlegende Informationen → App-Anmeldeinformationen).

In der Slack-eigenen Dokumentation zu Webhook-Signaturen unter finden Sie den genauen Wortlaut sowie Screenshots für Ihr Konto.

Fügen Sie diesen Schlüssel in das Feld „Secret“ des Webhooks unter Workflow Webhooks ein und speichern Sie die Eingabe. Ab diesem Zeitpunkt wird jede Slack-Nachricht überprüft, bevor sie Shopify Flow erreicht.

Was hier überprüft wird

Was	Wert
Signaturzeile	X-Slack-Signature
Wo sich die Unterschrift befindet	Der Wert des Headers nach dem Präfix v0=
Was wird unterzeichnet?	v0:{timestamp}:{body}
Unterschrift	HMAC-SHA256, hexadezimal kodiert
Zeitstempel	Der Header X-Slack-Request-Timestamp als Unix-Sekunden
Wiedergabeschutz	Anfragen, deren signierter Zeitstempel mehr als 5 Minuten vom aktuellen Zeitpunkt entfernt ist, werden abgelehnt
Das Geheimnis	Wird als Klartext verwendet. Fügen Sie den Text genau so ein, wie er vom Absender angezeigt wird.

In der signierten Payload entspricht {body} dem Rohtext des Anfrage-Hauptteils, Byte für Byte, und {timestamp} entspricht dem oben genannten Zeitstempel.

Eine Anfrage, die eine dieser Bedingungen nicht erfüllt, wird mit dem Fehler 401 abgelehnt, unter Hintergrund und Fehlerbehebung protokolliert und löst niemals einen Workflow aus.

Schritt 3 - Erstellen Sie den Workflow Shopify Flow

1. Erstellen Sie in „Shopify Flow“ einen Workflow und wählen Sie den Trigger „Workflow Webhooks“ aus.
2. Klicken Sie auf „Ereignisse aufzeichnen“ und senden Sie anschließend ein Testereignis über Slack (oder verwenden Sie die Option „Test senden“ unter Workflow Webhooks), damit Shopify Flow die Struktur Ihrer Daten erkennt.
3. Jeder Webhook, den Sie besitzen, löst denselben Shopify Flow-Trigger aus. Fügen Sie daher eine erste Bedingung für die Webhook-ID hinzu, um diesen Workflow ausschließlich auf Slack zu beschränken. Die ID wird auf der Webhook-Seite angezeigt.
4. Fügen Sie Ihre Aktionen hinzu - taggen Sie einen Kunden, fügen Sie eine Notiz hinzu, versenden Sie eine interne E-Mail, aktualisieren Sie ein Metafeld.

Schritt 4 - Testen Sie das System von Anfang bis Ende

Lösen Sie ein echtes Ereignis in Slack aus. Unter „Workflow Webhooks“** -> „History“** sollten Sie den Aufruf mit dem Status „Success“ sehen. War die Signatur fehlerhaft, erhalten Sie stattdessen einen Eintrag mit dem Status „Failed“ und dem entsprechenden Grund. Unter Überprüfung signierter Webhooks finden Sie Erläuterungen zum Signatur-Tester, der Ihnen genau anzeigt, welcher Schritt fehlgeschlagen ist.

Verwandte Themen

• Überprüfung signierter Webhooks - jeden Anbieter, den wir überprüfen, und wie wir einen Anbieter beschreiben, den wir nicht überprüfen.
• Zuordnung der Payload-Daten und Flow-Variablen - die richtigen Felder aus der Payload zu extrahieren und in Shopify Flow zu übertragen.
• Schutz vor doppelten Lieferungen - Was geschieht, wenn Slack einen Zustellversuch wiederholt?
• Hintergrund und Fehlerbehebung - das Protokoll jeder Anfrage, einschließlich Wiedergabe.