Si funksionojnë automatizimet

Një definition ka një trigger, hapin entry dhe një listë steps. Çdo hap ka një key që është unik në automatizim: një shkronjë e vogël e ndjekur nga 2 deri në 23 shkronja të vogla ose shifra. Një hap emërton atë që e pason te next, dhe një branch emërton dy, yes dhe no. null e mbyll atë rrugë. Hapat formojnë një pemë, ndaj në asnjë hap nuk arrihet nga dy vende dhe asgjë nuk kthehet pas. Një automatizim mban deri në 50 hapa, me degëzime më së shumti 5 nivele të thella.

• —audience_joined: një kontakt shtohet te audienceId. Kontaktet e shtuara nga një importim lihen jashtë, përveç nëse includeImported është true.
• —form_submitted: një person regjistrohet përmes formularit formId. Me konfirmim të dyfishtë, ai hyn kur konfirmon.
• —event: kodi juaj dërgon një ngjarje me emrin eventName. Deri në 5 filters mbi vetitë e saj ngushtojnë se kush hyn.
• —date: një ditë mbërrin për çdo anëtar të audienceId. field është birthday ose joined, përvjetori i ditës kur hyri në atë audiencë. offsetDays e zhvendos deri në një vit: negativ për ditë para, pozitiv për ditë pas.
• —manual: askush nuk hyn vetë. Personat i shtoni nga aplikacioni ose me endpoint-in e regjistrimit.

Një vlerë te props ose update_field vjen nga një prej tri vendeve: { "source": "static", "value": "…" }, { "source": "contact", "field": "firstName" } për email, name, firstName, lastName ose attributes.<key>, dhe { "source": "event", "path": "orderId" } për një veti të ngjarjes që e nisi rrugëtimin.

Ruajtja ndryshon definition e skicës. Asgjë nuk ekzekutohet derisa POST /automations/{id}/publish ta ngrijë skicën si një version të numëruar, të cilin published e shfaq më pas. Personat që janë tashmë brenda përfundojnë me versionin me të cilin hynë, dhe ata që hyjnë më pas marrin të riun. hasUnpublishedChanges thotë se skica ka ecur përpara.

• —draft: asnjëherë i publikuar. Askush nuk hyn.
• —live: i publikuar dhe në punë.
• —paused: askush nuk hyn dhe të gjithë brenda qëndrojnë aty ku janë. pausedReason thotë pse: manual, ose një problem që hasi motori, si sender_refused ose template_unavailable.
• —archived: i tërhequr përgjithmonë. Të gjithë brenda dalin, dhe historiku mbetet.

settings janë të ndara dhe zbatohen sapo ruhen: timezone, një sendWindow jashtë të cilit email-et presin, reentryDays para se i njëjti person të mund të hyjë sërish (null do të thotë vetëm një herë), exitOnLeave për të nxjerrë personat që largohen nga audienca e nisësit, dhe listAudienceId, audienca ku regjistrohet një çregjistrim.

problems liston çfarë nuk shkon me skicën, secilin me një code, path e fushës, stepKey dhe nëse është blocking. Një skicë me një problem bllokues nuk mund të publikohet.

Çdo person që hyn merr një regjistrim. Ai është active ndërsa personi kalon nëpër hapa, completed kur arrin në fund të një rruge, dhe exited kur del më herët, me një exitReason: exit_step, unsubscribed, suppressed, left_audience, removed, archived ose failed.

• —Hapat ekzekutohen rreth 15 sekonda pasi u vjen radha. Një person nuk merr kurrë dy email-e nga i njëjti automatizim në të njëjtin kalim.
• —Email-et e automatizimeve janë postë marketingu, ndaj secili mban një lidhje çregjistrimi. Një person që çregjistrohet del nga automatizimet që i shkruajnë asaj liste, dhe ai, adresa e të cilit pati kthim ose u ankua, del te hapi i tij i radhës.
• —Një email, adresa e të cilit nuk mund të marrë postë, anashkalohet, dhe personi vazhdon te hapi tjetër.
• —Kur një dërgim refuzohet për të gjithë, si një dërgues që humbi domenin ose një shabllon që u çpublikua, automatizimi pezullohet dhe pausedReason thotë pse.

POST /events regjistron se një kontakt bëri diçka: order.placed, trial.started, plan.upgraded. Një ngjarje nis çdo automatizim aktiv, nisësi i të cilit e emërton, çon përpara këdo që po e pret, dhe i përgjigjet pyetjes event të një degëzimi. Ngjarjet mbahen 90 ditë.

• —Leximi kërkon automations:read dhe ndryshimi kërkon automations:write. Publikimi, rifillimi dhe dërgimi i një prove kërkojnë edhe emails:send, sepse e bëjnë automatizimin të dërgojë postë.
• —Dërgimi i një ngjarjeje kërkon contacts:write, dhe leximi i ngjarjeve të një kontakti kërkon contacts:read.
• —Një çelës API dhe pronari shohin çdo automatizim në hapësirën e punës. Një aplikacion që e lidhi një anëtar sheh ato që krijoi ai anëtar.
• —Fshirja e një automatizimi i kërkon një aplikacioni OAuth një kod verifikimi. Një çelës API nuk ka nevojë kurrë për të.
• —Një plan lejon 1 automatizim aktiv në Free, 10 në Starter, 50 në Business dhe çdo numër në Enterprise. Si parazgjedhje, një hapësirë pune mban 100 automatizime.

Webhook-ët automation.entered, automation.exited dhe automation.paused u tregojnë sistemeve tuaja kush hyri, kush doli dhe kur u ndal një automatizim. Arkivimi i një automatizimi u jep fund të gjithëve në të, pa një ngjarje automation.exited për secilin person.

Gjithçka këtu gjendet edhe në SDK si openemail.automations dhe openemail.events, dhe në CLI si openemail automations dhe openemail events. Serveri MCP ka vegla automatizimi, ndaj një agjent mund të ndërtojë një, ta publikojë dhe të shohë kush është brenda.