> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Flowella product changelog

> What's new in Flowella: release notes grouped by version, covering new features, template and analytics improvements, HubSpot updates, and bug fixes.

<Update label="v2.3.0" tags={["v2.3.0"]}>
  Released 1 July 2026.

  ## New features

  **Dashboard reimagined as a live activity hub.** The home page now leads with the setup tasks you still need to clear, attention signals such as failed sends, awaiting replies, and billing prompts, and a recent activity feed, all themed to match the rest of Flowella. The card layout keeps your billing, WhatsApp 7-day snapshot, channels, HubSpot status, and forms within easy reach. [Learn more](/app/dashboard)

  **Integration status bar.** Every app screen now carries a small status bar at the top with **WhatsApp** and **HubSpot** pill chips. Each chip shows the brand icon, an explicit **Connected** or **Not connected** label, and a status dot. Click a chip to jump straight to the matching settings page. Status refreshes about once a minute, so connecting from another tab shows up quickly. [Learn more](/essentials/multi-channel#integration-status-bar)

  ## Updates

  **Honest plan comparison in Settings → Billing.** The Starter, Pro, and Enterprise cards now describe what Flowella actually ships: included conversations, overage pricing, team seats, HubSpot workflow actions, and support tier. Descriptions and feature bullets are pulled from Stripe so plan copy stays in sync with what you are charged for. Cards share equal heights and a consistent badge row so it is easier to compare plans at a glance. [Learn more](/account/billing)

  **Enterprise Contact sales opens the right page.** The Enterprise plan call to action now takes you to [flowella.io/contact](https://flowella.io/contact) so you can reach the sales team directly, instead of landing back inside the app. [Learn more](/account/billing)

  **HubSpot dates render in a readable format.** Appointment and date variables coming from HubSpot, including bare epoch values on legacy workflow fields, now display as `dd.MM.yyyy HH:mm` across template sends and custom channel sends, so recipients see real dates instead of long numbers. [Learn more](/hubspot/workflow-actions#date-and-time-variables)

  **Clearer Forms sync actions.** Each sync run row now shows a single outline action button that matches the run state: **Try again** for failed runs, **Cancel** for queued or running syncs, and **Create** for forms that have never synced. Run history is preserved across retries. [Learn more](/app/forms#sync-error-ux)

  **User-safe Forms sync errors.** Failed syncs surface a readable badge instead of a raw Meta error. `FLOW_SYNC_PREFLIGHT` with Meta `#133010` now points you at finishing phone registration, `QUEUE_FAILED` flags transient queue issues to retry, and Meta `validation_errors` summarise which fields were rejected so you can fix the HubSpot form without leaving the row. [Learn more](/app/forms#sync-error-ux)

  **Channel-scoped Forms page.** The Forms list works org-wide, but syncs always target a specific channel. With more than one channel connected, the **Sync** button now stays disabled with a tooltip until you pick a channel, so uploads no longer land on the wrong WhatsApp Business Account. The page also waits for the channel in the URL to resolve before loading, so you do not see a skeleton flash with results from a stale channel. [Learn more](/app/forms#channel-scope-gating)

  **Back to setup guide follows you out of onboarding.** When you jump from the **Setup guide** into Forms, HubSpot settings, Templates, the template editor, or the live inbox, a **Back to setup guide** link now appears near the page title, or at the top of the inbox conversation list, so you can return to your checklist in one click. Visit the same pages from the normal sidebar and the link stays hidden. [Learn more](/onboarding)

  **More reliable HubSpot workflow callbacks.** When HubSpot rate limits a workflow callback, Flowella now retries the completion so your workflows finish cleanly instead of stalling.

  **Smarter contact matching on WhatsApp Flow submits.** Flow form submissions are now resolved by phone number before falling back to email, which avoids attributing a reply to a stale contact when the same email is reused across people.

  ## Bug fixes

  * **Settings → Billing no longer snaps back to the top.** Scrolling to compare plans on the standalone billing page previously jumped you back to the top on route changes. The page now stays where you left it. [Learn more](/account/billing)
  * **Correct Starter and Pro upgrade experience.** When upgrading from a Free plan in **Settings → Billing**, you now see in-app **Upgrade to Starter** and **Upgrade to Pro** cards that open Stripe Checkout with the correct base and metered overage line items. [Learn more](/account/billing)
  * **Stripe setup intent webhooks acknowledged.** Card updates no longer leave your billing state stuck while Flowella waits for a webhook that was never confirmed.
  * **No more duplicate HubSpot contacts from inbound WhatsApp.** When several inbound WhatsApp messages from the same phone number arrived at once, Flowella could create more than one HubSpot contact for the same person. Inbound contact lookups and creates are now serialized per organisation and phone number, so concurrent messages reuse the first HubSpot contact instead of creating duplicates. [Learn more](/hubspot/setup)
  * **Empty Quick Reply rows no longer appear in the template live preview**, and inline validation no longer causes layout shift in the editor.
  * **WhatsApp template body line breaks are preserved** when switching editor tabs and saving.
  * **Unsaved template body and button drafts are kept** when you return to the browser tab.
  * **HubSpot settings translations restored** after they were dropped in the dashboard update.
  * **HubSpot marketplace connect wizard** now completes reliably end to end when you connect Flowella from the HubSpot marketplace. [Learn more](/hubspot/custom-channel)
</Update>

<Update label="v2.2.1" tags={["v2.2.1"]}>
  Released 19 June 2026.

  ## Bug fixes

  * **Template footer trailing spaces are preserved** when you save the template.
  * **Template variable example spacing is preserved** when you save the template.
</Update>

<Update label="v2.2.0" tags={["v2.2.0"]}>
  Released 19 June 2026.

  ## New features

  **Smart Reply in the Inbox.** When the 24-hour customer service window is closed, free text in the new **Reply** tab is automatically wrapped into an approved reopen template (Service, Update, or Offer) so you can keep replying without leaving the conversation. A pricing banner shows the Utility cost up front. [Learn more](/app/inbox#reply-tab-smart-reply)

  **Reply templates settings screen.** Edit the framing text around the three reopen templates, track their Draft → Pending → Approved state, and enable or disable each one. Auto-provisioning kicks in when you open the Inbox or Settings, or on an hourly sweep. [Learn more](/settings/reply-templates)

  **Send WhatsApp Reply HubSpot action.** A fourth workflow action that picks the right path automatically. It sends as a normal message when the 24-hour window is open, and as a reopen template when it is closed. Branch on `whatsapp_window_open_until` to choose between this and Send WhatsApp Message. [Learn more](/hubspot/workflow-actions#send-whatsapp-reply)

  **Open / Unseen and All / Pending tabs.** The conversation list now splits by status (Open / Unseen) and activity (All / Pending), with an org-wide seen watermark so the whole team agrees on what has been read. Recommended workflow: Unseen → Pending. [Learn more](/app/inbox#conversation-list)

  **Live typing indicators and read receipts.** The customer sees a typing bubble while an agent is composing, throttled to about once every 20 seconds, and inbound reads now flow back into the conversation view. [Learn more](/app/inbox#typing-indicators-and-read-receipts)

  **Per-template send log with drill-down and export.** Open any template from **Analytics** to see every send, filter by status, and export to CSV. [Learn more](/app/analytics)

  **HubSpot inbox connect step in onboarding.** A new guided step wires Flowella into the HubSpot inbox during initial setup. [Learn more](/onboarding)

  **Redesigned onboarding setup guide.** A 13-step checklist grouped under **Connect**, **Configure**, and **Launch** replaces the old wizard. Progress is auto-detected, you can pause and **Continue later** from the sidebar, and finishing the guide ends in a confetti celebration. New steps cover connecting the HubSpot inbox channel, inviting your team, reviewing reply templates, and sending a test message from Templates → Send. [Learn more](/onboarding)

  **Contact activity events toggle.** A new switch in **Settings → HubSpot → Contact activity events** lets you turn off Flowella's timeline events org-wide if you do not want them on the contact record. [Learn more](/hubspot/contact-activity#turn-contact-activity-events-on-or-off)

  **Channel-scoped timeline deep links.** Timeline events now link to the right WhatsApp channel inbox automatically, even when your org has multiple numbers, and the HubSpot live messages thread link opens the conversation in the HubSpot inbox. [Learn more](/hubspot/contact-activity#deep-links-from-the-timeline)

  ## Updates

  **Conversation view polish.** Structured template cards and Flow answer rows now render inline so you can see exactly what was sent and what the contact replied.

  **Templates statistics tab.** A cleaner layout and new status filters make it easier to spot delivery and read-rate drops. [Learn more](/app/templates)

  **HubSpot contact sync reliability.** Inbound activity is now queued behind contact sync, blank first names are backfilled from the WhatsApp display name, and the WhatsApp phone property is written on contact create so timeline links resolve correctly. [Learn more](/hubspot/contact-activity)

  **Dedicated WhatsApp phone property in HubSpot.** Contacts created from WhatsApp are now written to **`hs_whatsapp_phone_number`**, with a fallback to the standard `phone` and `mobilephone` properties when matching existing records. [Learn more](/hubspot/phone-number-format)

  **Clearer message flow between WhatsApp and the HubSpot inbox.** A new reference table walks through how inbound replies, outbound messages from HubSpot, and templates sent from HubSpot show up on both sides. [Learn more](/hubspot/custom-channel#how-messages-flow-between-whatsapp-and-the-hubspot-inbox)

  **Onboarding signals.** Setup guide progress now updates correctly as each step completes. [Learn more](/onboarding)

  ## Bug fixes

  * **Flow contact attribution** on submitted Flows is repaired so the right contact is credited every time.
  * **Stale HubSpot contact links** on the inbox no longer stop new activity from being posted.
  * **Template status webhooks** are now fanned out to every organisation sharing a WhatsApp Business Account, so approval and rejection updates land wherever the template is used.
</Update>

<Update label="v2.1.0" tags={["v2.1.0"]}>
  Released 9 June 2026.

  ## New features

  **Bulk send for templates.** Send an approved template to many contacts in one go from the **Templates → Send** tab. Build the recipient list in the editor or import a CSV, set an optional schedule and per-minute throttle, and watch live progress as the job runs. The job summary tiles break down delivered, failed, and `Suppressed` (deduped) recipients, and the per-send **Details** column shows a human-readable reason for each failure, for example *Invalid phone*, *Opted out*, or *Payment method required*. [Learn more](/app/templates#bulk-send)

  **Per-template analytics drill-down.** Click any template in **Analytics** to open a side sheet with 100% of its send logs. Search by recipient, sort by date, filter with status chips, and export the filtered view as CSV or PDF for finance, ops, or compliance reporting. [Learn more](/app/analytics)

  **Coupon code templates.** Promotional templates can now carry a unique coupon code per send. Set codes at send time from the Send tab or directly from the inbox dialog using the new **Coupon code buttons** input. [Learn more](/app/template-reference#specialised-template-types)

  ## Updates

  **Smarter template editor.** Drafts auto-save about a second after you stop typing, and **Publish** is gated on a successful save so you cannot submit stale content. Quick Reply buttons now surface `BUTTON_TEXT_REQUIRED` inline, the category dropdown clearly shows the selected option, and body line breaks plus footer trailing spaces are preserved exactly as written. [Learn more](/app/templates#editor-behaviour)

  **Clearer approval expectations.** The **PENDING** state now tells you that Meta review may take up to 12 hours, and you receive an email when the status changes, so you do not need to refresh the templates list. [Learn more](/app/template-reference#submission-lifecycle)

  ## Bug fixes

  * **Template body line breaks** are no longer collapsed on save.
  * **Template footer trailing spaces** are preserved.
  * **Template variable example spacing** is preserved on save.
  * **Category dropdown** now renders the selected label correctly.
</Update>

<Update label="v2.0.1" tags={["v2.0.1"]}>
  Released 8 June 2026.

  A follow-up patch to the v2.0.0 replatform. No user-facing changes are documented for this release.
</Update>

<Update label="v2.0.0" tags={["v2.0.0"]}>
  Released 8 June 2026.

  Flowella v2 is a full replatform of the product. The sections below cover the user-facing changes that shipped with the initial v2 release.

  ## New features

  **Onboarding setup guide.** A new **/{orgId}/onboarding** hub replaces the old wizard with an auto-detected checklist, progress bar, first sign-in redirect, sidebar entry, and a post-Meta HubSpot connect banner. You can **Continue later** and pick up where you left off. Each step includes a help link to the matching Knowledge Base article. [Learn more](/onboarding)

  **Preview mock inbox and templates before you connect.** Org routes for **Inbox** and **Templates** no longer redirect you into onboarding when setup is incomplete. Instead you see a preview mock inbox and a sample templates catalogue so you can explore Flowella before wiring up WhatsApp.

  ## Updates

  **Template Statistics with human-readable failure reasons.** The template send log now includes a **Details** column that spells out why a send failed, for example *Invalid phone*, *Opt-out*, *Contact missing*, or a Meta API error, and status badges use localised labels. When Meta later reports a delivery failure after the initial send (for example payment method code **131042**), the Details column reflects that too. [Learn more](/app/templates#send-log-details)

  **Template auto-save and sticky action bar.** The template editor now auto-saves drafts after about a second of inactivity and shows a sticky footer with the current save status. **Publish** is blocked until the auto-save completes so you cannot submit stale content.

  **HubSpot custom channel connect wizard.** Connecting Flowella from the HubSpot marketplace now completes end to end. The redirect back into HubSpot works reliably and the inbox no longer shows *Not delivered* for outbound messages. Flowella relays outbound messages from the HubSpot inbox to WhatsApp and reports `SENT` or `FAILED` back to HubSpot. [Learn more](/hubspot/custom-channel)

  **HubSpot user templates dropdown scales past 100 templates.** The HubSpot workflow **Template name** dropdown now loads the full list of your Meta templates in pages, and pins your saved selection so the workflow validates even when the value sits outside the first page.

  **Transactional email refresh.** All transactional emails now use a branded Flowella shell with a consistent header, onboarding steps, and a shared *Need a hand?* footer.

  ## Bug fixes

  * **Flow endpoint submit success screen.** WhatsApp Flow submits now return the correct thank-you screen so Meta no longer shows a generic submit error after a successful HubSpot submit.
  * **Forms photo picker sync.** HubSpot forms with photo or file fields now sync to Meta as WhatsApp Flows without failing on the photo picker validation.
  * **Repeat Flow submits.** Repeat WhatsApp Flow submits from the same contact are no longer blocked and each submission emits a fresh `flowella-form-completed` event to HubSpot.
  * **Contact names on Flow submits.** WhatsApp Flow form field answers now drive the contact name on HubSpot submit, instead of being overwritten by a WhatsApp profile username.
</Update>
