Connectors
Connectors are the small pieces of project plumbing that bring information from an outside service into the places where the team already works. They are not part of the public Explorer product. They help the project team notice feedback, understand usage, and share the right updates without manually checking every tool.
Why We Use Them
| Need | What a connector does |
|---|---|
| Customer feedback | Collects feedback from Typeform and shares it with the team in Slack. |
| Product usage | Pulls usage information from PostHog so the team can see what people are doing in the Explorer. |
| Team visibility | Turns separate tool data into short, readable updates in Slack. |
| Follow-up work | Gives the team evidence for product decisions, customer follow-up, and issue tracking. |
Current Examples
Typeform
The Typeform feedback connector checks the Explorer feedback form for new submissions. Each response can include a rating, a feedback type, a page or area, written comments, hidden context, and screenshots.
When new feedback exists, the connector formats it into a readable Slack post. If someone has already posted the same response, it updates the existing Slack message instead of creating duplicates. If there is no new feedback, it can update a short status message that says no new feedback was received.
In this project, the scheduled workflow is defined in adapt-action-explorer/src/trigger/typeform-feedback.ts. It runs on weekday mornings in the Europe/London timezone and calls the feedback-sharing script for the current date.
The detailed fetching and Slack-sharing behavior lives in adapt-action-explorer/scripts/fetch-typeform-feedback.ts.
PostHog
The PostHog connector asks PostHog for recent usage data from the Explorer analytics project. By default, it looks at the last seven days and summarises the most common events, including how often each event happened and how many people triggered it.
The connector can either print the summary for review or post it to Slack. This makes it useful for quick product check-ins, stakeholder updates, and evidence gathering before deciding what to improve next.
In this project, the PostHog workflow is defined in adapt-action-explorer/scripts/fetch-posthog-data.ts. The script is configured for the CDP Explorer PostHog project on the EU PostHog service.
What Connectors Are Not
Connectors do not replace the source tools. Typeform remains the system for feedback forms, PostHog remains the analytics system, and Slack remains the discussion space. The connectors simply move the most useful pieces of information between those systems so the team does not have to copy and paste updates by hand.
They also do not expose secret tokens in the documentation. Access to Typeform, PostHog, and Slack is handled through the project environment and secret-management setup.