Sistemske integracije: povezovanje orodij, ki jih že uporabljate

Sistemska integracija je povezava, ki premika podatke med orodji, ki jih vaše podjetje že uporablja, kot so trgovina, CRM, računovodski program, e-pošta in preglednice, tako da jih nikomur ni treba prepisovati ročno. Namenjena je podjetjem, ki so prerasla pretipkavanje in posredovanje, a nočejo zamenjati sistemov, ki delujejo.

Ključne ugotovitve

• Pri integraciji gre za zanesljivo premikanje podatkov med sistemi, ki jih obdržite, ne za nakup novega sistema.
• API-ji omogočajo, da sisteme vprašamo po podatkih; webhooki omogočajo, da sistemi sami sporočijo spremembe. Večina integracij uporablja oboje.
• Orodje za delovne tokove, kot je n8n, pokrije mnogo primerov. Koda po meri je za velik obseg, zapleteno logiko ali tam, kjer ni povezovalnika.
• Podatki ostanejo vaši: vaši računi, vaše podatkovne baze, vaši izvozi. Vztrajajte pri tem v vsaki pogodbi.
• Gostovanje v EU in jasne vloge obdelave po GDPR sta odločitvi, ki ju sprejmete pred prvo povezavo, ne po njej.
• Vsaka integracija kdaj odpove. Spremljanje, ponovni poskusi in oseba, ki je obveščena, so del razvoja.

Trije mehanizmi

API-ji. Programski vmesnik je način, kako en sistem drugemu omogoči branje ali zapisovanje svojih podatkov v strukturirani obliki. Vaša trgovina ima API, ki lahko našteje današnja naročila; vaš računovodski sistem ima API, ki lahko ustvari račun. Integracija pokliče prvega, preoblikuje rezultat in pokliče drugega.

Webhooki. Namesto da bi sistem vsakih nekaj minut spraševali, ali se je kaj spremenilo, webhook sistemu omogoči, da pošlje sporočilo v trenutku, ko se nekaj zgodi: novo naročilo, plačan račun, oddan obrazec. Webhooki naredijo integracije takojšnje in zmanjšajo nepotreben promet.

Orodja za delovne tokove. Izdelki, kot je n8n, ponujajo vizualno platno, na katerem se koraki povezujejo: sprejmi webhook, poišči stranko, razvej glede na polje, zapiši v preglednico, pošlji sporočilo. Prihajajo s povezovalniki za pogoste sisteme in jih je mogoče gostiti pri sebi (https://docs.n8n.io/hosting/), kar je pomembno za to, kje se vaši podatki obdelujejo.

Kdaj orodje za delovne tokove zadošča

Orodje za delovne tokove ustreza, kadar:

• imajo vključeni sistemi pripravljene povezovalnike ali čiste API-je;
• je obseg zmeren: stotine ali nekaj tisoč dogodkov na dan, ne milijoni;
• je logika zaporedje korakov z nekaj razvejitvami, ne dolg algoritem;
• ljudje, ki bodo tok pozneje prilagajali, niso razvijalci, a morajo videti, kaj počne.

Za mnoga mala in srednje velika podjetja to pokrije večino prvega leta avtomatizacije: usmerjanje povpraševanj, obvestila o naročilih, predajo računov, sestavljanje poročil, objavljanje na družbenih omrežjih.

Kdaj je potrebna koda po meri

Koda po meri si zasluži svoje mesto, kadar:

• sistem nima API-ja ali povezovalnika in je treba podatke izluščiti iz datotek, portalov ali e-poštnih prilog;
• so preoblikovanja zapletena: ujemanje izdelkov med katalogi, usklajevanje plačil, uporaba cenovnih pravil;
• obseg ali zahteve glede odzivnega časa presegajo to, kar izvajalnik delovnih tokov udobno zmore;
• je integracija del izdelka, ki ga prodajate, kjer morajo biti testi, različice in uvajanje strogi.

Oba pristopa se dobro dopolnjujeta. Pogost vzorec je orodje za delovne tokove za orkestracijo in majhne storitve po meri za težke korake. Odločitev, kje poteka meja, je zasnovna naloga in jo je treba ponovno pretehtati, ko obseg raste.

Lastništvo podatkov

Integracije se dotikajo vaših najdragocenejših podatkov: strank, naročil, računov. Tri pravila jih ohranjajo vaše.

1. Računi in poverilnice pripadajo podjetju, ne agenciji. API ključi, gostovanje, domene in instanca delovnih tokov so ustvarjeni na vaše ime, ljudje, ki so jih zgradili, pa imajo skrbniški dostop, ki ga lahko odvzamete.
2. Podatki živijo v sistemih, iz katerih jih lahko izvozite. Če integracija vodi lastno podatkovno bazo, imate dokumentiran način, kako dobiti vse ven.
3. Logika je dokumentirana v navadnem jeziku. Za vsak tok: kaj ga sproži, kaj bere, kaj zapisuje in kdo je obveščen, ko odpove. Dovolj sta diagram in ena stran besedila.

Gostovanje v EU in vloge po GDPR

Večina podatkov v integracijah je osebnih podatkov po GDPR, Uredbi (EU) 2016/679 (https://eur-lex.europa.eu/eli/reg/2016/679/oj). Iz tega sledita dve odločitvi.

Kje se podatki obdelujejo. Izvajanje izvajalnika delovnih tokov in morebitnih podatkovnih baz na strežnikih v EU se izogne vprašanjem, ki jih prinašajo prenosi v tretje države (poglavje V Uredbe). Mnoge povezane storitve same delujejo izven EU; zanje preverite pogoje ponudnika in mehanizem prenosa, na katerega se opirajo.

Kdo je upravljavec in kdo obdelovalec. Vaše podjetje odloča, zakaj in kako se obdelujejo podatki strank; je upravljavec (člen 4(7)). Agencija, ki v vašem imenu gradi in upravlja integracijo, in vsaka storitev, ki za vas obdeluje podatke, nastopa kot obdelovalec (člen 4(8)) in potrebuje pisno pogodbo o obdelavi podatkov po 28. členu. To je standardna dokumentacija. Bistvo je, da je urejena, preden stečejo pravi podatki, in da integracijo vključite v svojo evidenco dejavnosti obdelave (30. člen).

AI koraki v toku, na primer model, ki prebere e-pošto in jo razvrsti, so prav tako obdelava. Ponudnik tega modela je tudi obdelovalec in njegovi pogoji morajo navajati, kaj počne s podatki, ki mu jih pošljete.

Spremljanje in obravnava napak

Integracija, ki mesece tiho deluje, bo nekega dne odpovedala: API se spremeni, žeton poteče, polje je preimenovano, storitev ne deluje. Zasnujte jo za to.

• Ponovni poskusi ob začasnih napakah, z omejitvijo, da kratek izpad ne izgubi dogodkov.
• Čakalna vrsta, v kateri neuspeli dogodki čakajo na ponovno obdelavo, namesto da bi izginili.
• Opozorila osebi, po e-pošti ali klepetu, ko tok odpove več kot določeno število krat ali ni tekel, ko bi moral.
• Dnevniki, ki za vsak dogodek pokažejo, kaj je prišlo noter in kaj je šlo ven, hranjeni dovolj dolgo za preiskavo.
• Mesečni pregled žetonov, različic povezovalnikov in obsega.

Obravnava napak je tudi mesto, kamor sodijo ljudje. Tok, ki se ne more odločiti, na primer račun, ki se ne ujema z nobenim dobaviteljem, naj ustvari nalogo za osebo, namesto da bi ugibal.

Ohranjanje nadzora v ekipi

Podjetja, ki od integracij dobijo trajno vrednost, so tista, katerih lastni ljudje jih lahko vidijo in prilagajajo. Praktični koraki: vodji operative dajte dostop do platna delovnih tokov, vodite seznam tekočih tokov z njihovimi skrbniki, dogovorite se, kdo odobri spremembo, in vsak nov tok poganjajte vzporedno z ročnim postopkom, dokler se ne izkaže.

Kako to počnemo pri Hot Skulls Labs

Vsako integracijo začnemo z odkrivanjem: proces pregledamo z ljudmi, ki ga izvajajo, in zapišemo vsak sistem, vsak korak in vsako odločitev. Iz tega narišemo tokove in označimo, kateri koraki so navadno premikanje podatkov in kateri potrebujejo presojo.

Naš privzeti vzorec je isti, kot ga uporabljamo pri vsem našem delu na področju avtomatizacije: sprožilec (webhook ali urnik), AI korak tam, kjer je potrebna presoja (razvrščanje, izluščenje, osnutki), korak človeške odobritve za vse, kar deluje navzven ali spreminja finančne zapise, in izvedba v ciljne sisteme. Navadne integracije AI korak preskočijo; občutljive nikoli ne preskočijo odobritve.

Najprej pilotiramo en tok in ga poganjamo ob ročnem postopku. Gradimo z n8n, kjer povezovalniki in obseg to dopuščajo, in pišemo storitve po meri v kodi, kjer ne; pogosto oboje teče skupaj. Gostujemo na strežnikih v EU, vse račune ustvarimo na ime stranke, pogodbo o obdelavi podatkov podpišemo, preden stečejo pravi podatki, in predamo dokumentacijo, ki poimenuje vsak tok, njegov sprožilec, skrbnika in opozorilo.

Delovanje je del dela. Tokove spremljamo, izjeme pregledujemo s stranko in prilagajamo, ko se sistemi in poslovanje spreminjajo. Ti vzorci so bili najprej zgrajeni in so tekli v Stradyju, našem lastnem izdelku, preden smo jih ponudili strankam.