Triggere: email, formular, webhook

Lectură estimată: 3 minute

Estimare pentru text, la un ritm de 180 de cuvinte pe minut. Timpul pentru analizarea codului, exerciții și proiecte se adaugă separat și depinde de ritmul tău.

O automatizare pornește dintr-un declanșator (trigger): un eveniment care spune „acum e momentul să rulezi". Cele mai comune sunt un e-mail primit, un formular completat și un webhook de la alt sistem. Alegerea și configurarea corectă a declanșatorului determină fiabilitatea întregului flux.

E-mail ca declanșator

Un e-mail nou într-o căsuță sau cu o etichetă anume pornește fluxul. Util pentru: cereri de suport, comenzi prin e-mail, notificări de la sisteme fără API. Atenție la: e-mailuri de spam sau automate care declanșează fluxul degeaba — filtrează după expeditor sau subiect.

Formular ca declanșator

La trimiterea unui formular (contact, înscriere, cerere de ofertă), datele ajung structurat în flux. E cel mai curat declanșator: câmpuri definite, fără parsare. Preferă-l când poți controla formularul.

Webhook ca declanșator

Alt sistem (magazin, CRM, procesator de plăți) trimite un POST HTTP când se întâmplă ceva. E declanșatorul „profesionist": instant, structurat, fiabil. Necesită: verificarea semnăturii (să fie chiar de la sistemul așteptat) și răspuns rapid cu 200.

Reguli comune tuturor declanșatoarelor

Idempotență: același eveniment poate sosi de două ori — fluxul nu trebuie să dubleze acțiunea.
Filtrare devreme: aruncă evenimentele irelevante înainte să cheltui pe AI.
Jurnalizare: notează fiecare declanșare, ca să poți depana.

Filtru înainte de AI

Declanșator: e-mail nou. Filtru: dacă expeditorul e pe lista de parteneri SAU subiectul conține „ofertă"/„preț"/„colaborare" → continuă. Altfel → oprește. Așa nu trimiți fiecare newsletter primit către model.

Exercițiu

Pentru procesul ales în lecția 1, decide declanșatorul potrivit (e-mail, formular sau webhook). Scrie ce condiții de filtrare aplici înainte de pasul cu AI.

Greșeli frecvente

Declanșezi fluxul pe orice e-mail, inclusiv spam și automate.
Nu verifici semnătura unui webhook — oricine îl poate declanșa.
Fluxul nu e idempotent și dublează acțiunea la evenimente repetate.
Nu jurnalizezi declanșările și nu poți depana când ceva pică.

De reținut

Trei declanșatoare comune: e-mail, formular, webhook.
Formularul e cel mai curat; webhook-ul cel mai fiabil.
Filtrează evenimentele irelevante înainte de AI.
Idempotență, verificarea sursei și jurnalizare — mereu.

Pe scurt

Declanșatorul bun e specific, verificabil și filtrat. Aruncă zgomotul devreme, ca AI-ul să lucreze doar pe ce contează.

Webhook recepționat o singură dată logic

Un eveniment poate ajunge de mai multe ori din cauza retry-urilor rețelei sau furnizorului. Receptorul trebuie să distingă livrarea de procesare. Verifică autenticitatea conform protocolului furnizorului, validează payloadul și înregistrează identificatorul evenimentului. Confirmarea HTTP nu trebuie să însemne că ai executat deja o operație lentă. Pentru o coadă, persistă întâi starea necesară și tratează separat eșecul ulterior al jobului.

Exemplu de lucru

Eveniment fictiv: {"id":"evt-104","type":"request.created","request_id":42}
Prima livrare: validează → persistă evt-104 → programează job.
A doua livrare: evt-104 există → nu creează al doilea job logic.
Constrângere recomandată: identificator de eveniment unic în evidență.

Interpretarea rezultatului

Două cereri HTTP identice nu trebuie să producă două răspunsuri către client. O verificare „există?” fără constrângere unică poate pierde o cursă între două procese. Nu publica secretele de semnare în exemple sau loguri; folosește date fictive și configurație separată.

Exercițiu de consolidare

Simulează două livrări simultane și un eșec al jobului după recepție. Descrie ce se reia și ce nu se duplică.

Aplicație practică

Sarcina

Simulează un webhook cu identificator unic și date fictive.

Rezolvare orientativă și verificare

Trimite același eveniment de două ori. Sistemul trebuie să recunoască duplicatul, nu să creeze două cereri.

Greșeală de evitat

Livrarea webhook-urilor poate fi repetată.

Documentație și surse

Prompting și verificarea răspunsurilor — OpenAI
OWASP Top 10 — OWASP