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

# Send WhatsApp to a HubSpot list

> Send an approved WhatsApp template to every contact on a HubSpot list, from the Ciarem page inside HubSpot.

Once [HubSpot is connected](https://help.ciarem.ai/integrations/hubspot.md), the Ciarem app in HubSpot has its own page, **Send a WhatsApp broadcast**. Pick a HubSpot contact list, a WhatsApp number and an approved [template](https://help.ciarem.ai/channels/message-templates.md), and Ciarem sends the template to everyone on the list who is synced to Ciarem. It doesn't need HubSpot workflows.

While HubSpot is connected, the Contacts section is hidden in Ciarem, so this page is where you message a group of your HubSpot leads at once: a list of new leads, everyone at a stage, or contacts you picked by hand.

## Before you start

* HubSpot is connected to Ciarem and its setup is finished. See [HubSpot](https://help.ciarem.ai/integrations/hubspot.md).
* You have at least one connected [WhatsApp number](https://help.ciarem.ai/channels/connect-whatsapp.md) and one approved template.
* The people you want to reach are on a HubSpot contact list of up to 10,000 members. To message a hand-picked group, select the contacts in HubSpot and add them to a list.

## Send a broadcast

**1. Open Ciarem in HubSpot**

In HubSpot, click the **Marketplace** icon (a storefront) in the top bar. Under **Your recently visited apps**, choose **Ciarem**. The first time, Ciarem isn't listed there yet: click **View all**, then **Ciarem** in **App Homes**. The **Send a WhatsApp broadcast** page opens.

**2. Choose the list**

In **Contact list**, search for the list by name and pick it. Each list shows how many contacts it has.

**3. Choose the WhatsApp number**

In **WhatsApp number**, pick the number the message is sent from.

**4. Choose the template**

In **Template**, pick one of that number's approved templates.

**5. Fill in the variables, if the template has any**

A **Variable values (JSON)** box appears, already listing each variable that needs a value. Type the value for each one between the quotes. Use fixed text, or a contact property such as `{{contact.first_name}}` to fill it from each recipient.

```json theme={null}
{
  "name": "{{contact.first_name}}",
  "discount": "20%"
}
```

**6. Send**

Click **Send broadcast**. The page confirms the broadcast is queued.

![The Send a WhatsApp broadcast page in HubSpot, with a contact list, a WhatsApp number, a template and its variable values filled in](https://mintcdn.com/ciaremaai/VapWOXd5thwocBcz/images/ciarem-help-hubspot-list-broadcast.png?fit=max\&auto=format\&n=VapWOXd5thwocBcz\&q=85\&s=b5724b8e8bb32dd65a774af04518a67a)

Only list members who are synced to Ciarem and have a WhatsApp-reachable phone number get the message. The page tells you the exact numbers after you send.

## After you send

* **What was queued.** The page says how many list members were queued, and how many were skipped because they aren't synced to Ciarem.
* **Fewer than expected.** If fewer messages were queued than eligible contacts, the WhatsApp number is near the number of new conversations Meta allows it to start in 24 hours. The rest can be sent once the window frees up.
* **Follow it.** **Refresh status** shows how many messages were sent, delivered, read and failed, and how many are pending. **Open in Ciarem** opens the broadcast in Ciarem, where it is listed with your other [broadcasts](https://help.ciarem.ai/channels/broadcasts.md) and shows each recipient's status. **Send another broadcast** starts a new one.
* **Cost.** Each message is charged to your WhatsApp wallet at Meta's rate, like any template. See [WhatsApp costs and the 24-hour window](https://help.ciarem.ai/billing/whatsapp-costs-and-templates.md).
* **Replies.** Replies land in the Ciarem [Inbox](https://help.ciarem.ai/using-ciarem/inbox.md). A contact who had no open conversation is answered by the AI agent. An open conversation keeps whoever was handling it: a teammate, the AI, or the WhatsApp Business app.
* **Opt-outs.** Marketing templates are not sent to contacts who [opted out of marketing](https://help.ciarem.ai/channels/whatsapp-marketing-opt-out.md).

To message one contact, company or deal instead of a whole list, use the [card on the HubSpot record](https://help.ciarem.ai/integrations/hubspot/record-card.md). To send automatically when something changes in HubSpot, use a [HubSpot workflow](https://help.ciarem.ai/integrations/hubspot/workflows.md).

## If something is not working

| What you see | What to do |
| - | - |
| **Ciarem doesn't have permission to read your lists yet.** | Click **Reconnect Ciarem to grant access to lists** on the page and approve access in HubSpot. |
| **This portal is not connected to Ciarem.** | Connect HubSpot in Ciarem, under **Settings > Integrations > HubSpot**. |
| **Your Ciarem subscription is not active.** | Choose a plan in Ciarem. See [Plans and billing](https://help.ciarem.ai/billing/plans-and-billing.md). |
| **This list is too large for a broadcast** | A broadcast from HubSpot reaches up to 10,000 list members. Split the list into smaller ones. |
| **No one on this list is synced to Ciarem, so there is nobody to send to.** | Check that your [import filters](https://help.ciarem.ai/integrations/hubspot.md#what-syncs) include these contacts. New HubSpot contacts sync within the hour. |
| Many list members were skipped | They aren't synced to Ciarem. Check your [import filters](https://help.ciarem.ai/integrations/hubspot.md#what-syncs) and [Contacts not imported](https://help.ciarem.ai/integrations/hubspot.md#contacts-not-imported). |
| A template is missing from the list | Only approved templates of the chosen number are listed. Templates that need a button code, a dynamic link, a countdown or a header file that Ciarem doesn't have stored can't be sent from HubSpot. |
| **The variable values must be valid JSON** | Keep the quotes, colons and commas of the box as they were, and only type between the quotes of each value. Every variable needs one. |
| **The selected template is no longer approved, or no longer exists.** | Choose another template. |
| **The selected WhatsApp number is no longer available.** | Choose another number, or check the number's connection in Ciarem. |
| **This WhatsApp account has reached the number of new conversations Meta allows in 24 hours.** | Wait for the 24-hour window to free up, then send again. |
| **The Ciarem WhatsApp wallet has insufficient balance for this broadcast.** | Top up your WhatsApp wallet in Ciarem. See [Plans and billing](https://help.ciarem.ai/billing/plans-and-billing.md). |
| **HubSpot is rate-limiting requests right now** | Wait a moment and send again. |
| **Something went wrong sending the broadcast.** | Try again. If it keeps happening, [report a problem](https://help.ciarem.ai/getting-started/report-a-problem.md). |


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