Hoe u Zendesk kunt koppelen aan Shopify Flow

Q: 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 Zendesk en de app staat dat de hoofdtekst herschrijft . Handtekeningen hebben betrekking op de ruwe bytes, dus een proxy die JSON opnieuw opmaakt, maakt ze ongeldig. De handtekeningtester op de webhook-pagina toont de exacte tekst die is ondertekend.

Zendesk kan vanuit een trigger of automatisering een Webhook aanroepen telkens wanneer er een wijziging in een ticket plaatsvindt. Workflow Webhooks zet die aanroep om in een trigger van Shopify Flow, zodat uw winkel hierop kan reageren: een klant taggen, een opmerking bij een bestelling toevoegen, een interne e-mail versturen, een metaveld bijwerken - alles Shopify Flow kan doen.

Deze handleiding beschrijft het volledige proces - Zendesk verzendt, Workflow Webhooks ontvangt en verifieert, Shopify Flow voert de actie uit - waarbij bij elk verzoek de HMAC-handtekening van Zendesk wordt gecontroleerd, zodat uitsluitend Zendesk uw workflow kan starten.

Wat u kunt bouwen

Voeg de Shopify-klant toe aan een ticket dat is geëscaleerd, zodat uw team dit in het beheerdersgedeelte kan zien.
Voeg een opmerking bij de bestelling toe zodra een supportticket met betrekking tot die bestelling is afgehandeld.
Stuur een e-mail naar een manager wanneer een belangrijke klant een lage tevredenheidsscore geeft.

Typische gebeurtenissen die u kunt doorsturen: er wordt een ticket aangemaakt, een ticket wordt afgehandeld, er wordt een tevredenheidsbeoordeling ontvangen.

Voordat u begint

Workflow Webhooks geïnstalleerd op uw Shopify-winkel.
Shopify Flow geïnstalleerd, die gratis te downloaden is via de App Store op Shopify.
Een account op Zendesk met toestemming om webhooks aan te maken.

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 Zendesk events.
Kies onder ‘Authenticatie’ de optie ‘HMAC’.
Kies onder „Signature provider“ de optie „Zendesk“. 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 Zendesk

Ga in het Zendesk Admin Center naar Apps en integraties -> Webhooks, maak een webhook aan die verwijst naar de URL die u hebt gekopieerd, koppel deze aan een trigger en gebruik vervolgens de optie ‘Geheim onthullen’.

Hoe u uw Zendesk-ondertekeningsgeheim kunt vinden

Het ondertekeningsgeheim van de webhook (Beheercentrum -> Apps en integraties -> Webhooks -> Geheim weergeven).

In de documentatie van Zendesk zelf over webhook-handtekeningen vindt u de exacte bewoordingen en schermafbeeldingen voor uw account.

Plak de geheime code in het veld „Secret“ van de webhook op Workflow Webhooks en sla deze op. Vanaf dat moment wordt elke Zendesk-verzending geverifieerd voordat deze Shopify Flow bereikt.

Wat hiermee wordt gecontroleerd

Wat	Waarde
Handtekeningkop	`X-Zendesk-Webhook-Signature`
Waar de handtekening staat	De volledige waarde van de header
Wat is ondertekend?	`{header:x-zendesk-webhook-signature-timestamp}{body}`
Handtekening	HMAC-SHA256, gecodeerd in Base64
Tijdstempel	Wordt niet gebruikt door deze afzender
Bescherming tegen herhaling	Geen - deze afzender ondertekent geen tijdstempel, zodat elke geldige handtekening geldig blijft
Het geheim	Wordt als platte tekst gebruikt. Plak de tekst precies zoals de afzender deze weergeeft

In de ondertekende payload is {body} de onbewerkte verzoektekst, byte voor byte, en is {header:x-zendesk-webhook-signature-timestamp} de x-zendesk-webhook-signature-timestamp verzoekheader.

Een verzoek dat aan een van deze voorwaarden niet voldoet, wordt afgewezen met de foutmelding 401, wordt geregistreerd 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 Zendesk (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 Flow-trigger. Voeg daarom een eerste voorwaarde toe op basis van de webhook-ID om deze workflow uitsluitend voor Zendesk te reserveren. 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.

Een Shopify Flow-voorwaarde: de webhook-ID is gelijk aan de ID van één webhook — De eerste stap van elke workflow: een voorwaarde op basis van de webhook-ID, zodat de workflow uitsluitend voor deze webhook wordt uitgevoerd.

De voltooide workflow: Webhook-trigger, een voorwaarde op basis van de webhook-ID, gevolgd door het verzenden van een interne e-mail in de „True“-tak — De voltooide workflow: trigger, voorwaarde op basis van de webhook-ID, gevolgd door uw actie in de „True“-tak.

Stap 4 - Test het van begin tot eind

Trigger een daadwerkelijke gebeurtenis in Zendesk. Onder ‘Workflow Webhooks’ -> ‘History’ zou u de aanroep moeten zien met de status ‘Success’. Als 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.

Eén aanroep werd in History geopend, met de verzoekheaders, de Payload, de status, de duur en de identificatiegegevens — Een voltooide gebeurtenis in History: de status ‘Succes’ betekent dat Shopify Flow deze heeft geaccepteerd.

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 Zendesk en de app staat dat de hoofdtekst herschrijft. Handtekeningen hebben betrekking op de ruwe bytes, dus een proxy die JSON opnieuw opmaakt, maakt ze ongeldig. De handtekeningtester 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, waarbij de Zendesk-provider is geselecteerd, of het geheim is ingevuld en of Zendesk gegevens verstuurt naar de URL 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 Zendesk en bekijk het eigen afleveringslogboek van Zendesk 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 winkel activeert dezelfde Shopify Flow-trigger. Voeg als eerste stap in de workflow een voorwaarde toe op basis van de webhook-ID, of beperk de gebeurtenissen die u vanuit Zendesk verstuurt.

Gerelateerd

Gecertificeerde webhooks verifiëren - elke aanbieder die wij controleren, en hoe wij een aanbieder 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 Zendesk een verzending opnieuw probeert.
Geschiedenis en probleemoplossing - het logboek van elk verzoek, inclusief de mogelijkheid tot het opnieuw afspelen ervan.