När kassan och kundregistret slutar prata utan att säga något

Ett serverrum med blinkande lampor och kablar, en bild av den dator- och nätverksmiljö där webhooks tas emot och kundregistret uppdateras.

Det finns två vanliga sätt att flytta en ny kund från nätbutiken till kundregistret. Det ena är en körning varje natt som hämtar dagens ordrar och lägger in dem i ett svep. Det andra är att butiken skickar en signal, en webhook, i samma ögonblick som ordern läggs, och att kundregistret tar emot den direkt.

På pappret är det andra sättet bättre i nästan alla avseenden. Säljaren ser kunden medan samtalet fortfarande pågår, bonuspoängen dyker upp innan kvittot har kommit fram och ingen behöver vänta till morgonen. Skillnaden som sällan nämns ligger i hur de två sätten går sönder.

En nattlig körning som misslyckas gör det på en gång. Morgonen efter saknas hela gårdagen, någon märker det före lunch och körningen startas om. En webhook som misslyckas gör det en händelse i taget. Mottagaren svarar inte under de sekunder det tar att installera en uppdatering, butiken försöker kanske igen ett par gånger och ger sedan upp. Ingen larmar, eftersom ingenting ser fel ut. Det fattas bara en kund.

Omförsök på avsändarens villkor

Vart den saknade kunden tar vägen avgörs nästan helt av avsändaren, och där skiljer sig plattformarna åt mer än man tror. Vissa e-handelsplattformar försöker leverera samma händelse om och om igen under lång tid. Andra gör ett fåtal försök och stänger sedan av webhooken helt om felen fortsätter, vilket betyder att allt som händer efter det också försvinner. Jag har inte hittat någon jämförelse mellan plattformarna som jag skulle våga luta mig mot, och dokumentationen ändras ibland utan att någon annonserar det. Det som återstår är att läsa på för just den plattform man använder och, helst, att prova genom att medvetet stänga av mottagaren en stund i en testmiljö.

Envishet har dessutom ett pris. Samma händelse kan komma fram två gånger. Om mottagaren hann spara kunden men inte hann svara, tror butiken att leveransen misslyckades och skickar igen. Utan skydd blir det två kundkort, två välkomstmejl och i värsta fall två kreditupplysningar. Skyddet kallas idempotens i utvecklarspråk och betyder i praktiken att mottagaren känner igen en händelse den redan har hanterat och låter den passera utan att göra något mer.

Det mesta av det här går att bygga in, och ordningen spelar roll. Ett rimligt förlopp för varje inkommande händelse ser ut ungefär så här:

  1. Kvittera direkt. Svara avsändaren så fort händelsen har tagits emot, innan något tyngre arbete görs. Långsamma svar är en vanlig orsak till att avsändaren tror att leveransen misslyckades och skickar igen.
  2. Spara råhändelsen. Skriv ner händelsen precis som den kom, med avsändarens id, innan den tolkas. Då finns den kvar även om bearbetningen kraschar.
  3. Kontrollera om den redan är hanterad. Slå upp händelsens id. Finns det sedan tidigare avslutas hanteringen utan att något skrivs om.
  4. Bearbeta och försök igen vid fel. Svarar inte kundregistret väntar mottagaren och försöker på nytt med allt längre mellanrum, i stället för att hamra på ett system som redan har det tungt.
  5. Lägg det som inte går i en egen kö. Efter ett bestämt antal försök flyttas händelsen åt sidan, där en människa kan se den, i stället för att försvinna.
  6. Stäm av mot källan. Jämför med jämna mellanrum ordrarna i butiken med kunderna som faktiskt kommit in i registret, och hämta det som saknas.

Det sista steget är det som oftast stryks när budgeten krymper, och frestelsen växer ju bättre de fem första fungerar. En avstämning kan kännas som ett underbetyg åt det egna bygget. Men den fångar just de fel som inget av de andra stegen ser: en webhook som plattformen i tysthet har stängt av, eller en händelse som aldrig skickades över huvud taget. För en butik med ett par dussin ordrar om dagen räcker det att någon jämför för hand då och då. För en med tusentals går det inte, och där blir frågan i stället hur tätt jämförelsen ska köras. För ofta belastar den butikens gränssnitt, för sällan och luckan hinner växa sig stor innan någon ser den.

Larma på tystnad

Avstämningen hittar luckan i efterhand. Övervakningen kan hitta den medan den uppstår, men bara om den letar efter rätt sak. Vanlig övervakning letar efter fel: en krasch, en timeout, en felkod. Det värsta felet i en integration syns ofta inte som ett fel utan som en frånvaro. Om det brukar komma in ordrar hela tiden en vardagseftermiddag och det plötsligt har varit stilla i en timme, är det värt ett meddelande till någon, även om ingenting har kraschat.

November gör det här mer akut. När volymerna stiger inför rean och julhandeln ökar risken att en mottagare blir långsam, och samtidigt blir det svårare att se en lucka med blotta ögat i ett flöde som redan är stökigt. Var gränsen för ett frånvarolarm ska gå är också svårare att sätta just då, eftersom det normala flyttar sig från vecka till vecka. En avstängd mottagare och en händelse som skickas två gånger är enklare att prova medan trafiken fortfarande är lugn nog att man ser vad som faktiskt händer.

Steg två och fem i listan ovan har dock en baksida. Händelser från en nätbutik innehåller namn, adresser och ofta telefonnummer, så både de sparade råhändelserna och kön med misslyckade försök är i praktiken register med personuppgifter. Dataskyddsförordningen säger att sådana uppgifter inte ska sparas längre än ändamålet kräver, och en kö som ingen tömmer är svår att försvara med det måttet.

Vem som ska rensa kön, och vem som ska titta i den när ett frånvarolarm går en lördag, är frågor som sällan finns med när en ny integration beställs. Offerten handlar om vad som ska flyttas och hur fort. Vad som ska hända med det som inte kom fram får ofta sitt svar först den dag det redan har hänt.

Uppgifter om hur webhooks, omförsök och avstämningar hanteras i praktiken kommer från Webringcode, som arbetar med systemintegration mellan e-handel och CRM.

Det finns två vanliga sätt att flytta en ny kund från nätbutiken till kundregistret. Det ena är en körning varje natt som hämtar dagens ordrar och lägger in dem i ett svep. Det andra är att butiken skickar en signal, en webhook, i samma ögonblick som ordern läggs, och att kundregistret tar emot den direkt.…