> ## 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.

# Entry points: tracked links, QR codes, and CTWA sources

> Create WhatsApp Link, QR code, and CTWA entry points in Flowella to send customers into a WhatsApp chat with a tracked link and per-source click counts.

<Note>
  **Early access.** Entry Points is currently rolling out and may not yet appear in every workspace. If you do not see **Entry Points** in the left navigation, the feature is not enabled for your organisation yet — [contact support](https://flowella.io/contact) to check availability.
</Note>

An **entry point** is a source that sends customers into a WhatsApp conversation with your business — a link on your website, a QR code on a poster, or a Click-to-WhatsApp ad on Facebook or Instagram. Every entry point you create in Flowella gets its own tracked URL on `link.flowella.io`, its own click counter, and (for ads) its own attribution ID on the resulting conversation.

Use entry points when you want to know **which source drove a conversation**, not just that a conversation happened.

## How to open Entry Points

Entry Points is an organisation-scoped page. From the left navigation, click **Entry Points** to open:

```text theme={null}
/{org}/entry-points
```

The page lists every entry point in the organisation with its type, the journey it starts, its volume, and whether it is live.

## The three entry point types

<CardGroup cols={3}>
  <Card title="WhatsApp Link" icon="link">
    A tracked link you paste anywhere: website buttons, email footers, social bios, SMS. Opens WhatsApp with a chat to your business number.
  </Card>

  <Card title="QR code" icon="qr-code">
    The same tracked link, rendered as a QR code you can download and print on packaging, posters, table tents, or business cards.
  </Card>

  <Card title="CTWA" icon="megaphone">
    A source you attach to a **Click-to-WhatsApp** Facebook or Instagram ad. Flowella records Meta's click ID on the conversation for downstream attribution.
  </Card>
</CardGroup>

WhatsApp Link and QR code entry points are the Flowella-managed replacement for hand-built `wa.me` URLs. See [Click-to-chat](/campaigns/click-to-chat) for background on when to use each surface. CTWA entry points pair with the ad-side setup described in [CTWA Ads](/campaigns/click-to-whatsapp-ads).

## Create an entry point

<Steps>
  <Step title="Open Entry Points and click + New entry point">
    Flowella opens a type picker with the three entry point types.
  </Step>

  <Step title="Pick the type">
    Choose **WhatsApp Link**, **QR code**, or **CTWA**. The form fields change to match.
  </Step>

  <Step title="Fill in the details">
    Give the entry point a **name** you will recognise in reports (e.g. `Homepage FAB`, `Spring launch flyer`, `Instagram — Spring launch ad`). For WhatsApp Link and QR code, pick the WhatsApp channel the link should send customers to and optionally set a pre-filled first message.
  </Step>

  <Step title="Save">
    Flowella generates the tracked URL on `link.flowella.io` and adds the entry point to the list. QR code entry points also get downloadable QR images.
  </Step>
</Steps>

## Download a QR code for print

A QR code entry point encodes its tracked `link.flowella.io` URL, so every scan counts as a click on that entry point.

Next to the QR preview, choose the file you need:

| Button | Use it for |
| - | - |
| **Download PNG (256px)** | Screens, slides, and small digital placements |
| **Download PNG (512px)** | Flyers, table tents, and business cards |
| **Download PNG (1024px)** | Posters, packaging, and other large prints |
| **Download SVG** | Designers who need to scale the code without losing quality |

<Tip>
  Pick the largest PNG your layout allows. A larger source image stays sharp when your printer scales it.
</Tip>

## Using the tracked URL

Every WhatsApp Link and QR code entry point has a tracked URL of the form:

```text theme={null}
https://link.flowella.io/<short-id>
```

You can copy this URL from the Entry Points list and reuse the same one anywhere:

* **Website buttons and CTAs** — link a "Chat on WhatsApp" button at it.
* **Email footers and sales signatures** — paste it as a normal hyperlink.
* **QR code generators** — Flowella already provides print-size QR downloads. If you want a custom brand style, point your own generator at this URL rather than at a raw `wa.me` link.
* **Social bios and link-in-bio pages** — Instagram, TikTok, LinkedIn, X.

When someone taps the URL, `link.flowella.io` counts the click, then redirects them to WhatsApp (`wa.me`) with your business number and any pre-filled message. The customer lands in WhatsApp; you get a click counted against the entry point.

<Tip>
  Create a separate entry point per placement — one for the homepage button, one for the email footer, one for each printed asset. That way the click counter tells you where conversations are coming from, not just that they exist.
</Tip>

## CTWA entry points

For a Facebook or Instagram Click-to-WhatsApp ad, create a **CTWA** entry point and use it as the source identifier for that ad campaign. When a customer taps the ad and starts a chat, Flowella stores Meta's `ctwa_clid`, the ad ID, and the ad source URL against the conversation so you can attribute it back to the ad in analytics and in HubSpot.

The ad itself is still built in Meta Ads Manager. Flowella does not create the ad for you. See [CTWA Ads](/campaigns/click-to-whatsapp-ads) for the full ad-side setup.

### Set up ad attribution

In the Entry Points list, open the actions menu on a CTWA entry point and click **Edit entry point**. The edit page shows the ad attribution panel. The panel lists how many conversations each ad started, shown as `{count} ad conversations` next to the ad ID. Below the counts, you configure how Flowella reports leads back to Meta through the Conversions API.

**Prerequisites**

* A Meta dataset (pixel) connected to the ad account that runs your CTWA ads
* A Conversions API access token for that dataset, generated in Meta Events Manager
* The ID of the Facebook Page that runs the ads

<Steps>
  <Step title="Enter your Meta IDs">
    Fill in **Meta dataset ID** and **Facebook Page ID**. Both fields are required before you can save.
  </Step>

  <Step title="Add the Conversions API token">
    Paste the token into **Conversions API token**. Flowella encrypts the token when you save. After that, the field stays blank and shows **A token is saved. Leave blank to keep it.** Paste a new token only when you want to replace it.
  </Step>

  <Step title="Set the lead value">
    Enter a three-letter **Currency** code, for example `GBP` or `EUR`. The default is `USD`. Enter a whole-number **Conversion value** for each lead. The default is `0`.
  </Step>

  <Step title="Save">
    Click **Save ad attribution**.
  </Step>
</Steps>

These settings apply to your whole organisation. Every CTWA entry point uses the same dataset, Page, token, currency, and value.

### What happens when a Flow is submitted

When a customer who arrived from a CTWA ad submits a WhatsApp Flow, Flowella does two things:

1. **Writes attribution to the HubSpot contact.** Flowella sets these contact properties:

   | Property | Value |
   | - | - |
   | `flowella_entry_point` | How the conversation started: `ad`, `qr`, `link`, or `direct` |
   | `flowella_ctwa_clid` | Meta's click ID for the ad tap |
   | `flowella_ad_id` | The ID of the ad the customer tapped |
   | `flowella_ad_source_url` | The ad or post URL Meta sends with the click |

   Flowella writes `flowella_entry_point` for every submitted Flow, including ones from WhatsApp Link and QR code entry points. The three ad properties are only written when the conversation came from an ad.

2. **Sends a Lead event to Meta.** If ad attribution is configured, Flowella sends one Conversions API `Lead` event for the click ID, with your currency and conversion value. Flowella sends at most one Lead event per click ID, even if the customer submits more than one Flow. Flowella does not send the event if the Flow is submitted more than 7 days after the ad click.

<Note>
  Meta controls where Conversions API events are reported. Do not assume these Lead events appear in Ads Manager for every region. Check [Meta's Conversions API for Business Messaging documentation](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging) for current availability.
</Note>

See [UTM tracking](/hubspot/utm-tracking) for how this attribution fits alongside other HubSpot attribution patterns.

## Reading volume

The Entry Points list shows volume for each row as **clicks · started**, for example `120 clicks · 34 started`.

* **Clicks** counts taps on the tracked URL or scans of the QR code, whether or not the person went on to send a message.
* **Started** counts conversations that began from the entry point.

Compare the two numbers to see how many clicks turn into actual chats. Use [Analytics](/app/analytics) for wider conversation reporting.

### Click privacy

Flowella does not count clicks from bots and crawlers, so volume reflects real visitors. For each click, Flowella stores the time, the referring page, a truncated user agent, and the visitor's country. Flowella never stores the visitor's IP address.

## Related guides

* [Click-to-chat](/campaigns/click-to-chat) — where to place WhatsApp Link and QR entry points
* [CTWA Ads](/campaigns/click-to-whatsapp-ads) — the ad-side setup that pairs with CTWA entry points
* [UTM tracking](/hubspot/utm-tracking) — how `ctwa_clid` and pre-filled codes flow into HubSpot


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.