feat: self-serve 14-day free trial (activate from demo, embed snippet, scheduler pauses expired trials)

app/demo_ui/index.html

@@ -138,10 +138,22 @@
       </div>
       <p class="hint">Esta demo se borra sola en 48 horas.</p>
       <div class="ctablock">
-        <h3>¿Lo quieres en tu web y tu WhatsApp?</h3>
-        <p>29 € al mes, sin alta y sin permanencia. Cancela cuando quieras y te lo configuro yo entero: tú no tocas nada.</p>
-        <a class="btn" href="https://buy.stripe.com/eVq5kC5h6cQS9qa5ar5wI04">Lo quiero — 29 €/mes</a>
-        <span class="more"><a href="https://buy.stripe.com/5kQcN4bFu2ce31MfP55wI02">o pago único: 200 € de alta + 10 € cada 3 meses</a></span>
+        <h3>Pruébalo gratis 14 días en tu web</h3>
+        <p>Sin tarjeta. Pega un código y tu bot atiende a tus clientes ya. A los 14 días, si te sirve, 29 € al mes sin permanencia; si no, se desactiva solo.</p>
+        <div id="activate-form" class="sharerow">
+          <input id="activate-email" type="email" inputmode="email" placeholder="tu@email.com" autocomplete="email" />
+          <button id="activate-btn" class="btn" type="button">Activar gratis 14 días</button>
+        </div>
+        <p id="activate-err" class="hint" style="color:#ffe0d6" hidden></p>
+        <div id="activated" hidden>
+          <p><b>Listo, tu bot está activo 14 días.</b> Pega este código en tu web, justo antes de &lt;/body&gt;:</p>
+          <div class="sharerow">
+            <input id="embed-code" type="text" readonly />
+            <button id="copy-embed" class="btn small" type="button">Copiar</button>
+          </div>
+          <p class="more">Te lo hemos enviado también por email. Gestiona tu bot (textos, color, idiomas) en <a id="portal-link" href="https://atendyo.com/portal" target="_blank" rel="noopener">tu panel</a>.</p>
+        </div>
+        <span class="more"><a href="https://buy.stripe.com/eVq5kC5h6cQS9qa5ar5wI04">o paga ya 29 €/mes</a> · <a href="https://buy.stripe.com/5kQcN4bFu2ce31MfP55wI02">pago único 200 €</a></span>
       </div>
       <div class="opine" id="opinar">
         <h3>Deja tu opinión</h3>
@@ -399,8 +411,10 @@ function showExpired(){
   document.getElementById("expired-note").hidden = false;
 }
 
+var activeSlug = "";
 function showReady(slug){
   show("state-c");
+  activeSlug = slug;
   document.getElementById("share-url").value = location.origin + "/demo?d=" + slug;
   if (!widgetMounted) {
     widgetMounted = true;
@@ -444,6 +458,41 @@ document.getElementById("retry-btn").addEventListener("click", function(){
   document.getElementById("url-input").focus();
 });
 
+// Self-serve free trial: activate the demo into a live 14-day trial, no card.
+document.getElementById("activate-btn").addEventListener("click", function(){
+  var email = (document.getElementById("activate-email").value || "").trim();
+  var err = document.getElementById("activate-err");
+  err.hidden = true;
+  if (email.indexOf("@") < 0) { err.textContent = "Pon un email válido."; err.hidden = false; return; }
+  var btn = document.getElementById("activate-btn");
+  btn.disabled = true; btn.textContent = "Activando…";
+  fetch(API + "/demo/" + encodeURIComponent(activeSlug) + "/activate", {
+    method: "POST",
+    headers: {"Content-Type": "application/json"},
+    body: JSON.stringify({email: email})
+  })
+  .then(function(r){ return r.ok ? r.json() : r.json().then(function(j){ throw new Error(j.detail || "error"); }); })
+  .then(function(res){
+    document.getElementById("activate-form").hidden = true;
+    document.getElementById("embed-code").value = res.embed;
+    if (res.portal_url) document.getElementById("portal-link").href = res.portal_url;
+    document.getElementById("activated").hidden = false;
+  })
+  .catch(function(e){
+    err.textContent = (e && e.message) ? e.message : "No se pudo activar. Inténtalo de nuevo.";
+    err.hidden = false;
+    btn.disabled = false; btn.textContent = "Activar gratis 14 días";
+  });
+});
+
+document.getElementById("copy-embed").addEventListener("click", function(){
+  var i = document.getElementById("embed-code");
+  i.select(); i.setSelectionRange(0, 99999);
+  try { document.execCommand("copy"); } catch (e) {}
+  var b = document.getElementById("copy-embed");
+  var old = b.textContent; b.textContent = "Copiado"; setTimeout(function(){ b.textContent = old; }, 1500);
+});
+
 document.getElementById("copy-btn").addEventListener("click", function(){
   var i = document.getElementById("share-url");
   i.select(); i.setSelectionRange(0, 99999);

app/models.py

@@ -100,6 +100,12 @@ class Tenant(Base):
     demo_expires_at: Mapped[datetime | None] = mapped_column(
         DateTime(timezone=True), nullable=True
     )
+    # Self-serve free trial: a demo the prospect ACTIVATED (no card). The bot
+    # stays live on their site until trial_ends_at; the scheduler then pauses it
+    # and emails the payment link, unless a Stripe subscription went active.
+    trial_ends_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True
+    )
     # Free-text instructions from the merchant appended to the system prompt
     # ("we are a consultancy, never quote delivery times", "your job is to sell
     # product X"...). Lets each business tune its assistant's behavior.

app/routes/demo.py

@@ -49,13 +49,14 @@ from app.rag import extract
 from app.rag.chunk import chunk_text
 from app.ratelimit import RateLimiter
 from app.store import get_config, upsert_config
-from app.tenancy import create_tenant, get_tenant_by_slug
+from app.tenancy import create_tenant, generate_dashboard_token, get_tenant_by_slug
 
 log = logging.getLogger(__name__)
 
 router = APIRouter()
 
 DEMO_TTL_HOURS = 48
+TRIAL_DAYS = 14  # self-serve free trial length (no card upfront)
 DEMO_DAILY_CAP = 40  # global starts/day, persisted in Config under _DAILY_KEY
 DEMO_MAX_ACTIVE = 100  # live demo tenants at any moment
 DEMO_STARTS_PER_IP_PER_HOUR = 3
@@ -458,6 +459,78 @@ async def demo_start(
     return {"slug": slug, "stage": "leyendo", "expires_hours": DEMO_TTL_HOURS}
 
 
+def _embed_snippet(slug: str) -> str:
+    return f'<script src="{PUBLIC_DEMO_BASE}/widget.js?t={slug}" defer></script>'
+
+
+class DemoActivateIn(BaseModel):
+    email: str = ""
+
+
+@router.post("/demo/{slug}/activate")
+async def demo_activate(
+    slug: str, body: DemoActivateIn, db: AsyncSession = Depends(get_session)
+) -> dict:
+    """Self-serve free trial: the prospect liked their demo and clicks 'activate'.
+    We promote the disposable demo tenant into a real 14-day trial (no card): it
+    stops self-destructing, the bot stays live on their site, and they get the
+    embed snippet + a portal login. The scheduler pauses it at trial end unless a
+    subscription went active. No human (Victor) in the loop."""
+    if "@" not in (body.email or ""):
+        raise HTTPException(status_code=422, detail="Indica un email válido.")
+    tenant = await get_tenant_by_slug(db, slug)
+    if tenant is None:
+        raise HTTPException(status_code=404, detail="Demo no encontrada o caducada.")
+
+    already = bool(tenant.trial_ends_at) and not tenant.is_demo
+    if not already:
+        now = datetime.now(UTC)
+        tenant.is_demo = False
+        tenant.demo_expires_at = None
+        tenant.trial_ends_at = now + timedelta(days=TRIAL_DAYS)
+        tenant.chatbot_enabled = True
+        tenant.disabled_reason = ""
+        tenant.support_email = body.email
+        if not tenant.dashboard_token:
+            await generate_dashboard_token(db, tenant)
+        await db.flush()
+        await db.commit()
+        _spawn(_email_trial_activated(body.email, slug, tenant.dashboard_token))
+
+    return {
+        "status": "activated",
+        "trial_days": TRIAL_DAYS,
+        "embed": _embed_snippet(slug),
+        "dashboard_token": tenant.dashboard_token,
+        "portal_url": f"{PUBLIC_DEMO_BASE}/portal",
+    }
+
+
+async def _email_trial_activated(email: str, slug: str, token: str) -> None:
+    """Confirm the trial + hand over the embed snippet and portal login."""
+    if not email or "@" not in email:
+        return
+    snippet = _embed_snippet(slug)
+    body = (
+        "Hola,\n\n"
+        f"Tu asistente de Atendyo ya está activo, gratis durante {TRIAL_DAYS} días, "
+        "sin tarjeta.\n\n"
+        "1) Pega este código en tu web (antes de </body>) y el bot aparece solo:\n"
+        f"{snippet}\n\n"
+        "   - Shopify: Tema > Editar código > theme.liquid, antes de </body>.\n"
+        "   - WooCommerce/WordPress: un bloque HTML o el footer del tema.\n\n"
+        f"2) Gestiona tu bot (textos, color, idiomas) entrando en {PUBLIC_DEMO_BASE}/portal "
+        f"con esta clave:\n{token}\n\n"
+        f"A los {TRIAL_DAYS} días, si te sirve, son 29 euros al mes sin permanencia. "
+        "Si no, no haces nada y se desactiva solo.\n\n"
+        "Un saludo,\nVictor — Atendyo"
+    )
+    try:
+        await mailer.send_email(get_settings(), email, "Tu bot ya está activo (prueba gratis)", body)
+    except Exception:  # noqa: BLE001 - email must never break activation
+        log.warning("trial activation email failed (non-fatal)", exc_info=True)
+
+
 @router.get("/demo/status")
 async def demo_status(d: str, db: AsyncSession = Depends(get_session)) -> dict:
     """Live progress for the demo page. Falls back to the DB when the

app/scheduler.py

@@ -15,6 +15,7 @@ from datetime import UTC, datetime, timedelta
 from sqlalchemy import or_, select
 from sqlalchemy.ext.asyncio import AsyncSession
 
+from app import mailer
 from app.config import get_settings
 from app.db import get_sessionmaker
 from app.models import KnowledgeSource, Tenant
@@ -28,10 +29,14 @@ _KEY = "last_url_reindex"
 _PRODUCT_KEY = "last_product_sync"
 _BILLING_KEY = "last_billing_reconcile"
 _DEMO_PURGE_KEY = "last_demo_purge"
+_TRIAL_KEY = "last_trial_sweep"
 REINDEX_EVERY = timedelta(days=7)
 PRODUCT_SYNC_EVERY = timedelta(days=1)  # catalog text changes more often than docs
 BILLING_RECONCILE_EVERY = timedelta(days=1)
 DEMO_PURGE_EVERY = timedelta(days=1)  # demos live 48h; a daily sweep is enough
+TRIAL_SWEEP_EVERY = timedelta(hours=12)  # pause trials promptly once they expire
+# 29 EUR/mo self-serve link (mirrors app/routes/demo.py MONTHLY_BUY_LINK).
+TRIAL_PAY_LINK = "https://buy.stripe.com/eVq5kC5h6cQS9qa5ar5wI04"
 CHECK_EVERY_SECONDS = 6 * 3600
 FIRST_DELAY_SECONDS = 120  # let boot settle before the first check
 
@@ -210,6 +215,63 @@ async def _maybe_purge_demos() -> None:
             log.info("demo purge removed %d expired demo tenant(s)", n)
 
 
+async def _email_trial_ended(email: str, slug: str) -> None:
+    body = (
+        "Hola,\n\n"
+        "Tu prueba gratis de Atendyo ha terminado y el bot se ha desactivado en tu "
+        "web. Si te ha sido útil, actívalo de nuevo por 29 euros al mes, sin "
+        "permanencia y cancelas cuando quieras:\n"
+        f"{TRIAL_PAY_LINK}\n\n"
+        "En cuanto pagues, vuelve a funcionar al instante con toda tu configuración "
+        "intacta. Si no, no tienes que hacer nada.\n\n"
+        "Un saludo,\nVictor — Atendyo"
+    )
+    try:
+        await mailer.send_email(get_settings(), email, "Tu prueba de Atendyo ha terminado", body)
+    except Exception:  # noqa: BLE001 - email must never break the sweep
+        log.warning("trial-ended email failed for %s", slug, exc_info=True)
+
+
+async def pause_expired_trials(db: AsyncSession) -> int:
+    """Pause self-serve trials whose 14 days are up and who never subscribed:
+    flip chatbot_enabled off (the kill-switch already cuts service everywhere,
+    even with the embed still on their site) and email the payment link. A paid
+    tenant has a stripe_subscription_id and is skipped. chatbot_enabled=False is
+    the idempotency guard — a paused trial is never reselected/re-emailed."""
+    now = datetime.now(UTC)
+    expired = (
+        await db.execute(
+            select(Tenant).where(
+                Tenant.is_demo.is_(False),
+                Tenant.trial_ends_at.is_not(None),
+                Tenant.trial_ends_at < now,
+                Tenant.chatbot_enabled.is_(True),
+                Tenant.stripe_subscription_id == "",
+            )
+        )
+    ).scalars().all()
+    for tenant in expired:
+        log.info("trial sweep: pausing expired trial %s", tenant.slug)
+        tenant.chatbot_enabled = False
+        tenant.disabled_reason = "trial"
+        if tenant.support_email:
+            await _email_trial_ended(tenant.support_email, tenant.slug)
+    await db.commit()
+    return len(expired)
+
+
+async def _maybe_pause_trials() -> None:
+    async with get_sessionmaker()() as db:
+        now = datetime.now(UTC)
+        if not _due(await get_config(db, _TRIAL_KEY) or {}, TRIAL_SWEEP_EVERY, now):
+            return
+        n = await pause_expired_trials(db)
+        await upsert_config(db, _TRIAL_KEY, {"at": now.isoformat()})
+        await db.commit()
+        if n:
+            log.info("trial sweep paused %d expired trial(s)", n)
+
+
 async def run_periodic_reindex() -> None:
     await asyncio.sleep(FIRST_DELAY_SECONDS)
     while True:
@@ -218,6 +280,7 @@ async def run_periodic_reindex() -> None:
         # reindex for the same reason — an expired demo gets no last crawl.
         for tick in (
             _maybe_reconcile_billing,
+            _maybe_pause_trials,
             _maybe_purge_demos,
             _maybe_reindex,
             _maybe_sync_products,

migrations/versions/0022_trial_ends_at.py

@@ -0,0 +1,28 @@
+"""tenants.trial_ends_at: self-serve free-trial deadline (no card upfront).
+
+Additive, idempotent on Postgres (ADD COLUMN IF NOT EXISTS). On other dialects
+it is a no-op (tests/dev use create_all which already has the column).
+"""
+
+from __future__ import annotations
+
+from alembic import op
+
+revision = "0022_trial_ends_at"
+down_revision = "0021_reviews"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    if op.get_bind().dialect.name != "postgresql":
+        return
+    op.execute(
+        "ALTER TABLE tenants ADD COLUMN IF NOT EXISTS trial_ends_at TIMESTAMPTZ"
+    )
+
+
+def downgrade() -> None:
+    if op.get_bind().dialect.name != "postgresql":
+        return
+    op.execute("ALTER TABLE tenants DROP COLUMN IF EXISTS trial_ends_at")