Si funksionojnë formularët

Një formular mban dy kopje të asaj që shohin vizitorët. document është skica që redaktoni, dhe publishedDocument është ajo që përdorin faqja e strehuar, ngulitja dhe endpoint-i i regjistrimit. Ruajtja ndryshon vetëm skicën, dhe POST /forms/{id}/publish e kopjon atë në versionin aktiv. hasUnpublishedChanges ju tregon se të dyja ndryshojnë.

• —draft: nuk është publikuar kurrë. Askush nuk mund ta shohë ose të regjistrohet përmes tij.
• —live: i publikuar dhe pranon regjistrime.
• —paused: i publikuar, por i mbyllur. Faqja shfaq mesazhin e mbylljes nga tekstet e tij dhe regjistrimet refuzohen.

settings janë ndryshe: ku shkojnë regjistrimet, konfirmimi i dyfishtë, dërguesi, çfarë ndodh pas regjistrimit dhe kush njoftohet për çdo regjistrim. Ato zbatohen sapo ruhen, pavarësisht nëse formulari është publikuar apo jo.

Një dokument është një listë fields, tekstet copy përreth tyre dhe një style. Çdo fushë hyrëse ka një key, që është emri nën të cilin dërgohet përgjigjja e saj: një shkronjë e vogël e ndjekur nga deri në 39 shkronja të vogla, shifra ose nënvija, unik në formular dhe që nuk fillon kurrë me oe_. Çdo formular ka saktësisht një fushë email, me çelësin email dhe të detyrueshme.

• —Fusha hyrëse: email, text, textarea, number, phone, url dhe date.
• —Zgjedhje: select, radio dhe checkboxes, secila me options.
• —checkbox për një po ose jo, dhe consent për një kutizë që duhet shënuar kur është e detyrueshme.
• —audiences i lejon personit të zgjedhë lista: çdo value e një opsioni është një id audience në këtë hapësirë pune.
• —hidden mbart një vlerë që vizitori nuk e sheh kurrë: atë që dërgon faqja juaj, ose përndryshe defaultValue e saj, si emri i një fushate.
• —heading, paragraph dhe divider vetëm e strukturojnë formularin dhe nuk dërgojnë asgjë.

Vendosni mapsTo në firstName, lastName ose name te një fushë teksti, dhe përgjigjja bëhet emri i kontaktit që krijon regjistrimi. Një kontakt që ekziston tashmë e mban emrin e vet. Çdo përgjigje ruhet te parashtrimi, me etiketën që kishte, ndaj parashtrimet e vjetra lexohen ende saktë pasi ndryshon formulari.

Publikojeni fillimisht. Pastaj përdorni cilëndo nga të tria mënyrat që i përshtatet faqes. Të gjitha arrijnë te i njëjti formular dhe numërojnë të njëjtat regjistrime. Shikimet numërohen vetëm në faqen e strehuar dhe te ngulitja, ndaj regjistrimet përmes HTML-së ose kodit tuaj e rritin shkallën e konvertimit.

• —Faqja e strehuar te url, një faqe më vete së cilës mund t'i vendosni lidhje nga kudo.
• —Skripti i ngulitjes, që e vendos formularin në faqen tuaj brenda një kuadri që e përshtat vetë madhësinë e vet.
• —HTML-ja ose kodi juaj, që i dërgon përgjigjet te subscribeUrl.

<script src="https://openemail.uk/embed/form.js" data-openemail-form="frm_3b9d2e7a1c4f80d56e2a9b14" async></script>

<form action="https://api.openemail.uk/subscribe/frm_3b9d2e7a1c4f80d56e2a9b14" method="post">  <input type="email" name="email" required>  <div style="position:absolute;left:-9999px" aria-hidden="true">    <input type="text" name="oe_website" tabindex="-1" autocomplete="off">  </div>  <button type="submit">Subscribe</button></form>

Një formular HTML i thjeshtë ridrejtohet te faqja e falënderimit, ose te settings.redirectUrl. Kodi që dërgon JSON merr në vend të kësaj një përgjigje JSON, të përshkruar në faqen e regjistrimit.

Kur settings.doubleOptIn është aktiv, një regjistrim ruhet si pending dhe personit i dërgohet me email një lidhje nga settings.senderAddress, një adresë e kësaj hapësire pune. Ai hyn në audiencat kur e hap. Lidhja vlen shtatë ditë. Një person që është çregjistruar më parë nga një audiencë regjistrohet sërish vetëm në këtë mënyrë, kurrë përmes një formulari pa konfirmim të dyfishtë. Regjistrimi sërish para konfirmimit përditëson regjistrimin në pritje në vend që të shtojë një tjetër.

Për të mbrojtur njerëzit të cilëve u dërgoni email, një adresë merr më së shumti një konfirmim për formular çdo dhjetë minuta dhe pesë në ditë në gjithë hapësirën e punës. Mund ta miratoni vetë një regjistrim në pritje, ose t'i dërgoni një lidhje të re.

• —Leximi kërkon forms:read dhe ndryshimi kërkon forms:write. Miratimi i një regjistrimi kërkon edhe contacts:write, sepse shton një kontakt.
• —Çdo gjë që e bën një formular të dërgojë postë kërkon edhe emails:send: aktivizimi i konfirmimit të dyfishtë, caktimi i dërguesit ose i emailit të konfirmimit, publikimi ose rifillimi i një formulari me konfirmim të dyfishtë, dhe ridërgimi i një konfirmimi.
• —Një çelës API dhe pronari shohin çdo formular në hapësirën e punës. Një aplikacion që e lidhi një anëtar sheh vetëm formularët që krijoi ai anëtar, dhe vetëm audiencat që krijoi ai anëtar, si edhe ato të integruara.
• —Krijimi, përditësimi, publikimi, rifillimi ose dyfishimi i një formulari, dërguesi ose adresat e njoftimit të të cilit janë jashtë asaj që mund të arrijë një çelës ose aplikacion i kufizuar, merr përgjigjen 422 capability_unsupported.
• —Një çelës ose aplikacion i kufizuar në disa adresa mund të caktojë si dërgues dhe si adresa njoftimi vetëm adresa që i mban.
• —Fshirja e një formulari i kërkon një aplikacioni OAuth një kod verifikimi, siç bëjnë edhe ndryshimet e tjera shkatërruese. Një çelës API nuk ka nevojë kurrë për të.

Webhook-et form.submitted dhe form.confirmed i njoftojnë sistemet tuaja për çdo regjistrim. Një webhook i kufizuar në disa adresa nuk i merr kurrë, sepse regjistrimet i përkasin gjithë hapësirës së punës.

• —Një fushë me emrin oe_website është një kurth për botët: mbajeni bosh dhe jashtë ekranit, siç bën HTML-ja më sipër. Një regjistrim që e plotëson merr një përgjigje normale dhe hidhet poshtë.
• —Faqja e strehuar dhe ngulitja kontrollojnë gjithashtu një kohë fillimi të nënshkruar, dhe një formular i kthyer më shpejt se ç'mund ta plotësonte një person hidhet poshtë në të njëjtën mënyrë.
• —Një rrjet mund të dërgojë 40 regjistrime në dhjetë minuta, në të gjithë formularët tuaj së bashku dhe pavarësisht nga rezultati. Pas kësaj, kodi që dërgon JSON merr 429 form_rate_limited, dhe një formular HTML i thjeshtë shkon te faqja e strehuar me ?outcome=limited.
• —Si parazgjedhje, një hapësirë pune mban 100 formularë.

Gjithçka këtu është edhe në SDK si openemail.forms dhe në CLI si openemail forms, dhe serveri MCP ka vegla për formularët, ndaj një agjent mund të ndërtojë, të publikojë dhe të ndjekë një formular. Përmes MCP, klienti e shkruan vetë dizajnin dhe e kalon si document.

Dërgimi te subscribeUrl nga kodi juaj nuk kërkon kredenciale. Dërgoni përgjigjet si JSON, shtoni faqen ku ishte formulari si oe_source, lini jashtë oe_started, dhe dërgojeni oe_website bosh ose mos e dërgoni fare. Të gjitha regjistrimet nga një rrjet ndajnë kufirin prej 40 në çdo dhjetë minuta, ndaj një server që përcjell regjistrime për shumë njerëz e arrin shpejt: njerëzit që i njihni tashmë shtojini më mirë me importin e audiencës.