Vodnik po konektorjih Brevo: štirje načini povezave z vašim naborom orodij

Ko iščete „Brevo connector”, dobite razpršeno mešanico vtičnikov s tržnice, aplikacij za avtomatizacijo drugih ponudnikov in modulov skupnosti. Razlog je preprost: „konektor” ni ena sama stvar. Je kategorija, ki pokriva štiri resnično različne inženirske odločitve, vsaka pa ima svoj način odpovedi in svojega lastnika, ko se kaj pokvari.

Ta vodnik opredeli, kaj konektor sploh je, pošteno predstavi štiri pristope, nato pa največ prostora nameni delu, ki ga skoraj noben članek ne pokrije: kaj gre narobe, ko konektor teče v živo in prenaša pravi promet.

Kaj konektor Brevo v resnici je

Ko odstranite blagovno znamko, je vsak konektor Brevo sestavljen iz istih treh komponent.

Prenos. Kako se podatki fizično premikajo. V praksi to pomeni klice v Brevo REST API v eno smer in webhooke Brevo v drugo. Brevo webhooke deli na trženjske in transakcijske, nastavljive z nadzorne plošče ali prek končnih točk za ustvarjanje in posodabljanje webhookov, z zgornjo mejo 40 webhookov na račun za oba tipa skupaj.

Preslikava. Kako polje v izvornem sistemu postane polje v platformi Brevo. Stranka Shopify ima first_name, stik Brevo pa ima tisti atribut, ki ste ga določili sami, in Brevo tiho spregleda atribute, ki v vašem računu ne obstajajo. Preslikava je tisto mesto, kjer večina konektorjev neopazno razpade.

Stanje. Kaj si konektor zapomni med zagoni: katere zapise je že poslal, kateri so odpovedali, do katerega položaja kazalca je prišel. Konektorji brez stanja ne morejo izvesti ponovne polnitve, ne morejo znova predvajati napake in vam ne znajo povedati, ali stik manjka ali le zamuja.

Vsak konektor ocenite po tem, kako dobro obvlada vse tri dele. Večina trženjskih strani opisuje samo prvega.

Pod vsem tem leži problem identifikatorja

Končna točka za ustvarjanje stika v platformi Brevo zahteva vsaj en identifikator: email, SMS ali ext_id, kar je vaš lastni zunanji identifikator. Privzeto nasprotujoč si identifikator vrne napako 4xx. Nastavitev updateEnabled na true klic spremeni v upsert, forceMerge pa podvojene zapise združi tako, da obdrži zapis z najnovejšim časovnim žigom, drugega pa izbriše.

Ta ena sama odločitev o zasnovi, torej kateri identifikator vaš konektor obravnava kot primarnega, določa, ali boste imeli čisto bazo stikov ali vsega po dvakrat. Odločite se, preden izberete orodje.

Štirje načini povezave s platformo Brevo

Možnost 1: vtičniki ponudnika in aplikacije s tržnice

Brevo upravlja tržnico aplikacij, ki jo opisuje kot povezavo platforme Brevo s „150+ digitalnimi orodji, kot so Shopify, WordPress, Stripe, Zapier in druga”. Izpostavljene lastne aplikacije so WordPress, WooCommerce, Shopify in BigCommerce, tržnico pa je mogoče filtrirati po kategoriji in po tem, kdo je aplikacijo razvil. To je pomembneje, kot se sliši: aplikacija, ki jo je zgradil Brevo, in aplikacija partnerja imata zelo različni poti do podpore.

Prednosti. Najhitrejša pot do delujoče rešitve. Avtentikacija, osnovna preslikava polj in običajni dogodki so vnaprej ožičeni. Ko Brevo spremeni svoj API, ponudnik posodobi vtičnik.

Slabosti. Dobite preslikavo, ki jo je izbral ponudnik. Atributi po meri, nenavadni objekti in logika, značilna za posamezno trgovino, običajno ostanejo zunaj nje. Razhroščevanje je omejeno na to, kar vtičnik zapiše v dnevnik, kar pogosto ni nič uporabnega. In ko partnerjeva aplikacija ostane brez vzdrževanja, to izveste med izpadom.

Uporabite jo, kadar imate eno standardno platformo, standardna polja in nobene zahteve, da dokažete, kaj se je sinhroniziralo.

Možnost 2: splošna orodja iPaaS

Zapier, Make in Pabbly Connect vsi ponujajo Brevo. Brevo vgrajuje Zapier neposredno na svojo stran z integracijami pod naslovom „Connect Brevo with your apps, automate your work via Zapier”. Make objavlja aplikacijo Brevo, katere moduli pokrivajo spremljanje, ustvarjanje, posodabljanje, izpisovanje in brisanje stikov, seznamov, map, kampanj, dogodkov, e-pošte in sporočil SMS. Pabbly Connect Brevo navaja med podprtimi aplikacijami.

Prednosti. Resnično odlična izbira za dolgi rep. Ponudnik obrazcev, za katerega ni še nihče slišal, enkratno interno orodje, korak odobritve, ki potrebuje človeka vmes: iPaaS to reši v enem popoldnevu, scenarij pa lahko vzdržuje tudi nekdo, ki ni razvijalec.

Slabosti. Zaračunavanje na opravilo kaznuje obseg. Večina scenarijev obdeluje po en zapis naenkrat, zato je ponovna polnitev 40.000 stikov bodisi nemogoča bodisi draga. Obravnava napak je običajno „zagon je odpovedal, tukaj je e-poštno sporočilo”, brez samodejnega ponovnega predvajanja in brez načina, da bi vprašali, kateri zapisi prejšnjega torka nikoli niso prispeli. Vrstni red ni zagotovljen, zato lahko posodobitev prehiti ustvarjanje zapisa, od katerega je odvisna.

Uporabite ga, kadar je obseg majhen, tok enosmeren in izgubljen zapis bolj nadležen kot drag. Naš pregled najboljših integracijskih platform neposredno primerja možnosti v tej kategoriji.

Možnost 3: namensko zgrajena integracijska plast

Plast, ki sedi med vašimi sistemi in platformo Brevo, prevzame lastništvo nad preslikavo in stanjem sinhronizacije ter je zgrajena prav za to nalogo, ne za povezovanje poljubne aplikacije s poljubno.

Tajo je ena takih možnosti. Opisuje se kot trženjska ekipa z umetno inteligenco za Brevo, ki podprte podatke o trgovini poveže z Brevom, gradi segmente strank na podlagi pravil ter pripravlja nadzorovane kampanje po e-pošti in SMS. V praksi je kompromis vsake namensko zgrajene plasti enak: sprejmete premišljeno določen model stikov, dogodkov in kampanj, v zameno pa dobite ponovne polnitve, ponovne poskuse in vpogled v vsak zapis posebej, česar vam ne dasta niti vtičnik niti splošni iPaaS. Naš vodnik po integraciji Brevo vas skozi nastavitev popelje od začetka do konca.

Prednosti. Množične operacije so prvorazredne. Odpovedi so vidne za vsak zapis in jih je mogoče znova predvajati. Preslikava je izrecna in verzionirana, ne pa zakopana v vtičniku.

Slabosti. Še en ponudnik na poti in še ena stvar za oceno. Če je vaša zahteva en obrazec WordPress, ki objavlja na en seznam Brevo, je to težka mehanizacija za majhno opravilo. Bodite iskreni glede tega: tam je vtičnik boljša izbira.

Uporabite jo, kadar je obseg podatkov o trgovini resničen, morate dokazati, kaj se je sinhroniziralo, in želite segmente ter logiko kampanj, zgrajene na istem podatkovnem modelu, ki ga proizvede sinhronizacija.

Možnost 4: neposredna integracija prek vmesnika API

Vaša lastna koda proti vmesniku Brevo API.

Prednosti. Brez zgornje meje. Razreševanje identitete, paketno pošiljanje, pravila ponovnih poskusov in revizijsko beleženje nadzorujete natanko tako, kot želite. Za podatkovno skladišče, ki v Brevo potiska modelirana občinstva, je to pogosto edini ustrezen pristop.

Slabosti. Lastniki ste za vedno, tudi tistih delov, ki jih nihče ne predvidi: ponovni poskusi z zakasnitvijo, shramba za neuspešna sporočila, opozorila o zdrsu sheme, menjava poverilnic in navodila za ukrepanje. Ekipe načrtujejo proračun za srečno pot, nato pa trikrat toliko porabijo za vse drugo.

Uporabite jo, kadar je logika resnično vaša in jo obseg upravičuje. Začnite pri našem vodniku po Brevo API, kjer so podrobnosti na ravni končnih točk.

Okvir za odločitev

O tem odloči šest vprašanj. Odgovorite nanje, preden pogledate katero koli orodje.

Zadnja vrstica je tista, ki jo ljudje preskočijo in nato obžalujejo. Konektor je dolgoročna operativna zaveza, ne enkratna nastavitev, zato izberite možnost, s katere načinom odpovedi lahko živite.

Vzorci sinhronizacije, ki odločajo, ali stvar deluje

Enosmerno proti dvosmernemu

Enosmerna sinhronizacija ima enega lastnika na polje in je dolgočasna v najboljšem pomenu besede. Dvosmerna sinhronizacija zahteva zadušitev zank, razreševanje sporov in pravilo za odločanje ob izenačenju, Brevo pa bo z veseljem oddal webhook contact_updated za spremembo, ki jo je pravkar zapisal vaš lastni konektor.

Ne gradite dvosmerne sinhronizacije zato, ker zveni zmogljivejše. Namesto tega naredite tabelo lastništva polj: vaša platforma za e-trgovino je lastnica podatkov o naročilih, vaš CRM je lastnik faze življenjskega cikla, Brevo je lastnik privolitev in angažiranosti. Vsako polje sinhronizirajte le v eno smer. Če za neko polje res potrebujete dvosmerni prenos, vsakemu zapisu dodajte oznako izvora in zavrzite vhodne dogodke, ki nosijo vašo lastno oznako.

Poizvedovanje proti webhookom

Webhooki so cenejši in hitrejši, a niso zajamčeni. Med trženjske dogodke webhookov spadajo delivered, opened, click, hard_bounce, soft_bounce, spam, unsubscribe, contact_updated, contact_deleted in list_addition. Transakcijski webhooki pokrivajo življenjski cikel pošiljanja od sent in delivered prek deferred, blocked, complaint in error.

Načrtujte dve stvari. Prvič, dokumentacija Brevo o webhookih se osredotoča na uvrščanje objavljenih naslovov IP platforme Brevo na seznam dovoljenih, ne na podpis vsebine, zato končno točko privzeto obravnavajte kot neavtenticirano in vse pomembno potrdite tako, da zapis preberete nazaj prek vmesnika API. Drugič, noben sistem webhookov ne dostavi vsega za vedno, zato webhooke združite z redkim usklajevalnim poizvedovanjem, ki ujame vse, kar je pobegnilo.

Paketno proti realnemu času

Realni čas je pomemben pri prožilcih, zato si opuščene košarice in pozdravni tokovi zaslužijo klice dogodkov. Pri nočnem osveževanju atributov ni pomemben.

Vzorec uskladite z omejitvami zahtev. Končne točke za stike in končna točka POST /v3/events na standardnih računih dovoljujejo 10 zahtev na sekundo, transakcijska e-pošta 1.000 na sekundo, vse druge končne točke pa so omejene na 100 zahtev na uro. Računa Professional in Enterprise prvo skupino približno podvojita. Prav ta meja 100 na uro za „vse druge končne točke” je najpogostejše presenečenje: konektor, ki ob vsakem zapisu bere sezname ali mape, jo bo izčrpal še pred kosilom in začel zbirati odgovore HTTP 429.

Za množično delo namesto zank uporabite končno točko za uvoz. Sprejme URL datoteke, telo datoteke ali telo JSON do 10 MB z varno mejo 8 MB, teče asinhrono, vrne processId in ob zaključku pokliče obvestilni URL.

Idempotentnost in identiteta

Končna točka za dogodke v platformi Brevo sprejme event_name, vsaj en identifikator, neobvezne lastnosti stika in neobvezne lastnosti dogodka do 50 KB, ob uspehu pa vrne 204. Dokumentiranega ključa idempotentnosti ni, zato lahko ponovljen klic ustvari podvojen dogodek.

Idempotentnost zgradite sami. Iz izvornega zapisa in njegove različice izpeljite determinističen ključ, shranjujte, katere ključe ste že poslali, in preverite pred pošiljanjem. Pri stikih izberite en primarni identifikator, ext_id napolnite z oznako iz izvornega sistema in za upsert uporabite updateEnabled, da ponovni poskus posodobi zapis namesto da vrne napako.

Zasnova ponovne sinhronizacije, ki ji lahko zaupate

Ponovno sinhronizacijo boste potrebovali. Načrtujte jo že prvi dan.

• Naj bo vsak zapis idempotenten, da je ponovno predvajanje varno in ne uničujoče.
• Za vsak tip objekta vodite kazalec in ga shranjujte zunaj pomnilnika konektorja.
• Ponovno sinhronizacijo preizkusite na začasnem seznamu Brevo, preden jo poženete na pravem.
• Med uvozi pustite emptyContactsAttributes na privzeti vrednosti false. Nastavitev na true platformi Brevo pove, da naj prazna polja izbrišejo obstoječe vrednosti, kar delni izvoz spremeni v trajno izgubo podatkov.
• Beležite izid za vsak zapis. „Opravilo je uspelo” ni izid, kadar 400 od 40.000 zapisov ni prestalo preverjanja.

Kaj gre v produkciji res narobe

Zdrs preslikave polj

Nekdo preimenuje metapolje Shopify ali doda obvezno polje na blagajni. Konektor teče naprej in še naprej javlja uspeh, ker Brevo prezre atribute, ki jih ne prepozna. Nekaj tednov pozneje je segment tiho napol prazen.

Ukrep. Naredite posnetek izvorne sheme in seznama atributov Brevo, ju redno primerjajte in sprožite opozorilo ob razliki. Prav tako opozarjajte na padec deleža nepraznih vrednosti po atributih, ne le na napake.

Podvojeni stiki

Klasičen vzrok sta dva konektorja z dvema identifikatorjema: vtičnik trgovine ustvarja stike po e-pošti, tok SMS jih ustvarja po telefonski številki, en človek pa postane dva zapisa z razdeljeno zgodovino angažiranosti.

Ukrep. En primarni identifikator, uveljavljen povsod. ext_id napolnite iz izvornega sistema, da imate vedno stabilen ključ za povezovanje. forceMerge uporabljajte kot namerni korak čiščenja, z zavedanjem, da izbriše starejši zapis, in ne kot rutinsko nastavitev.

Zanke sinhronizacije

Konektor A zapiše v Brevo, Brevo odda contact_updated, konektor B zapiše nazaj v izvorni sistem, ta odda svoj dogodek spremembe in krog se ponovi. Omejitve zahtev to običajno razkrijejo, preden opazite sami.

Ukrep. Oznake izvora ob vsakem zapisu, poleg tega števec sprememb na zapis, ki nad pragom v določenem časovnem oknu sproži alarm.

Omejitve zahtev in delne odpovedi

Prekoračitev omejitve vrne 429. Nevaren ni sam 429, ampak paket, v katerem so nekateri zapisi uspeli in drugi ne, konektor pa celoten paket obravnava kot neuspešen in ga ponovno pošlje ali pa ga obravnava kot uspešnega in izgubi odpovedi.

Ukrep. Ponovni poskusi z eksponentno zakasnitvijo in naključnim odmikom, upoštevajte morebitni namig o ponovnem poskusu in izide spremljajte po zapisih, ne po paketih. Odpovedi pošljite v shrambo za neuspešna sporočila skupaj s celotno vsebino, da jih je po popravku mogoče znova predvajati.

Tiha izguba podatkov

Najhujše odpovedi so tihe: uvoz s praznim stolpcem in emptyContactsAttributes, nastavljenim na true, atribut, ki ne obstaja več, zato njegove vrednosti izginejo, končna točka webhooka, ki uro dni vrača 500, pa nihče ne gleda.

Ukrep. Spremljajte števila, ne le napak. Ustvarjeni stiki na dan, prejeti dogodki na uro, delež zapolnjenih atributov. Metrika, ki pade na nič, je najjasnejše opozorilo, kar jih boste kdaj dobili.

Dva sistema, ki se ne strinjata

Sčasoma vaš izvorni sistem pravi 18.400 aktivnih stikov, Brevo pa 18.062. Brez usklajevanja ne veste, kateri ima prav.

Ukrep. Redno poganjajte usklajevanje, ki primerja števila in vzorec zapisov po identifikatorju, ter ustvarite poročilo o razlikah. Odpravljajte vzroke, ne pa vedno znova uvažajte, saj ponovni uvoz neskladje skrije, ne pa pojasni.

Pogoste povezave v praksi

E-trgovina. Shopify in WooCommerce sta težkokategornika in oba imata lastni aplikaciji na tržnici Brevo. Ta pot dobro obvlada stike in osnovne podatke o naročilih. Logika po meri na ravni postavk, stanje naročnin in stopnje zvestobe vanjo praviloma ne sodijo, in prav tu si plast ali koda po meri prisluži svoje mesto. Naš vodnik po integraciji Brevo s platformo Shopify to konkretno kombinacijo obravnava poglobljeno.

CMS. WordPress je najpogostejša povezava z Brevom zunaj e-trgovine, običajno za obrazce, prijavo na e-novice in transakcijsko e-pošto prek SMTP platforme Brevo. Pot z vtičnikom je tu skoraj vedno pravilna, saj je podatkovni model preprost in obseg majhen.

CRM in podatkovno skladišče. Tu konektorji postanejo zahtevni, ker obe strani verjameta, da sta lastnici stranke. Uporabite tabelo lastništva polj, vsako polje sinhronizirajte v eno smer in razmislite o potiskanju modeliranih občinstev iz skladišča na sezname Brevo, namesto da sinhronizirate surove zapise. Poglejte naš vodnik po Brevo CRM, kjer je opisano, kako se v to sliko vklopijo objekti CRM platforme Brevo.

Obrazci. Idealen primer uporabe za iPaaS: majhen obseg, ena smer, toleranca do zakasnitve. Ne pretiravajte z inženirstvom.

Kako to izpeljati pravilno

Izbira konektorja je večinoma vprašanje operativnega delovanja in ne funkcij. Vsaka možnost zna prenesti stik iz točke A v točko B. Razlikujejo se po tem, kaj se zgodi na dan, ko preslikava zdrsne, ko se sproži omejitev zahtev ali ko 400 zapisov znotraj uvoza 40.000 zapisov ne prestane preverjanja.

Lotite se tega v tem vrstnem redu:

1. Zapišite, kateri sistem je lastnik katerega polja. Vse drugo izhaja iz tega.
2. Izberite en primarni identifikator stika in ext_id napolnite iz izvornega sistema.
3. Izberite najlažjo možnost, ki preživi vaš obseg in vašo zahtevo po obravnavi napak, ne najzmogljivejše.
4. Ponovno sinhronizacijo in poročilo o usklajevanju zgradite pred zagonom v živo, ne po prvem incidentu.
5. Spremljajte števila in deleže zapolnjenosti, saj je tiha izguba pogostejša od glasne odpovedi.

Naredite teh pet stvari in deluje lahko kateri koli od štirih pristopov. Preskočite jih in ne bo deloval noben.

Sorodni članki

• Popoln vodnik po integraciji Brevo
• Nastavitev integracije Brevo s platformo Shopify
• Vodnik po Brevo API
• Vodnik po Brevo CRM
• 12 najboljših integracijskih platform (iPaaS)