signals-scout-conversations

Detects SLA breaches, latency blowouts, and backlog regressions in PostHog Conversations support inbox events.

713|118|Updated Aug 11, 2020
One-click install
npx skills add https://github.com/PostHog/posthog-foss --skill signals-scout-conversations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: signals-scout-conversations
Source: https://github.com/PostHog/posthog-foss/tree/main/products/signals/skills/signals-scout-conversations
Command: npx skills add https://github.com/PostHog/posthog-foss --skill signals-scout-conversations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Support teams running the PostHog Conversations inbox lack visibility into aggregate operational health — SLA breach rates, first-response latency, and backlog growth — because per-ticket feedback pipelines cannot see cross-ticket trends. This Skill monitors $conversation_* analytics events and files a report only when a metric steps meaningfully away from its trailing baseline.

Core Features & Use Cases

  • SLA breach-rate monitoring: Computes the daily share of team replies breaching SLA with minimum-volume guards, localized by channel and assignee role.
  • First-response latency analysis: Measures p50/p90 minutes from first inbound customer message to first team reply, including the never-answered share that percentiles hide.
  • Backlog and routing detection: Tracks inflow-vs-resolution net deltas, channel concentration surges, and rising unassigned ticket shares.
  • Use Case: A support lead notices customers complaining about slow replies. The scout queries 21 days of $conversation_message_sent events, finds first-response p90 jumped from 30 hours to 55 hours on weekdays while inflow stayed flat, and files a P2 report localized to the email channel.

Quick Start

Ask the agent to run the conversations scout and check whether the support inbox shows any SLA, latency, or backlog regressions against its baseline.

Frequently Asked Questions about signals-scout-conversations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor SLA breach rates for a support inbox in PostHog?

Query the $conversation_message_sent event daily, dividing countIf(sla_breached) by countIf(sla_active) over a 21-day window. Compare recent days against the trailing baseline and skip days with fewer than roughly 15 active-SLA replies to avoid noise.

How to measure first-response time from conversation events?

Join the first $conversation_message_received per ticket with the first $conversation_message_sent, then compute p50 and p90 minute differences grouped by day. Also compute the never-answered share separately, since unanswered tickets never appear in the percentiles.

Does this scout duplicate the Conversations emission pipeline reports?

No. The emission pipeline files per-ticket product-feedback signals from message content, while this scout watches aggregate operational metrics like SLA rates and backlog. It explicitly defers all per-ticket content findings to the emission pipeline.

Why does the scout ignore $conversations_loaded and widget events?

The plural $conversations_* events are UI and widget telemetry, not ticket-lifecycle data. Mixing them into operational metrics would corrupt breach, latency, and backlog calculations, so only singular $conversation_ticket_* and $conversation_message_* events are used.

What happens when the Conversations product is not in use?

The scout runs a 30-day execute-sql probe for any $conversation_ticket or $conversation_message events. If none exist, it writes a not-in-use scratchpad key and closes out empty rather than filing a report.

When does the scout edit a report instead of creating a new one?

When a live inbox report already tracks the same dimension, such as an ongoing SLA breach, the scout appends fresh daily rate-versus-baseline evidence to it. A persistent regression stays one report across runs instead of a new report per tick.