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.

5.0 KB
Raw Blame
"""Conversations' consumers on the customer-facing GitHub App, the SupportHog Slack and Teams bots and the Mailgun email routes.

The registry imports this module on the first delivery, so it stays cheap: every callable defers
its own product import.
"""

from posthog.ingress.contracts import DeliveryOwnership, WebhookConsumer, WebhookDelivery
from posthog.ingress.slack.provider import SLACK_EVENT_TYPES, SLACK_INTERACTIVITY_APP, SLACK_INTERACTIVITY_TYPES
from posthog.ingress.teams.provider import TEAMS_ACTIVITY_TYPES


def _run_conversations(delivery: WebhookDelivery) -> None:
    from products.conversations.backend.facade.api import accept_github_event  # noqa: PLC0415

    accept_github_event(delivery)


def _run_slack_events(delivery: WebhookDelivery) -> None:
    from products.conversations.backend.facade.api import accept_slack_event  # noqa: PLC0415

    accept_slack_event(delivery)


def _run_slack_interactivity(delivery: WebhookDelivery) -> None:
    from products.conversations.backend.facade.api import accept_slack_interactivity  # noqa: PLC0415

    accept_slack_interactivity(delivery)


def _slack_ownership(delivery: WebhookDelivery) -> DeliveryOwnership:
    from products.conversations.backend.facade.api import slack_delivery_ownership  # noqa: PLC0415

    return slack_delivery_ownership(delivery)


def _run_teams_events(delivery: WebhookDelivery) -> None:
    from products.conversations.backend.facade.api import accept_teams_event  # noqa: PLC0415

    accept_teams_event(delivery)


def _teams_ownership(delivery: WebhookDelivery) -> DeliveryOwnership:
    from products.conversations.backend.facade.api import teams_delivery_ownership  # noqa: PLC0415

    return teams_delivery_ownership(delivery)


def _run_email_inbound(delivery: WebhookDelivery) -> None:
    from products.conversations.backend.facade.api import accept_mailgun_inbound_message  # noqa: PLC0415

    accept_mailgun_inbound_message(delivery)


def _email_inbound_ownership(delivery: WebhookDelivery) -> DeliveryOwnership:
    from products.conversations.backend.facade.api import mailgun_inbound_delivery_ownership  # noqa: PLC0415

    return mailgun_inbound_delivery_ownership(delivery)


def _run_email_outbound(delivery: WebhookDelivery) -> None:
    from products.conversations.backend.facade.api import accept_mailgun_outbound_message  # noqa: PLC0415

    accept_mailgun_outbound_message(delivery)


def _email_outbound_ownership(delivery: WebhookDelivery) -> DeliveryOwnership:
    from products.conversations.backend.facade.api import mailgun_outbound_delivery_ownership  # noqa: PLC0415

    return mailgun_outbound_delivery_ownership(delivery)


def _run_email_capture(delivery: WebhookDelivery) -> None:
    from products.conversations.backend.facade.api import accept_mailgun_captured_message  # noqa: PLC0415

    accept_mailgun_captured_message(delivery)


def _email_capture_ownership(delivery: WebhookDelivery) -> DeliveryOwnership:
    from products.conversations.backend.facade.api import mailgun_capture_delivery_ownership  # noqa: PLC0415

    return mailgun_capture_delivery_ownership(delivery)


WEBHOOK_CONSUMERS = (
    WebhookConsumer(
        name="conversations",
        provider="github",
        app="posthog",
        event_types=frozenset({"issues", "issue_comment"}),
        handler=_run_conversations,
    ),
    WebhookConsumer(
        name="conversations_slack",
        provider="slack",
        app="supporthog",
        event_types=SLACK_EVENT_TYPES,
        handler=_run_slack_events,
        # The unique inbound receipt row is the idempotency here, so a redelivery must reach it.
        dedup=False,
        ownership=_slack_ownership,
    ),
    WebhookConsumer(
        name="conversations_slack_interactivity",
        provider="slack",
        app=SLACK_INTERACTIVITY_APP,
        event_types=SLACK_INTERACTIVITY_TYPES,
        handler=_run_slack_interactivity,
        # The same workspace lookup as the events consumer: an interactive payload names the
        # workspace too, so a click on a workspace the other region holds is forwarded there.
        ownership=_slack_ownership,
    ),
    WebhookConsumer(
        name="conversations_teams",
        provider="teams",
        app="supporthog",
        event_types=TEAMS_ACTIVITY_TYPES,
        handler=_run_teams_events,
        ownership=_teams_ownership,
    ),
    WebhookConsumer(
        name="conversations_email_inbound",
        provider="mailgun",
        app="inbound",
        event_types=frozenset({"message_received"}),
        handler=_run_email_inbound,
        ownership=_email_inbound_ownership,
    ),
    WebhookConsumer(
        name="conversations_email_outbound",
        provider="mailgun",
        app="outbound",
        event_types=frozenset({"message_sent"}),
        handler=_run_email_outbound,
        ownership=_email_outbound_ownership,
    ),
    WebhookConsumer(
        name="conversations_email_capture",
        provider="mailgun",
        app="capture",
        event_types=frozenset({"message_received"}),
        handler=_run_email_capture,
        ownership=_email_capture_ownership,
    ),
)