WhatsApp

Secțiune: Marketing & Comunicare
URL: /admin/whatsapp

Prezentare generală

WhatsApp este un hub complet de mesagerie în CRMConnect, construit pe WhatsApp Business API (WABA / Meta Cloud API). Acoperă întregul ciclu de viață al comunicării prin WhatsApp: chat bidirecțional în timp real cu lead-uri și clienți, fluxuri automate de chatbot, campanii de trimitere în masă cu șabloane aprobate, grupuri de contacte pentru segmentarea audiențelor și un director de contacte independent pentru outreach în masă — toate cu permisiuni granulare bazate pe rol per sub-modul.

Valoare pentru business

• Cine îl folosește: Reprezentanți de vânzări (chat), marketing (campanii, boți), administratori CRM (numere, șabloane, grupuri)
• Beneficiu cheie: Consolidează fiecare punct de contact WhatsApp — conversații individuale, campanii în masă și răspunsuri automate — într-un singur loc legat de înregistrările CRM.
• Metrici influențate: Timp de răspuns, rată de conversie lead-uri, rată de livrare/citire campanii, devierea suportului

Cazuri de utilizare tipice:

• Reprezentantul de vânzări conversează cu un lead direct din CRM; conversația este legată de înregistrarea lead-ului și înregistrată automat
• Marketingul trimite o campanie promoțională unui grup filtrat de contacte folosind un șablon de mesaj aprobat de Meta
• Un chatbot răspunde la întrebări frecvente în afara orelor de program și direcționează conversația către membrul de personal potrivit pe baza răspunsului
• Propunerile și facturile sunt trimise clienților prin WhatsApp cu un singur click prin integrarea șabloanelor bazate pe acțiuni

Sub-module la o privire

1. Chat (Interacțiune)

URL: /admin/whatsapp/interaction
Permisiune: whatsapp_chat → vizualizare

Interfața principală de chat. Personalul poate deschide orice fir de conversație, trimite mesaje libere sau șabloane, atașa media, folosi răspunsuri rapide și atribui conversații colegilor. Fiecare conversație este legată de un înregistrare CRM de lead sau client.

Concepte cheie

Acțiuni frecvente

1. Deschide o conversație — apasă pe un fir în panoul din stânga pentru a încărca istoricul mesajelor.
2. Trimite un mesaj — scrie în compositor și apasă trimite; folosește pictograma de atașament pentru media.
3. Inserează un răspuns rapid — tastează / sau apasă pictograma de răspuns rapid pentru a selecta un mesaj predefinit.
4. Trimite un șablon — apasă pictograma de șablon pentru a alege un șablon WABA aprobat când ești în afara ferestrei de sesiune de 24 de ore.
5. Atribuie conversația — folosește controlul de atribuire din antet pentru a preda unui alt membru de personal.
6. Trimite o propunere prin WhatsApp — din meniul de previzualizare a propunerii, apasă „Trimite propunere pe WhatsApp"; sistemul deschide automat sau creează interacțiunea și trimite șablonul de acțiune configurat.

Integrarea șabloanelor bazate pe acțiuni

Anumite acțiuni CRM pot trimite automat un șablon WhatsApp când sunt configurate în Setări → WhatsApp → Șablon per acțiune:

• Propunere trimisă — șablonul este trimis când o propunere este expediată prin butonul de acțiune WhatsApp.
• Declanșatoarele de acțiuni suplimentare (factură, comandă de vânzare etc.) urmează același model.

2. Boți

URL: /admin/whatsapp/bots
Permisiune: whatsapp_bot → vizualizare / creare / editare / ștergere

Boții WhatsApp sunt agenți de conversație automată care răspund la mesajele primite pe baza unui flux vizual proiectat în editorul drag-and-drop Drawflow. Boții suportă mai multe tipuri (declanșatori pe cuvinte cheie, bazați pe meniu, asistat de AI) și pot face referire la șabloane WABA aprobate pentru răspunsuri structurate.

Concepte cheie

Acțiuni frecvente

1. Listează boții — /admin/whatsapp/bots afișează toți boții cu nume, tip, status și acțiuni rapide.
2. Creează un bot — apasă Adaugă bot, completează numele, tipul și șablonul opțional; salvează pentru a crea înregistrarea.
3. Proiectează fluxul — apasă pictograma Editor flux pentru a deschide canvas-ul Drawflow (/admin/whatsapp/bots/botflow/{id}); trage noduri, conectează-le, configurează mesajul sau șablonul fiecărui nod, apoi salvează.
4. Activează / dezactivează — folosește comutatorul de pe rândul listei (apel AJAX la change_active_status); doar un bot trebuie să fie activ per domeniu de declanșare pentru a evita conflictele.
5. Duplică un bot — folosește acțiunea de duplicare pentru a clona configurația și fluxul unui bot ca punct de plecare pentru unul nou.
6. Editează setările — apasă editare pentru a actualiza numele, tipul, legarea șablonului sau fișierul media atașat.
7. Șterge fișierul botului — elimină atașamentul media de la un bot fără a șterge botul în sine.

Note editor flux

• Editorul folosește Drawflow (același motor ca Automatizarea marketing).
• JSON-ul fluxului este stocat în coloana flow_data și salvat prin updateFlow.
• header_params, body_params și footer_params sunt array-uri JSON care mapează variabilele șablonului la valori dinamice.

3. Campanii

URL: /admin/whatsapp/campaigns
Permisiune: whatsapp_campaign → vizualizare / creare / editare / ștergere

Campaniile WhatsApp permit trimiterea unui singur mesaj șablon aprobat WABA la o listă mare de destinatari (lead-uri, contacte clienți sau grupuri de contacte) într-o singură operație. Statusul de livrare și citire este urmărit per destinatar.

Concepte cheie

Acțiuni frecvente

1. Vizualizează toate campaniile — /admin/whatsapp/campaigns listează campaniile cu status și metrici de livrare.
2. Creează o campanie — apasă Campanie nouă, selectează numărul expeditorului, șablonul, tipul destinatarilor (lead-uri / contacte / grup), alege destinatari individuali sau un grup întreg, atașează opțional un fișier, apoi salvează.
3. Editează o campanie — deschide o campanie existentă înainte de rulare pentru a ajusta destinatarii sau maparea șablonului.
4. Vizualizează raportul campaniei — apasă pe numele campaniei pentru a vedea vizualizarea detaliată cu % livrat, % citit și jurnalul per destinatar.
5. Pauză / Reluare — folosește controlul de pauză/reluare din vizualizarea detaliată a campaniei pentru a opri sau continua trimiterea.
6. Șterge o campanie — elimină înregistrarea campaniei și datele per destinatar.
7. Șterge fișierul campaniei — elimină atașamentul media fără a șterge campania.
8. Filtrează lead-urile pentru campanie — folosește get_filtered_leads (AJAX) pentru a restrânge lista de destinatari pe criterii de lead înainte de salvare.

Analiticele campaniei

Vizualizarea detaliată a campaniei (/admin/whatsapp/campaigns/view/{id}) arată:

• Total destinatari selectați față de totalul din CRM (ca %)
• Număr livrat și % livrat
• Număr citit și % citit

4. Grupuri

URL: /admin/whatsapp/groups
Permisiune: whatsapp_groups → vizualizare / creare / editare / ștergere

Grupurile sunt colecții denumite de Contacte în masă folosite pentru segmentarea audiențelor pentru campanii. Un contact poate aparține mai multor grupuri; un grup poate fi targetat ca lista de destinatari pentru o campanie.

Acțiuni frecvente

1. Listează grupurile — /admin/whatsapp/groups afișează toate grupurile cu nume și numărul de contacte.
2. Creează un grup — apasă Adaugă grup, introdu un nume și o descriere opțională, salvează.
3. Editează un grup — apasă editare pe orice rând pentru a actualiza numele grupului.
4. Șterge un grup — elimină grupul; contactele nu sunt șterse, doar atribuirea la grup.

5. Contacte în masă

URL: /admin/whatsapp/BulkContacts
Permisiune: whatsapp_contacts → vizualizare / creare / editare / ștergere

Contactele în masă este un director de contacte specific WhatsApp independent, separat de lead-urile și clienții CRM. Contactele de aici sunt destinatarii disponibili pentru campanii și grupuri. Unicitatea numărului de telefon este impusă.

Concepte cheie

Format import CSV

Importul se așteaptă la un fișier separat prin virgule cu coloane în această ordine (rândul de antet este ignorat):

Dacă un număr de telefon există deja, importul sare peste crearea unei noi înregistrări și atribuie doar grupurile selectate contactului existent.

Acțiuni frecvente

1. Listează contactele — /admin/whatsapp/BulkContacts afișează toate contactele cu apartenența lor la grupuri.
2. Adaugă un contact — apasă Adaugă contact, completează numărul de telefon (obligatoriu, unic), numele și câmpurile opționale; atribuie unuia sau mai multor grupuri; salvează.
3. Editează un contact — actualizează orice câmp sau modifică atribuirile la grup.
4. Șterge un contact — elimină contactul și asocierile sale de grup.
5. Importă din CSV — folosește butonul Import, încarcă un fișier CSV, selectează opțional grupuri pentru a le atribui tuturor contactelor importate, apoi confirmă.
6. Ștergere în masă — selectează mai multe contacte prin bifele de selectare și folosește acțiunea de ștergere în masă.
7. Atribuire în masă la grupuri — selectează mai multe contacte și atribuie-le unuia sau mai multor grupuri într-o singură operație.

6. Șabloane

URL: /admin/whatsapp/templates
Permisiune: whatsapp_template → vizualizare / creare / editare / încărcare_șablon

Șabloanele sunt șabloane de mesaje WABA aprobate de Meta, necesare pentru inițierea conversațiilor și pentru mesajele de campanie. Sub-modulul Șabloane se sincronizează cu Meta Graph API pentru a lista, crea și gestiona șabloane direct din CRMConnect.

Concepte cheie

Modele șabloane

Pagina Modele șabloane (/admin/whatsapp/templates/template_models) oferă crearea cu un singur click a șabloanelor standard în Meta pentru:

• Propunere
• Factură
• Factură proformă
• Storno (notă de credit)
• Comandă de vânzare

Apasă Încarcă în Meta pe orice model pentru a-l trimite spre aprobare Meta. Odată aprobat, șablonul devine disponibil pentru campanii, boți și trimiteri bazate pe acțiuni.

Acțiuni frecvente

1. Vizualizează șabloane — listează toate șabloanele sincronizate din Meta cu statusul lor de aprobare.
2. Creează un șablon — definește antetul, corpul, subsolul, categoria, limba și trimite spre aprobare Meta.
3. Editează un șablon — actualizează un șablon draft sau respins și retrimite.
4. Șterge un șablon — elimină înregistrarea locală și șterge din Meta.
5. Încarcă un model de șablon — folosește pagina Modele șabloane pentru a trimite un șablon de document predefinit către Meta cu un singur click (necesită permisiunea load_template).
6. Obține maparea șablonului — când selectezi un șablon în formularul de campanie sau bot, interfața de mapare a parametrilor se încarcă automat prin AJAX pentru a afișa câmpurile de variabile necesare.

7. Răspunsuri rapide

URL: /admin/whatsapp/QuickReplies
Permisiune: quickreplies → vizualizare / creare / editare / ștergere

Răspunsurile rapide sunt fragmente scurte de text denumite pe care agenții de chat le pot insera instantaneu într-o conversație. Reduc timpul de răspuns pentru întrebările frecvente sau saluturile standard.

Acțiuni frecvente

1. Listează răspunsurile rapide — /admin/whatsapp/QuickReplies afișează toate răspunsurile salvate cu previzualizarea numelui și mesajului.
2. Adaugă un răspuns rapid — apasă Adaugă, introdu un nume (eticheta comenzii rapide) și textul complet al mesajului; salvează.
3. Editează un răspuns rapid — actualizează numele sau textul mesajului.
4. Șterge un răspuns rapid — elimină comanda rapidă; nu va mai apărea în compositorul de chat.
5. Folosește în chat — în vizualizarea Interacțiune, apasă pictograma de răspuns rapid sau tastează comanda rapidă pentru a insera textul complet al mesajului în compositor.

8. Numere

URL: /admin/whatsapp/numbers
Permisiune: whatsapp_numbers → vizualizare

Listează toate numerele de telefon WhatsApp Business conectate la CRMConnect prin Meta Cloud API. Pentru fiecare număr, sistemul preia și stochează în cache profilul de business din Meta (fotografie de profil, text „despre", adresă, sector, email, site-uri web).

Concepte cheie

Numerele sunt adăugate și configurate în Setări → WhatsApp, nu prin această vizualizare de listă. Această pagină este o prezentare generală read-only a conexiunilor active.

9. Conexiune

URL: /admin/whatsapp/connection
Acces: Numai administrator

Pagina Conexiune afișează statusul integrării WhatsApp Cloud API și oferă interfața pentru introducerea sau actualizarea acreditărilor Meta (Access Token, ID număr de telefon, ID cont business, configurare webhook). Doar administratorii pot accesa această pagină.

10. Jurnal de activitate

URL: /admin/whatsapp/activity_log

Un traseu de audit cronologic al tuturor acțiunilor WhatsApp efectuate în CRMConnect — mesaje trimise și primite, trimiteri de campanii, declanșări de boți, trimiteri de șabloane și evenimente de sistem. Util pentru revizuiri de conformitate și depanarea problemelor de livrare.

Referință permisiuni

Sursă: crm-connect-main/app/modules/whatsapp/controllers/ · Actualizat: 2026-06-03