StarAgent
Docs
DashboardSetup

PostHog

StarAgent can send activity events to your PostHog project so you can chart missed calls, inbound texts, agent replies, staff questions, and memory updates.

Setup

  1. In PostHog, open Project settings and copy your project API key (starts with phc_).
  2. In StarAgent Setup, turn on PostHog under Integrations.
  3. Paste the project API key and Save.
  4. Host is optional. Leave blank for US Cloud (https://us.i.posthog.com). Use https://eu.i.posthog.com for EU.

Phone-region reporting

StarAgent disables server GeoIP so the ingestion server is not mistaken for the caller. Use phone_country, phone_state or phone_state_code for geographic breakdowns instead of GeoIP fields. phone_region_city is included only when the area-code dataset explicitly provides a U.S. city label; most codes resolve to a state.

These approximate hints describe where a phone number was assigned, not where its owner lives or is calling from. Mobile and VoIP numbers can move. The offline Apache-licensed Google libphonenumber snapshot covers 359 U.S. geographic area codes across all 50 states and D.C. Other NANP numbers receive country/territory hints, and full international numbers receive country hints when their calling code is unambiguous. Unknown and toll-free codes do not get a guessed location.

These properties apply to newly sent events. Existing imported events are not rewritten or resent, so reimporting will not correct old GeoIP fields or add duplicate analytics sends.

Dataset source

Events

Each event includes source: staragent, authenticated business ID and hashed call/contact correlation when available. Customer identities are hashed; masked Yelp calls remain anonymous call records, not verified customer profiles.

call_received
forwarding_started
call_answered
call_missed_after_forward
voicemail_recorded
transcription
sms_to_customer
sms_to_owner
email_to_customer
email_to_owner
inbound_sms_received
inbound_sms_replied
clarification_asked
clarification_answered
memory_updated
review_sent
review_approved
webflow_form_received
webflow_form_replied
yelp_lead_replied

Reply delay is not a separate event. When a reply waits, the eventual sms_to_customer, email_to_customer, or inbound_sms_replied event includes delayed and delay_seconds.

Privacy

Events may include phone numbers, transcripts, and reply text that StarAgent already stores for the call. Only enable PostHog if your PostHog project is appropriate for that data.

Related