E-mail roundtrip

Formulář může vrátit úspěch a přitom nedoručit e-mail (rozbitý SMTP, spam filtr). Roundtrip tohle ověří: care do formuláře vloží unikátní token jako součást adresy odesílatele a počká, jestli e-mail s tím tokenem reálně dorazí do naší schránky.

Probe adresa

care přijímá testovací e-maily na subdoméně check.care.codebros.cz. Používá plus adresu s unikátním tokenem:

probe+<token>@check.care.codebros.cz

Subdoména má vlastní příjem (subaddressing je zapnutý), takže probe+cokoli@check.care.codebros.cz dorazí k nám a token si vytáhneme z části za +.

Jak formulář nastavit na roundtrip

Aby roundtrip fungoval, potvrzovací e-mail z formuláře musí jít odesílateli (ne jen majiteli), protože jako odesílatele používáme probe adresu. V praxi:

1. Formulář má testovací režim (care_test + token), který u testu nevytvoří lead, ale nechá odejít autoreply odesílateli.
2. care do pole s e-mailem odesílatele vloží probe+<token>@check.care.codebros.cz.
3. Autoreply dorazí na probe adresu, care spáruje token a kontrola projde.

Pokud formulář žádný autoreply odesílateli neposílá, roundtrip nemá co ověřit. Pak buď autoreply doplň, nebo nech kontrolu jen v režimu odeslání (kind: form).

Konfigurace kontroly

V funkční kontrole nastav kind: "email_roundtrip" a v email:

{
  "email": {
    "verify": true,
    "tokenIn": "plusAddress",
    "probeAddress": "probe@check.care.codebros.cz"
  }
}

• tokenIn: "plusAddress": care poskládá probe+<token>@check.care.codebros.cz a dá ho jako adresu odesílatele. Tohle je preferovaná varianta.
• tokenIn: "field": token jde do pole email.field (použij, když formulář posílá token v těle e-mailu, který dorazí k nám).

Časování

care po odeslání čeká na doručení zhruba 90 sekund. Když do té doby e-mail nedorazí, kontrola selže a vznikne incident.