Så här kopplar du ihop Slack med Shopify Flow
Anslut Slack till Shopify Flow med en signerad webhook-utlösare. Här finns instruktioner för konfiguration, HMAC-verifiering och tips för felsökning.
Slack signerar varje förfrågan som skickas till din app - slash-kommandon, interaktiva meddelanden och leveranser via Events API - med din apps signeringsnyckel. Workflow Webhooks omvandlar det anropet till en Shopify Flow-utlösare, så att din butik kan reagera på det: märka en kund, lägga till en orderanteckning, skicka ett internt e-postmeddelande, uppdatera ett metafält - allt som Shopify Flow kan göra.
Den här guiden beskriver hela processen - Slack skickar, Workflow Webhooks tar emot och verifierar, Shopify Flow utför åtgärderna - där Slacks HMAC-signatur kontrolleras vid varje förfrågan, så att endast Slack kan starta ditt arbetsflöde.
Vad du kan bygga
- Låt ditt team starta ett Shopify Flow-arbetsflöde från Slack med ett slash-kommando, utan att ge någon administratörsbehörighet.
- Godkänn något i Slack så att Shopify Flow lägger till en tagg på den order eller kund som har godkänts.
- Omvandla en Slack-genväg till en butiksåtgärd - lägg till en tagg, skicka ett e-postmeddelande, uppdatera ett metafält.
Typiska händelser som kan skickas: ett slash-kommando som till exempel /restock, ett knapptryck i ett interaktivt meddelande, en händelse via Events API.
Innan du börjar
- Workflow Webhooks-funktioner som är installerade i din Shopify-butik.
- Shopify Flow är installerat, vilket är gratis att hämta från Shopify App Store.
- Ett konto på Slack med behörighet att skapa webhooks.
Steg 1 - Skapa webhooken i Workflow Webhooks
- Öppna ”Workflow Webhooks” → ”Webhooks” → ”Skapa webhook” och ge den ett namn som du känner igen i Shopify Flow, till exempel
Slack events. - Under ”Autentisering” väljer du HMAC.
- Under ”Signaturleverantör” väljer du Slack. Appen fyller i rubriken, algoritmen, den signerade datan och återuppspelningsfönstret åt dig - det finns inget annat att konfigurera.
- Lämna fältet för hemligheten tomt för tillfället och klicka på Spara. Kopiera webhook-URL:en som visas på sidan.
Se Autentisering för övriga autentiseringslägen och Kartläggning av nyttolast och Shopify Flow-variabler för information om hur du väljer vilka fält som ska skickas till Shopify Flow.
Steg 2 - Lägg till slutpunkten i Slack
I inställningarna för din Slack-app lägger du till URL:en som begäran-URL för slash-kommandot, interaktiviteten eller Events API, och kopierar signeringsnyckeln från ”Grundläggande information” → ”Appautentiseringsuppgifter”.
Så här hittar du din inloggningsnyckel för Slack
Inloggningshemlighet för Slack-appen (Grundläggande information -> Appens inloggningsuppgifter).
Slacks egen dokumentation om webhook-signaturer innehåller den exakta formuleringen och skärmdumpar för just ditt konto.
Klistra in den hemliga koden i fältet ”Secret” för webhooken i Workflow Webhooks och spara. Från och med då verifieras varje Slack-meddelande innan det når Shopify Flow.
Vad detta kontrollerar
| Vad | Värde |
|---|---|
| Signaturrubrik | X-Slack-Signature |
| Var signaturen ska placeras | Värdet i rubriken, efter prefixet v0= |
| Vad som har undertecknats | v0:{timestamp}:{body} |
| Signatur | HMAC-SHA256, hexadecimalt kodad |
| Tidsstämpel | X-Slack-Request-Timestamp-rubriken, uttryckt i Unix-sekunder |
| Skydd mot uppspelning | Förfrågningar vars signerade tidsstämpel ligger mer än 5 minuter från nuvarande tidpunkt avvisas |
| Hemligheten | Används som ren text. Klistra in den exakt så som avsändaren visar den |
I den signerade nyttolasten är {body} den obearbetade begäran, byte för byte, och {timestamp} är tidsstämpeln ovan.
En begäran som inte uppfyller något av dessa krav avvisas med 401, registreras i Historik och felsökning och sätter aldrig igång ett arbetsflöde.
Steg 3 - Skapa arbetsflödet i Shopify Flow
- I Shopify Flow skapar du ett arbetsflöde och väljer utlösaren ”Workflow Webhooks”.
- Klicka på ”Spela in händelser” och skicka sedan en testhändelse från Slack (eller använd funktionen ”Skicka test” i Workflow Webhooks) så att Shopify Flow lär sig hur dina data ser ut.
- Varje webhook som du äger utlöser samma Shopify Flow-utlösare, så lägg till ett första villkor baserat på **webhook-ID:**t för att se till att detta arbetsflöde endast skickas till Slack. ID:t visas på webhook-sidan.
- Lägg till dina åtgärder - märk en kund, lägg till en anteckning, skicka ett internt e-postmeddelande, uppdatera ett metafält.
Steg 4 - Testa systemet från början till slut
Utlös en verklig händelse i Slack. Under ”Workflow Webhooks” → ”History” bör du se anropet med statusen ”Success”. Om signaturen var felaktig visas istället en misslyckad post med orsaken, och Verifiering av signerade webhooks förklarar signaturkontrollen som visar exakt vilket steg som misslyckades.
Signaturen stämmer inte överens
I följande ordning: hemligheten (den vanligaste orsaken - ett extra mellanslag eller en nyckel från fel miljö), om avsändaren använder en annan ändpunkts hemlighet, och om något mellan Slack och appen omformaterar huvudtexten. Signaturerna omfattar de råa byte, så en proxy som omformaterar JSON gör dem ogiltiga. Signaturtestaren på webhook-sidan visar exakt den text som signerades.
Jag får felkod 401 vid varje förfrågan
Kontrollera att webhookens autentisering är inställd på HMAC med Slack som vald leverantör, att den hemliga nyckeln är ifylld och att Slack skickar in data till URL:en exakt så som appen visar den, inklusive koden i slutet.
Det visas inget i historiken
Begäran kom aldrig fram. Kontrollera URL:en i Slack igen och titta i Slacks egen leveranslogg för att se vilket svar som mottogs. Ett 404-fel innebär att webhooken är felaktig eller har tagits bort, medan ett 429-fel innebär att du har överskridit antalet anrop som ingår i ditt abonnemang - se Planer och användning.
Arbetsflödet körs för fel händelser
Varje webhook i din butik utlöser samma utlösare i Shopify Flow. Lägg till ett villkor baserat på webhook-ID:t som det första steget i arbetsflödet, eller begränsa vilka händelser du skickar från Slack.
Förfrågningarna misslyckas med felmeddelandet ”tidsstämpel utanför toleransgränsen”
Slack förser händelser med en tidsstämpel, och appen avvisar allt som är äldre än 5 minuter. Detta beror vanligtvis på ett klockproblem hos avsändaren, eller på att Slack har gjort ett nytt försök att skicka händelsen långt senare med den ursprungliga tidsstämpeln. Upprepade försök från samma ursprungliga begäran godkänns inte; be Slack att skicka en ny händelse.
Relaterat
- Verifiering av signerade webhooks - alla leverantörer som vi verifierar, samt hur man beskriver en leverantör som vi inte verifierar.
- Kartläggning av nyttolast och Shopify Flow-variabler - att hämta rätt fält från payloaden och överföra dem till Shopify Flow.
- Skydd mot dubbla leveranser - vad som händer när Slack gör ett nytt försök att skicka ett meddelande.
- Historik och felsökning - loggen över varje förfrågan, med möjlighet att spela upp den.