: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.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
feat(messaging): track transactional email status reads (#125312)
Harley Alexander469d2691fb24
diff --git a/products/messaging/backend/presentation/views/transactional_email_status.py b/products/messaging/backend/presentation/views/transactional_email_status.pyindex 8a5fcfa8f41b..e31444b14792 100644--- a/products/messaging/backend/presentation/views/transactional_email_status.py+++ b/products/messaging/backend/presentation/views/transactional_email_status.py@@ -1,6 +1,8 @@from typing import Anyfrom uuid import UUID+import structlog+import posthoganalyticsfrom drf_spectacular.types import OpenApiTypesfrom drf_spectacular.utils import OpenApiParameter, OpenApiResponse, extend_schemafrom rest_framework import exceptions, serializers, viewsets@@ -12,12 +14,15 @@ from rest_framework.throttling import BaseThrottlefrom posthog.api.routing import TeamAndOrgViewSetMixinfrom posthog.auth import ProjectSecretAPIKeyAuthentication+from posthog.event_usage import groupsfrom posthog.permissions import is_authenticated_via_project_secret_api_keyfrom posthog.rate_limit import PersonalOrProjectSecretApiKeyRateThrottle, ProjectSecretApiKeyTeamRateThrottle-from products.messaging.backend.facade.transactional_email import EmailDeliveryStatus, get_email_status+from products.messaging.backend.facade.transactional_email import EmailDeliveryStatus, EmailStatus, get_email_statusfrom products.messaging.backend.presentation.views.message_templates import require_transactional_email_api+logger = structlog.get_logger(__name__)+MESSAGE_ID_PARAMETER = OpenApiParameter(name="id",type=OpenApiTypes.UUID,@@ -108,11 +113,35 @@ class MessagingEmailsViewSet(TeamAndOrgViewSetMixin, viewsets.ViewSet):if not is_authenticated_via_project_secret_api_key(request):raise exceptions.NotAuthenticated()require_transactional_email_api(self.team)- try:- message_id = UUID(str(pk))- except ValueError:- raise NotFound()- email_status = get_email_status(self.team_id, message_id)+ email_status = self._email_status(pk)+ self._report_status_read(request, email_status)if email_status is None:raise NotFound()return Response(EmailStatusSerializer(email_status).data)++ def _email_status(self, pk: str | None) -> EmailStatus | None:+ try:+ message_id = UUID(str(pk))+ except ValueError:+ return None+ return get_email_status(self.team_id, message_id)++ def _report_status_read(self, request: Request, email_status: EmailStatus | None) -> None:+ # report_user_action drops the synthetic user behind a project secret API key, so capture directly. That+ # user is not a Django User, so its distinct_id is read without a type.+ distinct_id = getattr(request.user, "distinct_id", None)+ if not isinstance(distinct_id, str):+ return+ try:+ posthoganalytics.capture(+ distinct_id=distinct_id,+ event="transactional email api status read",+ properties={+ "team_id": self.team_id,+ "outcome": "not_found" if email_status is None else "found",+ "status": email_status.status if email_status else None,+ },+ groups=groups(self.organization, self.team),+ )+ except Exception as e:+ logger.warning("Failed to capture transactional email status read event", error=str(e))diff --git a/products/messaging/backend/tests/api/test_transactional_email_status.py b/products/messaging/backend/tests/api/test_transactional_email_status.pyindex 0387dc3f2f0d..44955c8b4316 100644--- a/products/messaging/backend/tests/api/test_transactional_email_status.py+++ b/products/messaging/backend/tests/api/test_transactional_email_status.py@@ -112,9 +112,17 @@ class TestTransactionalEmailStatus(ClickhouseTestMixin, APIBaseTest):def test_reports_the_latest_status_of_the_send(self, _flag, _name, rows, expected_status, status_offset, reason):self._status_rows(rows)- response = self.client.get(self._url(self.message_id))+ with patch(+ "products.messaging.backend.presentation.views.transactional_email_status.posthoganalytics.capture"+ ) as capture:+ response = self.client.get(self._url(self.message_id))assert response.status_code == status.HTTP_200_OK, response.json()+ assert capture.call_args.kwargs["properties"] == {+ "team_id": self.team.id,+ "outcome": "found",+ "status": expected_status,+ }assert response.json() == {"id": self.message_id,"status": expected_status,@@ -137,9 +145,13 @@ class TestTransactionalEmailStatus(ClickhouseTestMixin, APIBaseTest):self._status_rows([("sent", 2, "")], team=Team.objects.create(organization=self.organization, name="Other"))ids = {"message_id": self.message_id, "old": self._message_id(datetime.now(UTC) - timedelta(days=31))}- response = self.client.get(self._url(ids.get(message_id, message_id)))+ with patch(+ "products.messaging.backend.presentation.views.transactional_email_status.posthoganalytics.capture"+ ) as capture:+ response = self.client.get(self._url(ids.get(message_id, message_id)))assert response.status_code == status.HTTP_404_NOT_FOUND+ assert capture.call_args.kwargs["properties"]["outcome"] == "not_found"@parameterized.expand([