feat: Brevo double opt-in + contact sync
- 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)
This commit is contained in:
Roberto Musso
224
app/brevo.py
Normal file
224
app/brevo.py
Normal file
@@ -0,0 +1,224 @@
|
||||
"""
|
||||
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>"""
|
||||
Reference in New Issue
Block a user