: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
import posthog from 'posthog-js'
import { getAccessControlDisabledReason } from 'lib/utils/accessControlUtils'
import {
AccessControlLevel,
AccessControlResourceType,
AnyPropertyFilter,
PropertyFilterType,
PropertyOperator,
} from '~/types'
import { urlForNewBroadcastWithAudience } from '../Broadcasts/broadcastAudiencePrefill'
import type { EmailDraftRequestApi } from '../generated/api.schemas'
import { type WorkflowTriggerConfig, urlForNewWorkflowWithTrigger } from '../Workflows/workflowTriggerPrefill'
import { MessageDraft } from './messageDrafts'
export type MessageAudienceDestination = 'broadcast' | 'workflow'
export interface MessageAudience {
properties: AnyPropertyFilter[]
source: string
broadcastName?: string
/** The workflow to start. Without one, the workflow sends to the same people with a batch trigger. */
workflowTrigger?: WorkflowTriggerConfig
broadcastEmail?: MessageDraft
workflowEmail?: MessageDraft
/** The record the email is about, as "<kind>:<id>". A later broadcast about it warns that it was already sent. */
sourceRecord?: string
draftSource?: EmailDraftRequestApi
}
export function cohortAudienceProperties(cohort: { id: number; name?: string | null }): AnyPropertyFilter[] {
return [
{
key: 'id',
type: PropertyFilterType.Cohort,
value: cohort.id,
operator: PropertyOperator.In,
cohort_name: cohort.name ?? undefined,
},
]
}
export function messageAudienceUrl(audience: MessageAudience, destination: MessageAudienceDestination): string {
if (destination === 'broadcast') {
return urlForNewBroadcastWithAudience({
properties: audience.properties,
name: audience.broadcastName,
source: audience.source,
sourceRecord: audience.sourceRecord,
email: audience.broadcastEmail,
draftSource: audience.draftSource,
})
}
return urlForNewWorkflowWithTrigger(
audience.workflowTrigger ?? { type: 'batch', filters: { properties: audience.properties } },
audience.source,
audience.workflowEmail,
audience.draftSource
)
}
export function captureMessageAudienceClicked(source: string, destination: MessageAudienceDestination): void {
// pinned: analytics event name
posthog.capture('message audience clicked', { source, destination })
}
/** Why this person can't start a broadcast or workflow, if they can't: both need editor access to workflows. */
export function messageAudienceAccessDisabledReason(): string | null {
return getAccessControlDisabledReason(AccessControlResourceType.Workflow, AccessControlLevel.Editor)
}