User Interviewer

What does the User Interviewer app do?

This app enables you to send a popup notification to targeted users that invites them to schedule an interview to provide feedback. This app was created by PostHog's product team and is something we use regularly to collect community feedback.

What are the requirements for this app?

This app requires either PostHog Cloud, or a self-hosted PostHog instance running version 1.30.0 or later.

Not running 1.30.0? Find out how to update your self-hosted PostHog deployment!

How do I install this app?

Make sure you have enabled opt_in_site_apps: true in your posthog-js config.
Install the app from the PostHog App Repository
Customize the text and theme using the app config
Configure the app by creating a feature flag (see below)

That's it!

Is the source code for this app available?

PostHog is open-source and so are all apps on the platform. The source code for this app is available on GitHub.

How do I configure the app?

Create a feature flag in your PostHog account to control who sees the interview request pop-up. For this example, we'll use the name user-interview
Set up the filters for the people that you want to speak to. You can create a filter based on properties, such as location or email, but not events. If you want to invite users based on them doing certain actions, you'll need to update the users' property once they've done that action.
Additionally, if you want to invite users based on historical actions, create an insight for that action and then use that to create a static cohort.
Set the filter Seen User Interview Invitation - {FEATURE_FLAG_NAME} to is not set so that it doesn't show to users who have seen the user interview already. This property is added once the user has interacted with the popup - either to close it or to book in a time.
Add an autorollback based on the pageview where Current URL contains bookedUserInterviewEvent={FEATURE_FLAG_NAME}. This is where you'll redirect them after they've booked in. Set the average over last 7 days to be 1 for up to 7 interviews to be booked and 2 for up to 14 interviews to be booked. This requires the auto-rollback-feature-flags feature flag to be turned on. Please be aware this is currently in beta.
Create your Calendly event (or other booking link) and set the redirect after booking to be {Your app}?bookedUserInterviewEvent={FEATURE_FLAG_NAME}, e.g. https://app.posthog.com/home?bookedUserInterviewEvent=user-interview
Add the feature flag and booking link to the app config interviewConfigs (you can have multiple feature flags with corresponding booking links by separating them with commas e.g. interview-high-icp=https://calendly.com/user1/book-high-icp,user-interview=https://calendly.com/user1/user-interview).
Rollout out the feature flag

By default the flags won't be shown to users who have seen a user interview popup within the last 90 days. You can override this with with minDaysSinceLastSeenPopUp

What new properties and events does this app add?

Please check the Readme in the GitHub repo for a full list.

Who created this app?

We'd like to thank PostHog team member Luke Harries for creating this app.

Who maintains this app?

This app is maintained by PostHog. If you have issues with the app not functioning as intended, please raise a bug report.

What if I have feedback on this app?

We love feature requests and feedback! Please create an issue to tell us what you think.

What if my question isn't answered above?

We love answering questions. Ask us anything via our Support page.

You can also join the PostHog Community Slack group to collaborate with others and get advice on developing your own PostHog apps.