Hoe koppelt u Sendcloud aan Shopify Flow?
Sendcloud verzorgt de verzending en het volgen van pakketten. Het verstuurt een Webhook telkens wanneer de status van een pakket verandert. Workflow Webhooks zet die oproep om in een Trigger voor de „Shopify Flow“, zodat uw winkel hierop kan reageren: een klant taggen, een opmerking bij de bestelling toevoegen, een interne e-mail versturen, een metaveld bijwerken - alles wat Shopify Flow kan doen.
Deze handleiding beschrijft het volledige traject - Sendcloud verzendt, Workflow Webhooks ontvangt en verifieert, Shopify Flow voert acties uit - waarbij bij elk verzoek de HMAC-handtekening van Sendcloud wordt gecontroleerd, zodat uitsluitend Sendcloud uw workflow kan starten.
Wat u kunt bouwen
- Voeg een opmerking bij de bestelling toe zodra een pakket is afgeleverd, zonder de API van de vervoerder te raadplegen.
- Stuur een e-mail naar de toegewezen contactpersoon van de klant wanneer een levering mislukt.
- Tag bestellingen die langer dan verwacht in het transportproces vastzitten, zodat de support actie kan ondernemen.
Typische gebeurtenissen die worden doorgegeven: een pakket wordt aangekondigd, een pakket is onderweg, een pakket is afgeleverd, een aflevering is mislukt.
Voordat u begint
- Workflow Webhooks geïnstalleerd in uw Shopify-winkel.
- Shopify Flow geïnstalleerd, dat gratis te downloaden is via de App Store (Shopify).
- Een account bij Sendcloud waarmee u webhooks kunt aanmaken.
Stap 1 - Maak de webhook aan op Workflow Webhooks
- Ga naar Workflow Webhooks -> Webhooks -> Maak een webhook aan en geef deze een naam die u in Shopify Flow zult herkennen, zoals
Sendcloud events. - Kies onder ‘Authenticatie’ de optie HMAC.
- Kies onder ‘Signature provider’ de optie ‘Sendcloud’. De app vult de header, het algoritme, de ondertekende payload en het replay-venster automatisch voor u in - u hoeft verder niets meer in te stellen.
- Laat het veld ‘geheim’ voorlopig leeg en klik op ‘Opslaan’. Kopieer de webhook-URL die op de pagina wordt weergegeven.
Zie Authenticatie voor de overige authenticatiemodi en Toewijzing van payloads en Flow-variabelen voor informatie over welke velden naar Shopify Flow worden verzonden.
Stap 2 - Voeg het eindpunt toe in Sendcloud
Open in Sendcloud de instellingen van de integratie en stel de webhook-URL in op de URL die u hebt gekopieerd. De geheime sleutel van de integratie wordt gebruikt om het verzoek te ondertekenen.
Hoe u uw Sendcloud-ondertekeningsgeheim kunt vinden
De geheime sleutel van de integratie (of de webhook-ondertekeningssleutel).
In de documentatie van Sendcloud over webhook-handtekeningen vindt u de exacte bewoordingen en schermafbeeldingen voor uw account.
Plak dat geheim in het veld ‘Secret’ van de webhook op Workflow Webhooks en sla het op. Vanaf dat moment wordt elke Sendcloud-verzending geverifieerd voordat deze Shopify Flow bereikt.
Wat hiermee wordt gecontroleerd
| Wat | Waarde |
|---|---|
| Handtekeningkoptekst | Sendcloud-Signature |
| Waar de handtekening staat | De volledige waarde van de header |
| Wat is ondertekend? | {body} |
| Handtekening | HMAC-SHA256, in hexadecimale notatie gecodeerd |
| Tijdstempel | Wordt niet gebruikt door deze afzender |
| Bescherming tegen herhaling | Geen - deze afzender ondertekent geen tijdstempel, dus elke geldige handtekening blijft geldig |
| Het geheim | Wordt als platte tekst gebruikt. Plak de tekst precies zoals de afzender deze weergeeft |
In de ondertekende payload is {body} de onbewerkte inhoud van het verzoek, byte voor byte.
Een verzoek dat aan een van deze voorwaarden niet voldoet, wordt afgewezen met de foutmelding 401, wordt vastgelegd in Geschiedenis en probleemoplossing en leidt nooit tot het starten van een workflow.
Stap 3 - Stel de workflow Shopify Flow samen
- Maak in „Shopify Flow” een workflow aan en kies de trigger „Workflow Webhooks”.
- Klik op ‘Gebeurtenissen vastleggen’ en verstuur vervolgens een testgebeurtenis vanuit Sendcloud (of gebruik de optie ‘Test verzenden’ in Workflow Webhooks), zodat Shopify Flow de structuur van uw gegevens leert kennen.
- Elke webhook die u bezit, activeert dezelfde Shopify Flow-trigger; voeg daarom een eerste voorwaarde toe op basis van de webhook-ID om deze workflow uitsluitend voor Sendcloud te beperken. De ID wordt weergegeven op de webhook-pagina.
- Voeg uw acties toe - tag een klant, voeg een notitie toe, verstuur een interne e-mail, werk een metaveld bij.
Stap 4 - Test het van begin tot eind
Trigger een daadwerkelijke gebeurtenis in Sendcloud. Onder ‘Workflow Webhooks’ -> ‘History’ zou u de aanroep moeten zien met de status ‘Success’. Indien de handtekening onjuist was, krijgt u in plaats daarvan een vermelding ‘failed’ met de reden daarvoor, en op Gecertificeerde webhooks verifiëren vindt u uitleg over de handtekeningtester die u precies laat zien welke stap is mislukt.
De handtekening komt niet overeen▾
In deze bestelling: het geheim (de meest voorkomende oorzaak - een extra spatie of een sleutel uit de verkeerde omgeving), of de afzender het geheim van een ander eindpunt gebruikt, en of er iets tussen Sendcloud en de app staat dat de body herschrijft. Handtekeningen hebben betrekking op de ruwe bytes, dus een proxy die JSON opnieuw opmaakt, maakt ze ongeldig. De handtekeningcontrole op de webhook-pagina toont de exacte tekst die is ondertekend.
Bij elk verzoek krijg ik een 401-foutmelding▾
Controleer of de authenticatie van de webhook is ingesteld op HMAC met de Sendcloud-provider geselecteerd, of het geheim is ingevuld en of Sendcloud de gegevens naar de URL verstuurt precies zoals deze in de app wordt weergegeven, inclusief de code aan het einde.
Er wordt niets weergegeven in de geschiedenis▾
Het verzoek is nooit aangekomen. Controleer de URL nogmaals in Sendcloud en bekijk het eigen afleveringslogboek van Sendcloud om te zien welk antwoord het heeft ontvangen. Een 404 duidt op een onjuiste of verwijderde webhook, een 429 betekent dat u de limiet voor het aantal aanroepen van uw abonnement hebt overschreden - zie Abonnementen en gebruik.
De workflow wordt voor de verkeerde gebeurtenissen uitgevoerd▾
Elke webhook in uw webwinkel activeert dezelfde Shopify Flow-trigger. Voeg als eerste stap van de workflow een voorwaarde toe op basis van de webhook-ID, of beperk de gebeurtenissen die u vanuit Sendcloud verstuurt.
Gerelateerd
- Gecertificeerde webhooks verifiëren - elke dienstverlener die wij controleren, en hoe wij een dienstverlener beschrijven die wij niet controleren.
- Toewijzing van payloads en Flow-variabelen - de juiste velden uit de Payload halen en in Shopify Flow invoeren.
- Bescherming tegen dubbele leveringen - wat er gebeurt wanneer Sendcloud een bezorgpoging herhaalt.
- Geschiedenis en probleemoplossing - het logboek van elk verzoek, inclusief de mogelijkheid tot terugkijken.