- Add brevo.py: transactional email sending + contact list sync via Brevo API - Add token.py: stateless HMAC-signed confirmation tokens (no DB migration needed) - Update routes.py: POST /waitlist sends confirmation email, GET /waitlist/confirm verifies token - Update config.py: Brevo + confirmation settings (gracefully disabled when BREVO_API_KEY is empty) - Update .env.example with new Brevo and confirmation variables - Add httpx dependency - Add 8 new tests (token roundtrip/expiry/tamper, confirm endpoint, Brevo mock)
225 lines
8.6 KiB
Python
225 lines
8.6 KiB
Python
"""
|
|
Brevo (ex-Sendinblue) integration.
|
|
|
|
- Send transactional confirmation emails
|
|
- Sync confirmed contacts to a Brevo list
|
|
"""
|
|
|
|
import logging
|
|
|
|
import httpx
|
|
|
|
from app.config import settings
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
BREVO_API = "https://api.brevo.com/v3"
|
|
|
|
|
|
def _headers() -> dict[str, str]:
|
|
return {
|
|
"api-key": settings.BREVO_API_KEY,
|
|
"Content-Type": "application/json",
|
|
"Accept": "application/json",
|
|
}
|
|
|
|
|
|
async def send_confirmation_email(email: str, confirm_url: str) -> bool:
|
|
"""Send a double opt-in confirmation email. Returns True on success."""
|
|
if not settings.brevo_configured:
|
|
logger.warning("Brevo not configured — skipping confirmation email for %s***", email[:3])
|
|
return False
|
|
|
|
payload = {
|
|
"sender": {
|
|
"name": settings.BREVO_SENDER_NAME,
|
|
"email": settings.BREVO_SENDER_EMAIL,
|
|
},
|
|
"to": [{"email": email}],
|
|
"subject": "Confirm your spot on the adiuvAI waitlist",
|
|
"htmlContent": _confirmation_html(confirm_url),
|
|
}
|
|
|
|
try:
|
|
async with httpx.AsyncClient(timeout=10) as client:
|
|
resp = await client.post(f"{BREVO_API}/smtp/email", headers=_headers(), json=payload)
|
|
resp.raise_for_status()
|
|
logger.info("Confirmation email sent to %s***", email[:3])
|
|
return True
|
|
except httpx.HTTPError:
|
|
logger.exception("Failed to send confirmation email to %s***", email[:3])
|
|
return False
|
|
|
|
|
|
async def add_contact_to_list(email: str) -> bool:
|
|
"""Add a confirmed contact to the Brevo waitlist list. Returns True on success."""
|
|
if not settings.brevo_configured:
|
|
logger.warning("Brevo not configured — skipping contact sync for %s***", email[:3])
|
|
return False
|
|
|
|
if settings.BREVO_LIST_ID == 0:
|
|
logger.warning("BREVO_LIST_ID not set — skipping contact sync")
|
|
return False
|
|
|
|
payload = {
|
|
"email": email,
|
|
"listIds": [settings.BREVO_LIST_ID],
|
|
"updateEnabled": True,
|
|
}
|
|
|
|
try:
|
|
async with httpx.AsyncClient(timeout=10) as client:
|
|
resp = await client.post(f"{BREVO_API}/contacts", headers=_headers(), json=payload)
|
|
resp.raise_for_status()
|
|
logger.info("Contact synced to Brevo list %d: %s***", settings.BREVO_LIST_ID, email[:3])
|
|
return True
|
|
except httpx.HTTPError:
|
|
logger.exception("Failed to sync contact to Brevo: %s***", email[:3])
|
|
return False
|
|
|
|
|
|
def _confirmation_html(confirm_url: str) -> str:
|
|
"""Email template aligned with the adiuvAI landing page brand."""
|
|
return f"""\
|
|
<!DOCTYPE html>
|
|
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
|
<meta name="color-scheme" content="light">
|
|
<meta name="supported-color-schemes" content="light">
|
|
<title>Confirm your spot — adiuvAI</title>
|
|
<!--[if mso]><style>table,td{{font-family:Arial,sans-serif!important;}}</style><![endif]-->
|
|
</head>
|
|
<body style="margin:0;padding:0;width:100%;background-color:#f4edf3;
|
|
font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;
|
|
-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;">
|
|
|
|
<!-- Preheader (hidden text for inbox preview) -->
|
|
<div style="display:none;font-size:1px;color:#f4edf3;line-height:1px;max-height:0;max-width:0;opacity:0;overflow:hidden;">
|
|
Confirm your email to secure your early access spot on the adiuvAI waitlist.
|
|
</div>
|
|
|
|
<!-- Outer wrapper -->
|
|
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"
|
|
style="background-color:#f4edf3;">
|
|
<tr><td align="center" style="padding:48px 16px;">
|
|
|
|
<!-- Card -->
|
|
<table role="presentation" width="520" cellpadding="0" cellspacing="0" border="0"
|
|
style="max-width:520px;width:100%;background-color:#ffffff;
|
|
border-radius:20px;overflow:hidden;
|
|
box-shadow:0 4px 16px rgba(0,0,0,0.03),0 1px 2px rgba(0,0,0,0.02);">
|
|
|
|
<!-- Gold accent bar -->
|
|
<tr><td style="height:4px;background:linear-gradient(135deg,#fbc881 0%,#e5a94e 100%);
|
|
font-size:0;line-height:0;"> </td></tr>
|
|
|
|
<!-- Logo row -->
|
|
<tr><td align="center" style="padding:36px 40px 0;">
|
|
<table role="presentation" cellpadding="0" cellspacing="0" border="0">
|
|
<tr>
|
|
<!-- Compass SVG (inline, matching the website nav-logo) -->
|
|
<td style="padding-right:8px;vertical-align:middle;">
|
|
<!--[if mso]>
|
|
<v:group style="width:28px;height:28px;" coordsize="64,64">
|
|
<v:shape style="width:64;height:64;" path="M32,4 L48,32 L16,32 Z" fillcolor="#fbc881" stroked="f"/>
|
|
<v:shape style="width:64;height:64;" path="M16,32 L48,32 L32,60 Z" fillcolor="#040404" stroked="f"/>
|
|
</v:group>
|
|
<![endif]-->
|
|
<!--[if !mso]><!-->
|
|
<svg viewBox="0 0 64 64" width="28" height="28" xmlns="http://www.w3.org/2000/svg"
|
|
style="display:block;width:28px;height:28px;">
|
|
<path d="M32,4 L48,32 L16,32 Z" fill="#fbc881"/>
|
|
<path d="M16,32 L48,32 L32,60 Z" fill="#040404"/>
|
|
<circle cx="32" cy="32" r="2.5" fill="#040404" opacity="0.18"/>
|
|
</svg>
|
|
<!--<![endif]-->
|
|
</td>
|
|
<td style="vertical-align:middle;font-size:18px;font-weight:400;
|
|
color:#040404;letter-spacing:-0.02em;">
|
|
adiuv<span style="font-weight:700;color:#e5a94e;">AI</span>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</td></tr>
|
|
|
|
<!-- Body -->
|
|
<tr><td style="padding:32px 40px 0;">
|
|
|
|
<!-- Badge -->
|
|
<table role="presentation" cellpadding="0" cellspacing="0" border="0"
|
|
style="margin:0 auto 24px;">
|
|
<tr><td style="padding:5px 14px;border-radius:50px;
|
|
background-color:rgba(251,200,129,0.12);
|
|
border:1px solid rgba(251,200,129,0.2);
|
|
font-size:11px;font-weight:600;letter-spacing:0.06em;
|
|
text-transform:uppercase;color:#e5a94e;">
|
|
● One more step
|
|
</td></tr>
|
|
</table>
|
|
|
|
<!-- Heading -->
|
|
<h1 style="margin:0 0 16px;font-size:24px;font-weight:600;
|
|
letter-spacing:-0.03em;line-height:1.2;color:#040404;text-align:center;">
|
|
Confirm your spot on<br>the waitlist
|
|
</h1>
|
|
|
|
<!-- Paragraph -->
|
|
<p style="margin:0 0 28px;font-size:15px;line-height:1.7;color:#8a8ea9;
|
|
text-align:center;">
|
|
Thanks for signing up! Please confirm your email address
|
|
so we can keep you in the loop when adiuvAI launches.
|
|
</p>
|
|
|
|
<!-- CTA Button -->
|
|
<table role="presentation" cellpadding="0" cellspacing="0" border="0"
|
|
style="margin:0 auto;">
|
|
<tr><td align="center" style="border-radius:50px;background-color:#040404;">
|
|
<a href="{confirm_url}"
|
|
target="_blank"
|
|
style="display:inline-block;padding:14px 36px;
|
|
font-size:15px;font-weight:600;
|
|
color:#fbfbfb;text-decoration:none;
|
|
border-radius:50px;
|
|
font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
|
|
Confirm my email
|
|
</a>
|
|
</td></tr>
|
|
</table>
|
|
|
|
<!-- Expiry note -->
|
|
<p style="margin:20px 0 0;font-size:13px;color:#c8c3cd;text-align:center;">
|
|
This link expires in {settings.CONFIRM_TOKEN_EXPIRY_HOURS} hours.
|
|
</p>
|
|
|
|
</td></tr>
|
|
|
|
<!-- Divider -->
|
|
<tr><td style="padding:32px 40px 0;">
|
|
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
|
|
<tr><td style="height:1px;background-color:#f4edf3;font-size:0;line-height:0;"> </td></tr>
|
|
</table>
|
|
</td></tr>
|
|
|
|
<!-- Footer -->
|
|
<tr><td style="padding:20px 40px 32px;text-align:center;">
|
|
<p style="margin:0;font-size:12px;color:#c8c3cd;line-height:1.5;">
|
|
If you didn't sign up, simply ignore this email.
|
|
</p>
|
|
<p style="margin:8px 0 0;font-size:12px;color:#c8c3cd;">
|
|
<a href="https://adiuvai.com" style="color:#8a8ea9;text-decoration:underline;
|
|
text-underline-offset:2px;">adiuvai.com</a>
|
|
</p>
|
|
</td></tr>
|
|
|
|
</table>
|
|
<!-- /Card -->
|
|
|
|
</td></tr>
|
|
</table>
|
|
|
|
</body>
|
|
</html>"""
|