Skip to main content

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.

Click-to-WhatsApp (CTWA) ads are Facebook or Instagram ads that send people straight from the ad into a WhatsApp chat with your business when they tap the call to action. Instead of landing on a website or form, they land in a conversation. Flowella fits in after the click: it runs a structured WhatsApp journey, captures answers, and syncs those answers into HubSpot — turning your ad’s “Send message” button into a proper lead funnel.

​
The key limitation: ad-attached flows must be static

In Ads Manager you will see two chat experiences: Start conversations and Collect info with a form on WhatsApp (Meta’s simplified WhatsApp Flows experience).
It is possible to link a WhatsApp ad directly to a Flow using the “Collect info with a form on WhatsApp” experience, but Meta requires that ad-attached Flows be static — meaning no data exchange with an endpoint. The moment you need an endpoint to fetch, validate, or personalise data, you are in dynamic Flow territory, which is not eligible for that ad placement.Because a CRM integration depends on exchanging data with your backend (creating or updating HubSpot contacts, checking for duplicates, looking up appointment times, routing logic, and so on), an ad-attached Flow cannot behave like a proper dynamic Flowella flow. Treat “Collect info with a form on WhatsApp” as basic, static lead capture only — not a CRM-connected journey.

​
Best practice approach: start a conversation, then trigger a Flow Template

The recommended approach is to use the ad to open a WhatsApp conversation and rely on a keyword to trigger the full Flowella experience:
  1. Use the Start conversations template in Ads Manager so the ad opens WhatsApp.
  2. Set a pre-filled message (keyword) so the user’s first message reliably triggers automation.
  3. Flowella detects that keyword and launches the right Flow Template.
  4. Flowella syncs the captured data into HubSpot.
This keeps the low-friction ad experience (scroll → tap → WhatsApp), unlocks the full Flowella journey, and lets HubSpot sync work exactly as intended.

​
Step-by-step setup

1

Build your Flow Template in Flowella

Create a Flow Template tailored to the ad’s promise — quote, demo, booking, eligibility check, or similar. Keep it short, purposeful, and mobile-friendly.Recommended fields for HubSpot lead capture:
  • Name
  • Email
  • One or two qualifying questions (budget, timeframe, service type)
A phone field is not required because it is captured automatically from the WhatsApp number.
2

Add a trigger phrase (entry condition)

Pick a unique phrase that you will use only for that ad. Examples:
  • “Hello! Can I get more info on Flowella?”
  • “Hello, can I book a Flowella Demo?”
Make it easy to understand, unlikely to appear naturally in other conversations, and unique across your flows.
Case, spacing, punctuation, and mobile autocorrect can all break keyword matching. Keep the phrase short and distinctive, and test it on a real device before launch. Avoid generic phrases like “Hi” — Flowella cannot reliably determine which flow to launch when multiple flows share the same trigger.
3

Connect your HubSpot mapping in Flowella

Map flow answers to HubSpot contact properties so that each submission becomes a real contact record and can trigger HubSpot workflows.
4

Create your CTWA campaign in Ads Manager

Create a campaign, choose a messaging-compatible objective, select WhatsApp as the destination, and build the ad as normal.When you reach the Chat builder step:
  • Select Start conversations (not “Collect info with a form on WhatsApp”).
  • Set the pre-filled message to your keyword — for example, “Hello! Can I get more info on Flowella?”
That pre-filled message is the trigger Flowella will listen for.
5

Test end-to-end on a real phone

Run through the full journey before you spend any budget:
  1. Tap the ad.
  2. Confirm WhatsApp opens.
  3. Confirm the pre-filled message appears.
  4. Tap send.
  5. Confirm Flowella launches the correct Flow Template.
  6. Complete the flow.
  7. Confirm the HubSpot contact is created or updated with the right properties.

​
Tracking and reporting

You will typically measure results in two places:
  • Ads Manager — conversations started and cost per conversation (front-end performance).
  • Flowella and HubSpot — flows started vs completed, leads created, and downstream HubSpot metrics such as MQLs, opportunities, and revenue.

​
Common pitfalls

  • Wrong chat template selected in Ads Manager — selecting “Collect info with a form on WhatsApp” opts you into Meta’s limited, static flow experience, not a dynamic Flowella journey.
  • Keyword mismatch — case, spacing, punctuation, or mobile autocorrect can break triggers.
  • Generic keywords — if your keyword is “Hi”, Flowella cannot reliably decide which flow to run.
  • Overlong flows — if the flow feels like a mortgage application, completion rates will suffer.
  • No end-to-end QA — always test from ad click to HubSpot record before scaling spend.
  • Empty chat configuration — forgetting to set the default message leaves users in a blank conversation with nothing to say.
  • Wrong ad objective — traffic can work, but Engagement with messages typically produces better conversation rates.
  • Ignoring the 24-hour messaging window — if you promise a follow-up, act while the conversation window is open, or have approved templates ready for later contact.

​
Best practices

  1. Make the value crystal clear in the ad. Explain what the user gets — for example, “Get a quote on WhatsApp in 2 minutes” or “Chat to book your demo.”
  2. Mention WhatsApp explicitly. Use copy like “Message us on WhatsApp” so people know what will open.
  3. Use a strong default message. Give the user helpful pre-filled text such as “Hi, I want to book a consultation” to improve the conversion rate from clicks to actual chats.
  4. Keep flows short and purposeful. Ask only what you need to qualify or fulfil the request; use buttons and lists so users tap rather than type.
  5. Match the ad promise to the flow content. If the ad says “Get a quote”, the flow should ask only the questions needed for a quote and confirm what happens next.
  6. Optimise for conversations, not just clicks. Use a messaging-conversation objective where possible to encourage delivery to users more likely to engage.
  7. Test the entire journey on a phone. From seeing the ad through tapping it, through the flow, to arriving in HubSpot — fix anything broken before you scale spend.
  8. Have a plan for human follow-up. For high-value leads, ensure someone reviews completed flows and can reply personally in WhatsApp within a reasonable time.

​
Example flow: “Book a demo on WhatsApp”

A simple pattern you might use in Flowella for a CTWA ad:
StepDetail
Ad copy”Book a 20-minute product demo, all arranged in WhatsApp.” CTA: “Send message on WhatsApp.”
Default (pre-filled) message”Hi, I’d like to book a demo.”
Flow stepsAsk for name → company → email → preferred timeslot from a list → confirm booking and expectations.
HubSpot mappingName, company, and email mapped to contact fields; preferred timeslot mapped to a custom property; optional task or meeting created by a workflow.
Follow-upSales rep receives a task or notification and confirms the slot by email and/or WhatsApp.
From a user’s perspective, they scroll, tap, answer four or five quick questions, and are done. From your side, a structured lead appears in HubSpot ready for follow-up.