What Flowella writes to HubSpot
Flowella writes four contact properties in the Flowella Properties group. It creates them in HubSpot the first time it writes one. This needs CRM contacts (auto-create on new WhatsApp chat) under Unlocked on the Capabilities card in Settings → HubSpot. See Capabilities.
All four are single-line text properties. Flowella entry point takes these values:
ad wins: a conversation with an ad click ID is ad even if the message also matched an entry point.
When Flowella writes the properties
Flowella writes the ad properties again each time the contact messages you in that conversation. Messages in conversations that didn’t come from an ad don’t write anything, so
link, qr and direct only reach HubSpot when the contact completes a Flow.
A few rules decide which values you see:
- Flowella keeps the attribution on the conversation, and there is one conversation per contact on each of your WhatsApp numbers.
- If the contact taps an ad again later and messages you, Flowella replaces the stored click with the new one.
- A conversation keeps the first entry point it matched.
- Flowella doesn’t clear these properties. For example, a contact first comes from an ad, then completes a Flow in another conversation that didn’t. Flowella entry point changes, but the ad properties keep their old values. If the contact then messages you again in the ad conversation, Flowella entry point goes back to
ad.
Click to WhatsApp ads
When someone taps a Click to WhatsApp ad on Facebook or Instagram and messages you, Meta adds the ad’s details to the message. These include the click ID (ctwa_clid), the ad ID and the ad’s URL. Flowella stores them on the conversation. See Meta’s text messages webhook reference for the fields Meta sends.
This works for every organisation, with or without entry points.
Lead events sent to Meta
When a contact who came from a Click to WhatsApp ad completes a WhatsApp Flow, Flowella sends aLeadSubmitted event to Meta’s Conversions API for Business Messaging. Meta can then attribute the lead to your ad. Flowella sends the event automatically when all of these are true:
- The conversation has a click ID from the ad.
- The contact completes the Flow within 7 days of messaging you from the ad.
- Flowella hasn’t sent a
LeadSubmittedevent for that click before. It sends one per click, however many Flows the contact completes.
USD and 0. If your organisation has entry points, change them in the ad attribution panel. Meta decides where these events appear in its reporting. See Meta’s Conversions API for Business Messaging documentation.
For the ad set-up in Meta Ads Manager, see Click to WhatsApp ads.
WhatsApp links and QR codes
Early access. Entry points, which give you tracked WhatsApp links and QR codes, are available to selected organisations. Ad attribution works for every organisation.
link or qr to Flowella entry point. It doesn’t write the entry point’s name to HubSpot. To compare individual links and QR codes, use the counters on the Entry points page. See Entry points.
Links you control: HubSpot UTM tracking
For links in your emails, ads and social posts that lead to your website, use HubSpot’s tracking URLs with UTM parameters. When visitors arrive from a tracking URL, HubSpot saves the UTM details and shows them in its traffic analytics and sources report. See HubSpot’s guide to creating tracking URLs. Flowella doesn’t read or change HubSpot’s own source properties, such as Original Source. When WhatsApp is a follow-up channel, for example a workflow that sends a Flow after a website form, the contact keeps the source HubSpot recorded for that visit. A WhatsApp chat link (wa.me) opens WhatsApp, not your website, so HubSpot can’t see UTM parameters on it. To tag chats from your own wa.me links without entry points:
- Give each link its own prefilled first message. See Click-to-chat.
- In HubSpot, build a workflow that enrols on the Flowella Text Reply trigger.
- Branch on Last WhatsApp reply message, and set your own campaign property for each prefilled message.
Report on attribution
Once these properties are on your contacts, you can report on them in HubSpot, for example contacts by Flowella entry point, or leads by Flowella ad id. See Reporting and dashboards.Common questions
Why is Flowella entry point empty for some contacts?
Why is Flowella entry point empty for some contacts?
Flowella writes it when a contact completes a Flow, or when a contact messages you in a conversation that came from an ad. A contact who chats without completing a Flow, and didn’t come from an ad, has no value.
Why does a contact who came from an ad show direct?
Why does a contact who came from an ad show direct?
The ad may have run in WhatsApp Status, where Meta sends no click ID. Without a click ID, Flowella can’t link the conversation to the ad.
Can I see which campaign a contact came from?
Can I see which campaign a contact came from?
For ads, use Flowella ad id and match it to the ad in Meta Ads Manager. For links and QR codes, Flowella entry point only says
link or qr. Use the counters on the Entry points page, or tag the prefilled message as described above.Related
- Entry points: tracked links, QR codes and the ad attribution panel
- Click to WhatsApp ads: the ad set-up in Meta
- Click-to-chat: where to place WhatsApp links and QR codes
- Reporting and dashboards: turn attribution data into reports
- Workflow actions: the Text Reply trigger and other workflow steps

