Var ska integrationen köras?

Kod i HubSpot eller en extern integrationsplattform – så bedömer ni vad som passar ert flöde.

Illustration av en integrationsplattform med köade körningar mellan affärssystemet och HubSpot.

Det går att anropa ett affärssystem från kod i ett HubSpot-workflow. Men när flera steg ska hänga ihop, ett API ibland svarar långsamt eller misslyckade överföringar behöver köras om blir platsen där integrationen körs ett viktigt beslut. En välbyggd integrationsplattform ger bättre möjligheter att styra och följa hela flödet.

Börja med vad en körning behöver klara

Anta att en affär i HubSpot ska bli en order i affärssystemet. Integrationen behöver kontrollera kunden, hämta information, skapa ordern och spara tillbaka ordernumret. Om något misslyckas efter att ordern skapats behöver nästa försök förstå vad som redan är gjort.

Det räcker därför inte att fråga om koden kan anropa båda systemen. Frågan är också hur arbetet fortsätter när svaret dröjer, när det kommer många beställningar samtidigt eller när ett steg redan har lyckats. Utgå från samma objekt, riktningar och triggers som i integrationsplanen.

När kod i HubSpot passar bra

HubSpots custom code actions kan vara användbara för avgränsade uppgifter nära ett workflow. Det kan handla om att formatera ett värde, göra en begränsad beräkning eller hämta en mindre mängd information inför nästa steg.

En fördel är att logiken ligger nära den process administratören redan arbetar med. Samtidigt behöver licensen stödja funktionen. HubSpot beskriver custom code actions för Data Hub Professional och Enterprise, med begränsningar för bland annat körningstid och minne. Den dokumenterade tidsgränsen är 20 sekunder per körning. Läs HubSpots aktuella dokumentation om custom code actions inför ett tekniskt vägval.

Det betyder att ett API-anrop som ibland tar 25 sekunder kan bli ett problem även om logiken i sig är enkel. Flera anrop i följd ska dessutom rymmas inom samma körningstid.

Vad en integrationsplattform tillför

I en extern integrationsplattform kan flödet organiseras som ett eget arbete med körningshistorik, regler för fel och tydliga anslutningar till systemen. Vilka möjligheter som finns beror på plattformen och hur lösningen är byggd.

För integrationer med affärssystem är följande egenskaper särskilt användbara:

  • Köer som tar emot arbete och låter det behandlas i kontrollerad takt.
  • Återförsök med väntetid när ett tillfälligt fel uppstår.
  • Körningshistorik som visar vilket steg som lyckades eller misslyckades.
  • Hantering av upprepade meddelanden utan att skapa samma kund eller order igen.
  • Möjlighet att justera ett flöde och följa konsekvenserna över tid.

En plattform gör inte automatiskt en integration driftsäker. Det är dessa egenskaper, tillsammans med genomtänkta flöden och ansvar, som ger värdet.

Ett konkret fall: ordern skapades men svaret försvann

Affärssystemet tar emot beställningen och skapar ordern. Precis därefter bryts anslutningen, innan integrationen har fått ordernumret. Från integrationens perspektiv ser anropet ut att ha misslyckats.

Om nästa körning bara gör om skapandet kan det bli en dubblett. En genomtänkt lösning skickar eller sparar därför en beständig referens som går att använda för att kontrollera om ordern redan finns. Samma begäran ska ge samma affärsmässiga resultat även om den hanteras igen. Det brukar kallas idempotens.

Plattformen kan ge verktygen för att bygga detta, men reglerna behöver väljas utifrån vad affärssystemets API faktiskt stödjer. Läs även om offert–order-konvertering och identifierare.

Köer hjälper när volymen varierar

Ett flöde som fungerar med en order kan bete sig annorlunda när flera hundra order ändras samtidigt. Både HubSpot och affärssystemet kan begränsa hur snabbt anrop får göras.

En kö gör det möjligt att skilja mottagandet av en händelse från själva bearbetningen. Flödet kan anpassa takten och vänta när systemen behöver det. För uppdateringar av samma order behöver ni också ta ställning till ordningsföljden, så att en äldre uppdatering inte skriver över en nyare.

Fråga vad som händer vid en första historisk inläsning, en större ändring eller efter ett driftavbrott. Det är ofta då köhanteringen visar sitt värde.

Workflows och plattform kan komplettera varandra

Valet behöver inte innebära att all logik flyttas från HubSpot. Ett workflow kan exempelvis markera att en affär är redo för överföring, medan plattformen hanterar kommunikationen med affärssystemet. Resultatet kan sedan återföras till HubSpot.

Det blir viktigt att skilja mellan att en begäran har tagits emot och att ordern verkligen har skapats. Användaren bör kunna förstå om överföringen pågår, har lyckats eller kräver hjälp.

Även valet av app och autentisering behöver passa arkitekturen. Att använda en extern plattform tar inte bort behovet av rätt behörigheter och säker hantering av anslutningen.

Fråga partnern vad som redan finns

Partners som arbetar återkommande med HubSpot-integrationer har ofta en plattform och återanvändbara komponenter för körningar, anslutningar och felsökning. Cedeo bygger och förvaltar integrationer mellan HubSpot och affärssystem med ett sådant helhetsperspektiv.

Be att få se ett exempel på en misslyckad körning och hur den hanteras. Fråga hur ansvar, loggning, larm och återkörning ingår i leveransen. Vår guide om drift och övervakning går djupare i den delen.

Vanliga frågor om var integrationen ska köras

Kan hela integrationen ligga i ett HubSpot-workflow?

I vissa fall. Det beror på licens, omfattning, körningstid och kraven på felhantering. Bedöm hela flödet, inklusive misslyckade och upprepade körningar.

Varför är en extern plattform ofta lämplig för affärssystem?

Den ger utrymme för sammanhängande flöden, köhantering, återförsök och driftuppföljning. Fördelen uppstår när dessa delar används och konfigureras rätt.

Har HubSpot ingen egen felhantering?

Jo. Custom code actions har loggar och dokumenterade återförsök för vissa fel. Det ersätter däremot inte en bedömning av hela integrationsflödets behov.

Behöver vi själva äga en integrationsplattform?

Inte alltid. En partner kan tillhandahålla plattform och förvaltning som en del av tjänsten. Klargör åtkomst, ansvar och vad som händer om samarbetet förändras.

Vill ni välja ett hållbart upplägg?

Vi hjälper er att bedöma vad som bör ligga i HubSpot och vad som passar bättre i integrationsplattformen. Se våra integrationsmöjligheter eller kontakta Cedeo.

Alla guider om HubSpot-integrationer