Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

4.2 KB
Raw Blame
import uuid
from typing import Optional

import structlog

from posthog.email import EmailMessage, raise_if_delivery_rejected
from posthog.helpers.email_formatting import render_ai_email_html
from posthog.utils import absolute_uri

from products.exports.backend.models.exported_asset import ExportedAsset
from products.subscriptions.backend.logic.subscription_utils import (
    MAX_INSIGHTS,
    UTM_TAGS_BASE,
    _has_asset_failed,
    failed_asset_details,
    next_delivery_date_display,
)
from products.subscriptions.backend.models.subscription import Subscription, get_unsubscribe_token

logger = structlog.get_logger(__name__)


def _get_asset_data_for_email(asset: ExportedAsset) -> dict:
    if _has_asset_failed(asset):
        details = failed_asset_details(asset)
        return {
            "error": True,
            "insight_name": details.insight_name,
            "error_message": details.error_text,
        }

    return {
        "error": False,
        "image_url": asset.get_subscription_delivery_content_url(),
    }


def send_email_subscription_report(
    email: str,
    subscription: Subscription,
    assets: list[ExportedAsset],
    invite_message: Optional[str] = None,
    total_asset_count: Optional[int] = None,
    send_async: bool = True,
    change_summary: Optional[str] = None,
    summary_skipped_over_budget: bool = False,
    delivery_id: Optional[uuid.UUID] = None,
) -> None:
    utm_tags = f"{UTM_TAGS_BASE}&utm_medium=email"

    inviter = subscription.created_by
    is_invite = invite_message is not None
    self_invite = inviter and inviter.email == email

    subject = "PostHog Report"
    invite_summary = None

    resource_info = subscription.resource_info
    if not resource_info:
        raise NotImplementedError("This type of subscription resource is not supported")

    subject = f"PostHog {resource_info.kind} report - {resource_info.name}"
    delivery_key = "unscheduled"
    if subscription.next_delivery_date is not None:
        delivery_key = subscription.next_delivery_date.isoformat()
    if delivery_id is not None:
        delivery_key = str(delivery_id)
    campaign_key = f"{resource_info.kind.lower()}_subscription_report_{subscription.pk}_{delivery_key}"

    unsubscribe_url = absolute_uri(f"/unsubscribe?token={get_unsubscribe_token(subscription, email)}&{utm_tags}")

    if is_invite:
        invite_summary = (
            f"This subscription is {subscription.summary}. "
            f"The next subscription will be sent on {next_delivery_date_display(subscription)}"
        )
        if self_invite:
            subject = f"You have been subscribed to a PostHog {resource_info.kind}"
        else:
            inviter_name = (inviter.first_name if inviter else None) or "Someone"
            subject = f"{inviter_name} subscribed you to a PostHog {resource_info.kind}"
        invite_delivery_key = str(delivery_id) if delivery_id is not None else str(uuid.uuid4())
        campaign_key = f"{resource_info.kind.lower()}_subscription_new_{subscription.pk}_{invite_delivery_key}"

    message = EmailMessage(
        campaign_key=campaign_key,
        subject=subject,
        template_name="subscription_report",
        template_context={
            "asset_data": [_get_asset_data_for_email(x) for x in assets],
            "resource_noun": resource_info.kind,
            "resource_name": resource_info.name,
            "resource_url": f"{resource_info.url}?{utm_tags}",
            "subscription_url": f"{subscription.url}?{utm_tags}",
            "unsubscribe_url": unsubscribe_url,
            "inviter": inviter if is_invite else None,
            "self_invite": self_invite,
            "invite_message": invite_message,
            "invite_summary": invite_summary,
            "total_asset_count": total_asset_count,
            "max_insights": MAX_INSIGHTS,
            "change_summary": change_summary,
            "change_summary_html": render_ai_email_html(change_summary) if change_summary else None,
            "summary_skipped_over_budget": summary_skipped_over_budget,
            "billing_url": absolute_uri(f"/organization/billing?{utm_tags}"),
        },
    )
    message.add_recipient(email=email)
    message.send(send_async=send_async)

    if not send_async:
        raise_if_delivery_rejected(campaign_key, email)