Ghid Operațional: Modulul de Automatizare Email Marketing (Integrare Brevo v3)

Modulul de Automatizare Email Marketing din Zarina CRM oferă o soluție centralizată și autonomă pentru gestionarea listelor de contacte, crearea vizuală a campaniilor de newsletter și monitorizarea telemetriei prin integrarea nativă cu API-ul Brevo v3. Această arhitectură înlocuiește vechile fluxuri manuale și pune la dispoziție instrumente avansate de analiză, securitate și sincronizare în masă.

1. Configurarea Inițială a Conexiunii

Activarea și autorizarea canalului de comunicare se realizează printr-o interfață securizată dedicată administratorilor:

• Introducerea Cheii API: În fișierul configurare-brevo.php, introduceți cheia API generată din contul dumneavoastră Brevo. Din motive stringente de securitate, cheia salvată nu este niciodată expusă direct în codul sursă HTML, fiind mascată parțial sub formă de caractere criptate.
• Definirea Expeditorului Implicit: Setați numele oficial al expeditorului și adresa de email autorizată (ex: marketing@zarinacrm.ae). Asigurați-vă în prealabil că domeniul utilizat este verificat și configurat corect la nivel de DNS prin Cloudflare pentru a garanta o rată maximă de livrare.
• Validarea Conexiunii: La fiecare accesare sau salvare prin scriptul save_config_brevo.php, sistemul interoghează automat API-ul Brevo, afișând în timp real statusul conexiunii și numărul total de contacte active mapate în cont.

2. Automatizarea și Autentificarea Webhook-urilor (brevo-webhook.php)

Pentru ca telemetria campaniilor să fie înregistrată instantaneu în CRM fără interogări repetitive, platforma folosește un sistem asincron de Webhooks:

• Generarea Secretului Criptografic: Prin componenta setup-webhook.php, CRM-ul înregistrează automat URL-ul receptor local în platforma Brevo. Autenticitatea datelor primite este garantată prin generarea automată a unui secret criptografic de 24 de bytes (48 de caractere hexazecimale) stocat în tabela email_settings.
• Validarea prin Token: La fiecare notificare trimisă de Brevo către brevo-webhook.php, scriptul verifică token-ul atașat în URL utilizând o metodă sigură de comparare împotriva atacurilor de tip timing (hash_equals), respingând orice tentativă de falsificare a metricilor.
• Evenimente Urmărite Live: Webhook-ul interceptează și incrementează în baza de date locală acțiunile clienților atât pentru campaniile de marketing, cât și pentru mesajele tranzacționale: delivered (livrat), opened (deschis), click (accesare link) și unsubscribed (dezabonare).

3. Sincronizarea și Gestiunea Audienței (Batch Import Engine)

Alinierea contactelor din CRM cu listele de distribuție din Brevo este complet automatizată și optimizată pentru baze de date voluminoase:

• Procesare în Pachete (Chunking): Executată din panoul de control email_lists.php, sincronizarea colectează clienții activi din tabela locală clienti. Pentru a preveni blocarea memoriei serverului (RAM) sau atingerea limitelor de timeout, contactele sunt trimise prin metoda de mare viteză batchCreateContacts în pachete controlate de maximum 100 de înregistrări per apel.
• Maparea Atributelor Inteligente: Sistemul igienizează datele și trimite către Brevo structuri bine definite, mapând automat câmpurile esențiale: prenumele (FIRSTNAME), numele de familie (LASTNAME), numărul de telefon curățat de caractere non-numerice (SMS) și numele companiei (COMPANY).

4. Crearea și Programarea Campaniilor (create_campaign.php)

Generarea vizuală a newsletterelor și managementul lansărilor sunt integrate într-un singur spațiu de lucru dinamic:

• Editor Drag & Drop Profesional: Fișierul create_campaign.php încapsulează direct în CRM interfața avansată Unlayer Editor, permițând personalizarea machetelor fără cunoștințe de cod. Editorul include etichete inteligente (Merge Tags) care permit personalizarea emailului cu datele dinamice ale clientului (ex: {{ contact.FIRSTNAME }}).
• Sistem de Protecție Auto-Save: Un script asincron rulează în fundal la fiecare 15 secunde, compilând automat structura designului JSON și codul HTML pur în tabela locală email_campaigns_drafts pentru a preveni pierderea muncii în cazul penelor de conexiune.
• Endpoint de Încărcare Imagini: Imaginile adăugate în editor sunt procesate prin endpoint-ul server-side upload_image_ajax, care validează formatele permise (JPG, JPEG, PNG, GIF, WEBP) și le stochează în directorul securizat al CRM-ului.
• Opțiuni Avansate de Marketing: Operatorii pot configura reguli de A/B Split Testing (distribuție egală 50/50 între două subiecte diferite pentru optimizarea ratei de deschidere) și pot alege între lansarea instantanee (Launch Now) sau programarea la o dată și oră viitoare (Scheduled Delivery).
• Trimitere Email de Test: Prin componenta send_test_email.php, se poate lansa o simulare instantanee direct către o adresă de email specificată, utilizând API-ul tranzacțional Brevo curat, fără a genera overhead în statisticile de marketing ale campaniei generale.

5. Monitorizarea Performanței și Managementul Cache-ului (Smart Cache)

Tabloul de bord centralizat din email_lists.php oferă o imagine analitică detaliată asupra eficienței fiecărei acțiuni de marketing transmise:

• Sistem de Protecție la Rate-Limiting: Pentru a evita interogarea excesivă a API-ului extern Brevo și penalizarea performanței, sistemul utilizează un motor de tip Smart Cache. Datele globale sunt stocate în tabela locală email_campaigns_local_stats și sunt reîmprospătate automat doar o dată la 10 minute.
• Metrici Analizate: Pentru fiecare campanie sunt extrași și calculați indicatori clari de performanță: numărul total de destinatari (volum trimis), numărul și procentul de deschideri unice (Open Rate), accesările unice de linkuri (Click Rate) și rata de renunțare (Unsubscriptions).
• Replicare și Clonare Rapidă: Campaniile de succes pot fi multiplicate instant. Sistemul integrează un algoritm special (Unlayer JSON Wrapper Fix) care preia codul HTML pur returnat de Brevo și îl convertește înapoi într-o structură editabilă de blocuri pe care editorul Drag & Drop o poate recunoaște și modifica.

6. Securitate și Mentenanță Automatizată

• Protecție Anti-CSRF (brevo-helpers.php): Toate formularele de configurare, acțiunile de clonare, sincronizările de audiență și cererile asincrone din editor sunt securizate la nivel de sesiune prin token-uri criptografice unice, blocând atacurile de tip Cross-Site Request Forgery.
• Arhitectură Self-Healing: La fiecare încărcare a panoului de marketing, CRM-ul rulează un motor intern de auto-migrare. Acesta verifică structura bazei de date și creează în mod autonom tabelele structurale lipsă (email_campaigns_drafts și email_campaigns_local_stats), asigurând continuitatea sistemului fără a necesita intervenții de mentenanță tehnică.

Beneficiile Cheie ale Fluxului Integrat

• Centralizare și Control direct: Toate datele campaniilor și listele de abonați sunt gestionate direct din Zarina CRM, eliminând nevoia de a naviga constant între platforme externe.
• Sincronizare Inteligentă: Corelează direct audiența din Gestiune leaduri și clienții din Modulul încasări și plăți cu listele de marketing, totul securizat și optimizat în pachete asincrone.
• Automatizare contextuală: Permite crearea unor fluxuri avansate de follow-up prin intermediul regulilor din modulul de Automatizare Follow-Up, crescând rata de conversie și retenție a clienților.