José Manuel Gómez
3afc1c25c1
Replace one-message-per-campaign with: - Message 1: monthly table + vertical scorecard + actions + todo-en-orden - One message per vertical that has non-MAINTAIN actions or ad PAUSEs - Verticals with no issues are summarised in a single line in message 1 - Remove top-10 best/worst lists (noise) - Adset detail (top 3) only shown for non-MAINTAIN campaigns - Recommendations and approve/reject buttons are now front and centre Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
491 lines
20 KiB
Python
491 lines
20 KiB
Python
"""Slack notifier — Web API (Bot Token) con botones interactivos."""
|
|
from datetime import datetime
|
|
import unicodedata
|
|
import requests
|
|
import config
|
|
|
|
|
|
def _table_name(name: str, width: int) -> str:
|
|
"""Strip diacritics so accented chars don't break Slack's monospace alignment."""
|
|
normalized = unicodedata.normalize("NFKD", name)
|
|
ascii_name = "".join(c for c in normalized if not unicodedata.combining(c))
|
|
return ascii_name[:width]
|
|
|
|
_SLACK_API = "https://slack.com/api"
|
|
|
|
_STRATEGY_LABELS = {
|
|
"LOWEST_COST_WITHOUT_CAP": "Menor coste",
|
|
"LOWEST_COST_WITH_BID_CAP": "Cap. puja",
|
|
"COST_CAP": "Cap. coste",
|
|
"MINIMUM_ROAS": "ROAS mín.",
|
|
}
|
|
|
|
_ACTION_DISPLAY = {
|
|
"INCREASE_BUDGET": ("🟢", "AUMENTAR PRESUPUESTO"),
|
|
"REDUCE_BUDGET": ("🔴", "REDUCIR PRESUPUESTO"),
|
|
"PAUSE": ("⛔", "PAUSAR CAMPAÑA"),
|
|
"REVIEW_CREATIVES": ("🔍", "REVISAR CREATIVIDADES"),
|
|
"MAINTAIN": ("✅", "MANTENER"),
|
|
}
|
|
|
|
# Solo estas acciones ejecutan algo real en Meta API → botones
|
|
_ACTIONABLE = {"INCREASE_BUDGET", "REDUCE_BUDGET", "PAUSE"}
|
|
|
|
|
|
def _effect_text(action: dict, budget: float | None) -> str:
|
|
"""Texto que describe exactamente qué ocurrirá si se aprueba la acción."""
|
|
atype = action.get("action_type", "")
|
|
param = float(action.get("parameter") or 1.0)
|
|
if atype == "PAUSE":
|
|
return "⚠️ *La campaña será pausada en Meta Ads*"
|
|
if atype in ("INCREASE_BUDGET", "REDUCE_BUDGET"):
|
|
pct = round((param - 1) * 100)
|
|
if pct == 0:
|
|
return "" # parameter not available, skip misleading text
|
|
sign = "+" if pct >= 0 else ""
|
|
if budget:
|
|
new_b = round(budget * param, 2)
|
|
return f"📊 Presupuesto diario: *{budget:.0f}€ → {new_b:.0f}€* ({sign}{pct}%)"
|
|
return f"📊 Ajuste de presupuesto: *{sign}{pct}%*"
|
|
return ""
|
|
|
|
|
|
def _post(method: str, **payload) -> dict:
|
|
resp = requests.post(
|
|
f"{_SLACK_API}/{method}",
|
|
headers={"Authorization": f"Bearer {config.SLACK_BOT_TOKEN}"},
|
|
json=payload,
|
|
timeout=10,
|
|
)
|
|
data = resp.json()
|
|
if not data.get("ok"):
|
|
raise RuntimeError(f"Slack {method} error: {data.get('error')} — {data.get('response_metadata', {}).get('messages', '')}")
|
|
return data
|
|
|
|
|
|
def update_message(channel: str, ts: str, text: str):
|
|
"""Reemplaza un mensaje con texto plano tras aprobación/rechazo."""
|
|
_post("chat.update", channel=channel, ts=ts, text=text, blocks=[])
|
|
|
|
|
|
def _ad_action_blocks(ads: list) -> list:
|
|
"""Genera bloques Slack con botón de pausa para anuncios que Claude recomienda pausar."""
|
|
blocks = []
|
|
for ad in ads:
|
|
if not ad.get("row_id"):
|
|
continue
|
|
name = ad["name"]
|
|
ev = ad.get("evaluacion", "")
|
|
rec = ad.get("recomendacion", "")
|
|
text = f"⛔ *{name[:55]}*"
|
|
if ev:
|
|
text += f"\n_{ev}_"
|
|
if rec:
|
|
text += f"\n→ {rec}"
|
|
text += "\n⚠️ *El anuncio será pausado en Meta Ads si se aprueba*"
|
|
blocks.append({"type": "section", "text": {"type": "mrkdwn", "text": text}})
|
|
blocks.append({
|
|
"type": "actions",
|
|
"elements": [
|
|
{
|
|
"type": "button",
|
|
"text": {"type": "plain_text", "text": "⛔ Pausar anuncio"},
|
|
"style": "danger",
|
|
"value": f"approve:{ad['row_id']}",
|
|
"action_id": f"approve_{ad['row_id']}",
|
|
},
|
|
{
|
|
"type": "button",
|
|
"text": {"type": "plain_text", "text": "❌ Rechazar"},
|
|
"value": f"reject:{ad['row_id']}",
|
|
"action_id": f"reject_{ad['row_id']}",
|
|
},
|
|
],
|
|
})
|
|
return blocks
|
|
|
|
|
|
def _adset_ad_table(items: list, label: str, show_bid: bool = False, show_7d: bool = False) -> str:
|
|
"""Genera tabla monoespaciada de adsets o anuncios para Slack."""
|
|
if not items:
|
|
return ""
|
|
lines = [f"*{label}*"]
|
|
lines.append("```")
|
|
if show_7d:
|
|
lines.append(f"{'Nombre':<45} {'Gasto':>6} {'Leads':>5} {'CPL(3d)':>8} {'CPL(7d)':>8} {'CTR':>5}")
|
|
lines.append("─" * 82)
|
|
elif show_bid:
|
|
lines.append(f"{'Nombre':<45} {'Gasto':>6} {'Leads':>5} {'CPL':>6} {'CTR':>5} {'Cap':>7}")
|
|
lines.append("─" * 79)
|
|
else:
|
|
lines.append(f"{'Nombre':<45} {'Gasto':>6} {'Leads':>5} {'CPL':>6} {'CTR':>5}")
|
|
lines.append("─" * 71)
|
|
for it in items:
|
|
name = _table_name(it["name"], 45)
|
|
leads_str = f"{it['leads']:>5}" if it["leads"] > 0 else " —"
|
|
if show_7d:
|
|
cpl_3d = it.get("cpl_3d", 0.0)
|
|
cpl_7d = it.get("cpl_7d", it.get("cpl", 0.0))
|
|
cpl_3d_str = f"{cpl_3d:>6.2f}€" if cpl_3d > 0 else " —"
|
|
cpl_7d_str = f"{cpl_7d:>6.2f}€" if cpl_7d > 0 else " —"
|
|
lines.append(
|
|
f"{name:<45} {it['spend']:>5.0f}€ {leads_str} {cpl_3d_str:>8} {cpl_7d_str:>8} {it['ctr']:>4.1f}%"
|
|
)
|
|
elif show_bid:
|
|
cpl_str = f"{it['cpl']:>5.2f}€" if it["leads"] > 0 else " —"
|
|
cost_cap = it.get("cost_cap_eur")
|
|
cap_str = f" {cost_cap:>5.2f}€" if cost_cap else " Auto"
|
|
lines.append(
|
|
f"{name:<45} {it['spend']:>5.0f}€ {leads_str} {cpl_str} {it['ctr']:>4.1f}%{cap_str}"
|
|
)
|
|
else:
|
|
cpl_str = f"{it['cpl']:>5.2f}€" if it["leads"] > 0 else " —"
|
|
lines.append(
|
|
f"{name:<45} {it['spend']:>5.0f}€ {leads_str} {cpl_str} {it['ctr']:>4.1f}%"
|
|
)
|
|
lines.append("```")
|
|
# Evaluations below the table
|
|
for it in items:
|
|
ev = it.get("evaluacion", "")
|
|
rec = it.get("recomendacion", "")
|
|
if ev or rec:
|
|
lines.append(f"• *{it['name'][:55]}*")
|
|
if ev:
|
|
lines.append(f" _{ev}_")
|
|
if rec:
|
|
lines.append(f" → {rec}")
|
|
return "\n".join(lines)
|
|
|
|
|
|
def _vertical_status_emoji(v_cpl: float, v_obj: float, has_action: bool) -> str:
|
|
if v_cpl == 0 or v_obj == 0:
|
|
return "⚪"
|
|
if v_cpl <= v_obj:
|
|
return "⚠️" if has_action else "✅"
|
|
if v_cpl <= v_obj * 1.3:
|
|
return "⚠️"
|
|
return "❌"
|
|
|
|
|
|
def send_daily_report(
|
|
daily_totals: list,
|
|
best_campaigns: list,
|
|
worst_campaigns: list,
|
|
actions: list,
|
|
target_cpl: float,
|
|
campaigns_analyzed: int,
|
|
mode: str = "DRY_RUN",
|
|
verticals: dict = None,
|
|
campaign_details: dict = None,
|
|
monthly_verticals: dict = None,
|
|
) -> str | None:
|
|
"""Envía el informe diario consolidado. Devuelve el ts del mensaje."""
|
|
now = datetime.now()
|
|
date_label = now.strftime("%d/%m/%Y")
|
|
month_name = now.strftime("%B %Y").capitalize()
|
|
prefix = config.META_CAMPAIGN_PREFIX
|
|
mode_label = "DRY RUN" if mode == "DRY_RUN" else "PRODUCCIÓN"
|
|
|
|
action_map = {a["campaign_name"]: a for a in actions}
|
|
details_map = campaign_details or {}
|
|
name_to_cid = {d["name"]: cid for cid, d in details_map.items()}
|
|
|
|
# ── Classify campaigns: issues vs OK ─────────────────────────────────────
|
|
camps_issues: dict = {} # name → (cid, detail, action_or_None)
|
|
camps_ok: dict = {} # name → (cid, detail)
|
|
|
|
for cid, detail in details_map.items():
|
|
name = detail["name"]
|
|
act = action_map.get(name)
|
|
has_action = bool(act and act["action_type"] != "MAINTAIN")
|
|
has_ad_pause = any(
|
|
ad.get("accion") == "PAUSE" and ad.get("row_id")
|
|
for ad in detail.get("ads", [])
|
|
)
|
|
if has_action or has_ad_pause:
|
|
camps_issues[name] = (cid, detail, act)
|
|
else:
|
|
camps_ok[name] = (cid, detail)
|
|
|
|
# Group issues by vertical
|
|
by_vertical_issues: dict = {}
|
|
for name, (cid, detail, act) in camps_issues.items():
|
|
by_vertical_issues.setdefault(detail["vertical"], []).append((cid, detail, act))
|
|
|
|
# ── Message 1: Executive dashboard ───────────────────────────────────────
|
|
blocks: list = [
|
|
{
|
|
"type": "header",
|
|
"text": {"type": "plain_text",
|
|
"text": f"Meta Optimizer — {prefix} — {date_label} ({mode_label})"},
|
|
},
|
|
]
|
|
|
|
# Monthly profitability table
|
|
if daily_totals:
|
|
v_order = (
|
|
sorted(monthly_verticals.keys(), key=lambda v: -monthly_verticals[v]["margin"])
|
|
if monthly_verticals else []
|
|
)
|
|
cw = 7
|
|
header = f"{'Día':<5} {'Gasto':>6} {'Leads':>5} {'CPL':>7}"
|
|
for v in v_order:
|
|
header += f" {v[:6]:>{cw}}"
|
|
header += " Est"
|
|
sep = "─" * len(header)
|
|
lines = [header, sep]
|
|
total_spend = total_leads = total_margin = 0.0
|
|
total_v = {v: 0.0 for v in v_order}
|
|
for d in daily_totals:
|
|
day = d["date"][8:10] + "/" + d["date"][5:7]
|
|
margin = d.get("margin", 0.0)
|
|
total_spend += d["spend"]
|
|
total_leads += d["leads"]
|
|
total_margin += margin
|
|
v_day = d.get("v_margins", {})
|
|
icon = "✅" if d["leads"] > 0 else ("❌" if d["spend"] > 0 else "—")
|
|
row = f"{day:<5} {d['spend']:>5.0f}€ {d['leads']:>5} {d['cpl']:>6.2f}€"
|
|
for v in v_order:
|
|
vm = v_day.get(v, 0.0)
|
|
total_v[v] += vm
|
|
vm_s = (f"+{vm:.0f}€" if vm >= 0 else f"{vm:.0f}€") if round(vm) != 0 else " —"
|
|
row += f" {vm_s:>{cw}}"
|
|
row += f" {icon}"
|
|
lines.append(row)
|
|
lines.append(sep)
|
|
total_row = f"{'TOTAL':<5} {total_spend:>5.0f}€ {int(total_leads):>5} {'':>7}"
|
|
for v in v_order:
|
|
tv = total_v[v]
|
|
tv_s = f"+{tv:.0f}€" if tv >= 0 else f"{tv:.0f}€"
|
|
total_row += f" {tv_s:>{cw}}"
|
|
lines.append(total_row)
|
|
blocks.append({
|
|
"type": "section",
|
|
"text": {
|
|
"type": "mrkdwn",
|
|
"text": f"*Rentabilidad {month_name}*\n```" + "\n".join(lines) + "```",
|
|
},
|
|
})
|
|
else:
|
|
blocks.append({
|
|
"type": "section",
|
|
"text": {"type": "mrkdwn", "text": "_Sin datos del mes en curso aún._"},
|
|
})
|
|
|
|
blocks.append({"type": "divider"})
|
|
|
|
# Vertical scorecard
|
|
if verticals:
|
|
lines = [f"{'Vertical':<16} {'Gasto':>6} {'Leads':>5} {'CPL':>7} {'Obj':>7} {'Margen':>9}"]
|
|
lines.append("─" * 58)
|
|
for v, data in sorted(verticals.items(), key=lambda x: -x[1]["margin"]):
|
|
v_leads = data["leads"]
|
|
v_spend = data["spend"]
|
|
v_cpl = round(v_spend / v_leads, 2) if v_leads > 0 else 0.0
|
|
v_m = data["margin"]
|
|
v_obj = data.get("target_cpl", 0)
|
|
m_sign = f"+{v_m:.0f}€" if v_m >= 0 else f"{v_m:.0f}€"
|
|
obj_str = f"{v_obj:.2f}€" if v_obj else " —"
|
|
has_act = v in by_vertical_issues
|
|
st = _vertical_status_emoji(v_cpl, v_obj, has_act)
|
|
lines.append(
|
|
f"{st} {v:<14} {v_spend:>5.0f}€ {v_leads:>5} {v_cpl:>6.2f}€ {obj_str:>7} {m_sign:>9}"
|
|
)
|
|
blocks.append({
|
|
"type": "section",
|
|
"text": {"type": "mrkdwn",
|
|
"text": "*Verticales · ayer*\n```" + "\n".join(lines) + "```"},
|
|
})
|
|
|
|
# Actions section
|
|
if actions:
|
|
blocks.append({"type": "divider"})
|
|
blocks.append({
|
|
"type": "section",
|
|
"text": {"type": "mrkdwn", "text": "*🚨 Acciones recomendadas*"},
|
|
})
|
|
for act in actions:
|
|
atype = act["action_type"]
|
|
emoji, alabel = _ACTION_DISPLAY.get(atype, ("⚪", atype))
|
|
cid = name_to_cid.get(act["campaign_name"])
|
|
bid_cfg = details_map.get(cid, {}).get("bid_config", {}) if cid else {}
|
|
budget = bid_cfg.get("daily_budget_eur")
|
|
text = f"{emoji} *{act['campaign_name'][:60]}* → *{alabel}*"
|
|
if act.get("justification"):
|
|
text += f"\n_{act['justification'][:200]}_"
|
|
if act.get("alert"):
|
|
text += f"\n:warning: {act['alert'][:150]}"
|
|
effect = _effect_text(act, budget)
|
|
if effect:
|
|
text += f"\n{effect}"
|
|
blocks.append({"type": "section", "text": {"type": "mrkdwn", "text": text}})
|
|
if atype in _ACTIONABLE:
|
|
blocks.append({
|
|
"type": "actions",
|
|
"elements": [
|
|
{
|
|
"type": "button",
|
|
"text": {"type": "plain_text", "text": "✅ Aprobar"},
|
|
"style": "primary",
|
|
"value": f"approve:{act['row_id']}",
|
|
"action_id": f"approve_{act['row_id']}",
|
|
},
|
|
{
|
|
"type": "button",
|
|
"text": {"type": "plain_text", "text": "❌ Rechazar"},
|
|
"style": "danger",
|
|
"value": f"reject:{act['row_id']}",
|
|
"action_id": f"reject_{act['row_id']}",
|
|
},
|
|
],
|
|
})
|
|
|
|
# Ad pause count notice
|
|
total_ad_pauses = sum(
|
|
1 for _, detail, _ in camps_issues.values()
|
|
for ad in detail.get("ads", [])
|
|
if ad.get("accion") == "PAUSE" and ad.get("row_id")
|
|
)
|
|
if total_ad_pauses > 0:
|
|
noun = "anuncio" if total_ad_pauses == 1 else "anuncios"
|
|
blocks.append({
|
|
"type": "context",
|
|
"elements": [{"type": "mrkdwn",
|
|
"text": f"⛔ {total_ad_pauses} {noun} recomendados para pausar — ver detalle por vertical"}],
|
|
})
|
|
|
|
# "Todo en orden" summary
|
|
if camps_ok:
|
|
blocks.append({"type": "divider"})
|
|
ok_lines = []
|
|
for name, (_, detail) in sorted(camps_ok.items(), key=lambda x: x[1][1]["vertical"]):
|
|
v = detail["vertical"]
|
|
leads_1d = detail.get("leads_1d", 0)
|
|
spend_1d = detail.get("spend_1d", 0.0)
|
|
ok_lines.append(f"✅ *{name}* · {spend_1d:.0f}€ / {leads_1d} leads ayer")
|
|
blocks.append({
|
|
"type": "section",
|
|
"text": {"type": "mrkdwn", "text": "*Todo en orden*\n" + "\n".join(ok_lines)},
|
|
})
|
|
|
|
blocks.append({
|
|
"type": "context",
|
|
"elements": [{"type": "mrkdwn", "text": f"{campaigns_analyzed} campañas analizadas"}],
|
|
})
|
|
|
|
result = _post(
|
|
"chat.postMessage",
|
|
channel=config.SLACK_CHANNEL_ID,
|
|
blocks=blocks,
|
|
text=f"Meta Optimizer — {prefix} — {date_label}",
|
|
)
|
|
ts = result.get("ts")
|
|
|
|
# ── Messages 2-N: one per vertical with issues ────────────────────────────
|
|
for v, camp_list in sorted(by_vertical_issues.items()):
|
|
v_data = (verticals or {}).get(v, {})
|
|
v_spend = v_data.get("spend", 0)
|
|
v_leads = v_data.get("leads", 0)
|
|
v_cpl = round(v_spend / v_leads, 2) if v_leads > 0 else 0.0
|
|
v_obj = v_data.get("target_cpl", 0)
|
|
v_margin = v_data.get("margin", 0)
|
|
m_str = f"+{v_margin:.0f}€" if v_margin >= 0 else f"{v_margin:.0f}€"
|
|
obj_str = f" · obj {v_obj:.2f}€" if v_obj else ""
|
|
|
|
v_blocks: list = [{
|
|
"type": "section",
|
|
"text": {
|
|
"type": "mrkdwn",
|
|
"text": (
|
|
f"📊 *{v.upper()}* · {v_spend:.0f}€ · {v_leads} leads · "
|
|
f"CPL {v_cpl:.2f}€{obj_str} · Margen {m_str}"
|
|
),
|
|
},
|
|
}]
|
|
|
|
for cid, detail, act in sorted(camp_list, key=lambda x: -x[1].get("spend_1d", 0)):
|
|
name = detail["name"]
|
|
spend_1d = detail.get("spend_1d", 0.0)
|
|
leads_1d = detail.get("leads_1d", 0)
|
|
margin = detail["margin"]
|
|
m_str2 = f"+{margin:.2f}€" if margin >= 0 else f"{margin:.2f}€"
|
|
adsets = detail.get("adsets", [])
|
|
ads = detail.get("ads", [])
|
|
bid_cfg = detail.get("bid_config", {})
|
|
budget = bid_cfg.get("daily_budget_eur")
|
|
strategy = bid_cfg.get("bid_strategy", "")
|
|
strat_label = _STRATEGY_LABELS.get(strategy, strategy or "—")
|
|
|
|
atype = act["action_type"] if act else "MAINTAIN"
|
|
emoji, alabel = _ACTION_DISPLAY.get(atype, ("⚪", atype))
|
|
|
|
camp_text = (
|
|
f"{emoji} *{name}*\n"
|
|
f"Ayer: {spend_1d:.0f}€ / {leads_1d} leads · Margen: {m_str2} · "
|
|
f"`{strat_label}`" + (f" · {budget:.0f}€/día" if budget else "") +
|
|
f"\n*{alabel}*"
|
|
)
|
|
if act and act.get("justification"):
|
|
camp_text += f" — _{act['justification'][:160]}_"
|
|
if act and act.get("alert"):
|
|
camp_text += f"\n:warning: {act['alert'][:130]}"
|
|
|
|
v_blocks.append({"type": "section", "text": {"type": "mrkdwn", "text": camp_text}})
|
|
|
|
# Approve/Reject buttons for campaign action
|
|
if act and atype in _ACTIONABLE:
|
|
effect = _effect_text(act, budget)
|
|
if effect:
|
|
v_blocks.append({"type": "section", "text": {"type": "mrkdwn", "text": effect}})
|
|
v_blocks.append({
|
|
"type": "actions",
|
|
"elements": [
|
|
{
|
|
"type": "button",
|
|
"text": {"type": "plain_text", "text": "✅ Aprobar"},
|
|
"style": "primary",
|
|
"value": f"approve:{act['row_id']}",
|
|
"action_id": f"approve_{act['row_id']}",
|
|
},
|
|
{
|
|
"type": "button",
|
|
"text": {"type": "plain_text", "text": "❌ Rechazar"},
|
|
"style": "danger",
|
|
"value": f"reject:{act['row_id']}",
|
|
"action_id": f"reject_{act['row_id']}",
|
|
},
|
|
],
|
|
})
|
|
|
|
# Adset table — top 3, only for non-MAINTAIN campaigns
|
|
if atype != "MAINTAIN" and adsets:
|
|
adset_table = _adset_ad_table(adsets[:3], "Conjuntos de anuncios (3 días)", show_bid=True)
|
|
if adset_table:
|
|
for chunk in [adset_table[i:i+2900] for i in range(0, len(adset_table), 2900)]:
|
|
v_blocks.append({"type": "section", "text": {"type": "mrkdwn", "text": chunk}})
|
|
|
|
# Ad pause buttons
|
|
v_blocks.extend(_ad_action_blocks(ads))
|
|
|
|
_post(
|
|
"chat.postMessage",
|
|
channel=config.SLACK_CHANNEL_ID,
|
|
blocks=v_blocks,
|
|
text=f"Detalle vertical: {v}",
|
|
)
|
|
|
|
return ts
|
|
|
|
|
|
def send_execution_summary(log: dict):
|
|
"""Resumen plano de ejecución (fallback)."""
|
|
mode_label = "DRY RUN" if log.get("mode") == "DRY_RUN" else "PRODUCCIÓN"
|
|
text = (
|
|
f":bar_chart: *Meta Optimizer — Resumen diario* ({mode_label})\n"
|
|
f"• Campañas analizadas: {log.get('campaigns_analyzed', 0)}\n"
|
|
f"• Acciones propuestas: {log.get('actions_proposed', 0)}\n"
|
|
f"• Acciones ejecutadas: {log.get('actions_executed', 0)}\n"
|
|
f"• Duración: {log.get('duration_seconds', 0):.1f}s"
|
|
)
|
|
_post("chat.postMessage", channel=config.SLACK_CHANNEL_ID, text=text)
|