| name | gestioneaza-comunicare |
| description | Comunicare cu clienții și echipa — campanii email, newslettere, flow-uri, send-time, deliverability, A/B, șabloane, WhatsApp Business/Messenger/Instagram, push. Confirmare obligatorie înainte de orice trimitere reală. La „trimite o campanie", „când e cel mai bine să trimit", „crește open rate", „cine mi-a scris pe WhatsApp", „dezabonează". Numărul PERSONAL al ownerului → raspunde-whatsapp. |
Gestioneaza Comunicare — Email + WhatsApp + Push, MCP-First
Userul este proprietar/manager, nu programator. Tu faci munca grea prin tool-urile MCP: citesti date live, pregatesti drafturi, rulezi planuri dry-run, calculezi audienta, alegi orele recomandate, verifici livrabilitatea si arati clar ce se va intampla. Chrome este pentru navigare si vizualizare; adevarul operational vine din MCP.
Regula de aur: orice trimitere reala cere confirmare explicita in cuvinte. Nu seta confirm:true doar pentru ca tool-ul exista. Emailurile in masa, WhatsApp, push, linkurile de login, activarea flow-urilor si inscrierea in secvente sunt actiuni reale.
Pentru campanii mari, flow-uri sau comunicari externe, citeste si knowledge/agent-operare-avansata.md: preview, plan de risc, confirmare, trimitere controlata si verificare post-actiune.
Inainte De Orice
- Citeste
knowledge/email-marketing.md, knowledge/comunicare-whatsapp.md si, pentru regula generala MCP-first, knowledge/claude-code-mcp-operare.md.
- Stabileste contextul:
list_brands si, daca e relevant, list_locations. Pentru mai multe branduri, cere clar brandul daca userul nu l-a spus.
- Verifica identitatea de trimitere:
comms_get_status. Pentru WhatsApp: list_whatsapp_accounts.
- Pentru email marketing, verifica sanatatea inainte de volum:
get_email_account_health, get_brand_email_reputation, get_sender_domain_status.
- Pentru pagini foloseste deep-link-uri stabile:
/email-campaigns, /email-templates, /email-setup, /email-analytics, /email-logs, /email-review, /whatsapp-inbox, /social-messages. Daca nu esti sigur, gaseste_in_aplicatie("campanii email").
Intent -> Tool
| Userul cere | Tool MCP | Nota |
|---|
| "ce campanii am" | list_email_campaigns | filtreaza pe status daca e cazul |
| "cum a mers campania X" | get_email_campaign_analytics | livrare, reliable opens, click, CTOR, bounce, complaints |
| "cum stau in general cu emailul" | get_email_analytics_overview + get_email_account_health | overview + risc cont |
| "ce linkuri/dispozitive au mers" | get_email_analytics_breakdowns | top linkuri, funnel, device/client/tara |
| "a ajuns emailul la X" | list_email_logs | cauta pe adresa |
| "cine e suprimat/dezabonat" | get_email_suppression_list | cauta adresa sau lista |
| "de pe ce adresa pleaca" | comms_get_status + get_sender_domain_status | expeditor + DNS |
| "ce segment sa targetez" | get_email_segment_opportunities | propuneri din date POS/CRM |
| "cati primesc emailul" | preview_email_audience | dry-run obligatoriu |
| "cand sa trimit" | analyze_email_send_time_plan | plan serios, individual |
| "ore rapide recomandate" | get_email_send_time_recommendations | fallback/overview pe ore |
| "este safe sa trimit" | analyze_email_deliverability_plan | readiness, warm-up, cap/ora |
| "scor spam continut" | check_email_campaign_deliverability | subiect, CTA, HTML, risc |
| "fata de ActiveCampaign cum stam" | get_email_competitive_audit | audit enterprise parity |
| "fa campania/newsletter" | create_email_campaign | draft, nu trimite |
| "editeaza campania" | update_email_campaign | draft/programata |
Reteta Standard Pentru Campanie Email
Nu sari pasii. Pentru orice campanie de marketing reala:
- Context —
list_brands -> brandul corect; comms_get_status.
- Health —
get_email_account_health, get_brand_email_reputation, get_sender_domain_status.
- Segment — daca userul nu stie cui sa trimita,
get_email_segment_opportunities. Apoi preview_email_audience.
- Draft —
create_email_campaign sau update_email_campaign. Pentru A/B foloseste abTest; pentru personalizare foloseste template overrides/conditional content.
- Deliverability continut —
check_email_campaign_deliverability.
- Deliverability plan —
analyze_email_deliverability_plan. Pentru 5k+ contacte este obligatoriu.
- Send-time plan —
analyze_email_send_time_plan. Pentru marketing, acesta este noul default.
- Test —
send_test_email_campaign daca userul vrea validare in inbox.
- Explica si cere confirmare — campanie, audienta, cate emailuri, ritm, fereastra, riscuri, metoda de trimitere.
- Trimite —
send_email_campaign_predictive({ campaignId, confirm:true, ... }), cu aceiasi parametri de ore/cap aprobati. Daca e programata pe viitor, schedule_email_campaign dupa enable_email_predictive_sending.
- Verifica dupa —
get_email_campaign_analytics, get_email_analytics_breakdowns, get_email_ab_test_report, get_email_conversion_attribution.
Formula de confirmare buna:
"Am pregatit campania Nume pentru brandul X. Ar primi N destinatari. Recomand sa nu plece instant, ci predictiv pe 36h, intre 08:00-22:00, cu maxim Y destinatari/ora. Planul de livrabilitate spune risc. Confirmi sa o pornesc asa?"
Daca raspunsul nu e un "da/confirm" clar, nu trimiti.
Liste Mari (zeci de mii de contacte)
Pentru liste mari, scopul este cresterea reala a performantei, nu doar livrare rapida:
- nu trimite toata lista rece intr-un singur val;
- foloseste
analyze_email_deliverability_plan ca sursa pentru warm-up si cap pe ora;
- porneste cu contacte calde: vizita recenta, click anterior, comenzi recente, loialitate, taguri clare;
- foloseste
send_email_campaign_predictive, nu broadcast fix;
- monitorizeaza bounce si complaints dupa fiecare val;
- daca bounce >= 2% sau complaints se apropie de 0.1%, opreste cresterea si curata lista;
- masoara click/conversie cu
get_email_conversion_attribution, nu doar open rate.
Cand userul intreaba daca va avea open rate mai bun decat ActiveCampaign, raspunde onest: "sansele sunt bune daca folosim datele POS, segmentare calda, warm-up si predictive sending, dar nu promit un procent fara istoric si fara primele valuri". Apoi ruleaza tool-urile relevante.
Flow-Uri Si Automatizari
Pentru flow-uri complexe:
- afla triggerul: client nou, win-back, zi de nastere, rezervare, click/no-click, VIP;
- creeaza structura cu
campaignType:"flow", flowSteps si flowEdges sau create_email_sequence;
- foloseste delay-uri naturale, nu spam: 1 zi, 3 zile, 7 zile, 30 zile dupa caz;
- pune conditii pe opened/clicked/converted/tag/lastVisit cand exista date;
- inainte de activare, ruleaza audienta si deliverability;
activate_email_flow(confirm:true) doar dupa confirmarea explicita.
Flow-uri utile pentru HoReCa:
- Welcome dupa prima vizita -> poveste brand -> voucher revenire;
- Win-back 45/60 zile -> oferta usoara -> reminder doar daca a dat click;
- VIP/high value -> invitatie privata/eveniment;
- Birthday 30 zile -> rezervare/masa/grup;
- Click fara conversie -> follow-up cu CTA mai clar;
- Post-event/reservation -> multumire + review + revenire.
WhatsApp, Conversatii Si Push
- Pentru inbox:
list_conversations, apoi get_conversation_messages. Nu raspunde fara context.
- Pentru raspuns: propune textul, cere confirmare, apoi
reply_to_conversation(confirm:true).
- Cand un mesaj e dat ca reply la altul, citeste intai la CE raspunde. „nu, nu asta", „si asta?", „nu ignora" inseamna lucruri diferite in functie de ce citeaza; luat ca raspuns la ultimul mesaj din fir, raspunzi pe langa subiect. Daca nu poti afla la ce se referea, intreaba — e o intrebare fireasca.
- Pentru WhatsApp initiat de tine: confirma numarul si textul; tine cont de fereastra 24h si template-uri aprobate.
- Pentru push: arata cati destinatari, cere confirmare, apoi
push_notify_staff sau push_notify_customers.
- Pentru link magic: este credential temporar, confirma adresa inainte de
send_magic_login_link(confirm:true).
Ce Arati Vizual Userului
Cand userul vrea sa vada:
- campaniile:
/email-campaigns;
- statistici:
/email-analytics;
- loguri/destinatar:
/email-logs;
- setup si domeniu:
/email-setup;
- inbox WhatsApp:
/whatsapp-inbox;
- mesaje social:
/social-messages.
Dar nu verifica succesul prin pixel. Dupa orice write/send, confirma prin tool de citire: list_email_campaigns, get_email_campaign_analytics, list_email_logs, list_conversations.
Reguli Care Nu Se Incalca
- Confirm-first pentru orice trimitere reala.
preview_email_audience inainte de email in masa.analyze_email_deliverability_plan si analyze_email_send_time_plan inainte de campanii mari sau cand userul cere crestere open rate.- Pentru marketing, prefera
send_email_campaign_predictive; send_email_campaign este fallback, nu default.
- Nu promite open rate garantat. Optimizezi probabilitatea si masori.
- Nu inventa subiecte, oferte, testimoniale, reduceri sau numere fara acord.
- Nu repeta send-ul pentru ca UI nu s-a refresh-uit.
- Nu folosi SQL daca exista tool dedicat.
- Daca apare "permisiune insuficienta", explica Hub -> Acces AI -> modulul Comunicare.
Legaturi
knowledge/email-marketing.md — concepte si best practice actualizat pentru email.knowledge/claude-code-mcp-operare.md — modelul general de lucru cu MCP.knowledge/comunicare-whatsapp.md — WhatsApp si inbox unificat.knowledge/segmentare-clienti.md — segmente, taguri, grupuri.knowledge/gdpr-clienti-oaspeti.md — consimtamant, dezabonare, anonimizare.knowledge/marketing-social.md — postari, reclame, atribuire.
