Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firstflow.app/llms.txt

Use this file to discover all available pages before exploring further.

Firstflow is a developer SDK for adding onboarding tours, in-chat surveys, and feature announcements to AI agent products. Experiences are configured in the Firstflow Dashboard and rendered by the SDK inside your chat UI — no backend changes required.

​
What you can build

Tours

Step-by-step flows that guide users through features, rendered directly inside chat.

Surveys

NPS, CSAT, multiple choice, open text, and more — answered natively in chat, never in a popup.

Announcements

Feature banners and update cards rendered inline or as overlays — no browser notifications.

Analytics

Engagement, completion rates, drop-off points, and survey responses in real time.

​
How it works

Dashboard (create flows, set triggers and audience)
         ↓
SDK fetches config at runtime (GET /agents/:id/config)
         ↓
FirstflowWidget renders the right experience at the right time
         ↓
Events stream back to analytics
The SDK fetches your experience configuration from the Firstflow API and evaluates trigger and audience rules client-side. When a match is found, FirstflowWidget renders the experience above your chat input. Results appear in the Dashboard automatically.

​
Integration model

Add two components to your chat app — nothing else: 
<FirstflowProvider agentId="..." apiKey="...">  {/* wrap your app */}
  <FirstflowWidget>                              {/* wrap your chat UI */}
    <MessageList />
    <Composer />
  </FirstflowWidget>
</FirstflowProvider>
Everything else — which experience shows, to whom, when, how often — is configured in the Dashboard and updated without a code deploy.

​
Next step

Quickstart

Go live in under 5 minutes.