Workflow WebhooksWorkflow Webhooks
Så här kopplar du ihop Linear med Shopify Flow

Så här kopplar du ihop Linear med Shopify Flow

Kopiera sidan

Anslut Linear till Shopify Flow med HMAC-verifierade webhooks; steg-för-steg-guide för konfiguration, kontroller och felsökning ingår.

Linear skickar en webhook när ärenden, projekt eller kommentarer ändras i ditt arbetsutrymme. 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 - Linear skickar, Workflow Webhooks tar emot och verifierar, Shopify Flow utför åtgärderna - där Linears HMAC-signatur kontrolleras vid varje förfrågan, så att endast Linear kan starta ditt arbetsflöde.

Vad du kan bygga

  • Skicka ett e-postmeddelande till ditt merchandisingteam när en bugg med taggen storefront når statusen ”Klar”.
  • Skriv in det aktuella sprint- eller releasenumret i ett metafält i butiken.
  • Starta ett arbetsflöde med en checklista för butiken när ett lanseringsproblem har avslutats.

Typiska händelser som ska skickas: ett ärende skapas eller byter status, en kommentar läggs till, en projektuppdatering publiceras.

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å Linear med behörighet att skapa webhooks.

Steg 1 - Skapa webhooken i Workflow Webhooks

  1. Öppna ”Workflow Webhooks”** -> ”Webhooks” -> ”Skapa webhook”** och ge den ett namn som du känner igen i Shopify Flow, till exempel Linear events.
  2. Under ”Autentisering” väljer du HMAC.
  3. Under ”Signaturleverantör” väljer du Linear. Appen fyller i rubriken, algoritmen, den signerade datan och återuppspelningsfönstret åt dig - det finns inget annat att konfigurera.
  4. 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 Linear

I Linear öppnar du Inställningar -> API -> Webhooks, skapar en webhook med den URL du kopierade och kopierar den signeringsnyckel som visas där.

Så här hittar du din Linear-signaturnyckel

Den signeringshemlighet som visas i webhooken i Linear (Inställningar -> API -> Webhooks).

Linears 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 leverans från Linear innan den når Shopify Flow.

Vad detta kontrollerar

Vad Värde
Signaturrubrik Linear-Signature
Var signaturen ska placeras Hela värdet i rubriken
Vad som har undertecknats {body}
Signatur HMAC-SHA256, hexadecimalt kodad
Tidsstämpel Används inte av denna avsändare
Skydd mot uppspelning Ingen - den här avsändaren signerar inte tidsstämpeln, så alla giltiga signaturer förblir giltiga
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.

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

  1. I Shopify Flow skapar du ett arbetsflöde och väljer utlösaren ”Workflow Webhooks”.
  2. Klicka på ”Spela in händelser” och skicka sedan en testhändelse från Linear (eller använd funktionen ”Skicka test” i Workflow Webhooks) så att Shopify Flow lär sig hur dina data ser ut.
  3. Varje webhook som du äger aktiverar samma utlösare i Shopify Flow, så lägg till ett första villkor baserat på webhook-ID:t för att se till att detta arbetsflöde endast omfattar Linear. ID:t visas på webhook-sidan.
  4. Lägg till dina åtgärder - märk en kund, lägg till en anteckning, skicka ett internt e-postmeddelande, uppdatera ett metafält.
Shopify Flow
I Shopify Flow väljer du ”Välj en utlösare”, öppnar ”Workflow Webhooks” och väljer ”Webhook-utlösare”.
Ett villkor i Shopify Flow: Webhook-ID:t är lika med ID:t för en webhook
Det första steget i varje arbetsflöde: ett villkor baserat på webhook-ID:t, så att arbetsflödet endast körs för just denna webhook.
Det färdiga arbetsflödet: Webhook-utlösare, ett villkor baserat på webhook-ID:t, följt av att ett internt e-postmeddelande skickas i ”True”-grenen
Det färdiga arbetsflödet: utlösare, villkor baserat på webhook-ID:t, följt av din åtgärd i ”True”-grenen.

Steg 4 - Testa systemet från början till slut

Utlös en verklig händelse i Linear. Under ”Workflow Webhooks” → ”History” bör du se anropet med statusen ”Success”. Om signaturen var felaktig visas istället en post om misslyckande med orsaken angiven, och Verifiering av signerade webhooks förklarar signaturkontrollen som visar exakt vilket steg som misslyckades.

En anropning öppnades i ”History” med dess begärandehuvuden, nyttolast, status, varaktighet och identifierare
En genomförd händelse i Historik: statusen ”Framgång” innebär att Shopify Flow har godkänt den.
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 Linear och appen skriver om huvudtexten. Signaturerna omfattar de råa byte, så en proxy som omformaterar JSON gör dem ogiltiga. Signaturtestaren på webhook-sidan visar den exakta texten som signerades.

Jag får felkod 401 vid varje förfrågan

Kontrollera att webhookens autentisering är inställd på HMAC med leverantören Linear vald, att den hemliga nyckeln är ifylld och att Linear skickar data till URL:en exakt så som den visas i appen, inklusive koden i slutet.

Det visas inget i historiken

Förfrågan kom aldrig fram. Kontrollera URL-adressen i Linear igen och titta i Linears 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 aktiverar 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 Linear.

Relaterat