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

> ## Agent Instructions
> This is the Journeyfront Help Center for hiring teams. Journeyfront is an applicant tracking system (ATS). Use the Help Center's terms: job req, Candidate Profile (the person), Candidate Application (one person on one job req), hiring class. Link to the article you used in your answer.

# WhatsApp

> Message candidates on WhatsApp with approved templates, and keep every conversation on the Candidate Application.

> [!NOTE]
>
> **Who can do this:** Users with the *Send Messages* permission send WhatsApp messages. Creating WhatsApp templates needs *Company Settings Access*.
>
> **Availability:** WhatsApp is part of the Text Messages add-on. Your admin connects your company's WhatsApp Business number first (see [WhatsApp setup](https://help.journeyfront.com/integrations/texting-providers/whatsapp.md)).

In many countries, candidates live on WhatsApp more than on text messages. Once your company's WhatsApp Business number is connected, you can message candidates on WhatsApp from the same places you text them: the message panel on a Candidate Application, the bulk **Message** action and workflow automations. Every message and reply is saved on the Candidate Application.

WhatsApp has a few rules that SMS doesn't, mostly around **templates**: WhatsApp only lets a business start a conversation with a message it has approved in advance.

## Send a WhatsApp message

* **To one candidate:** open the Candidate Application, click the **message icon**, and choose your WhatsApp number in **From** (it's labeled "WhatsApp"). To start a conversation, pick an approved template. You'll see a preview with the candidate's details filled in before you send.
* **To many candidates:** select candidates on the **Candidates** page or a job req's **Candidates** tab, choose **Message**, pick your WhatsApp number and an approved template. You can send now or schedule it.
* **Automatically:** on a job req's workflow, add an automation with the **Send WhatsApp Message to Candidate** action and an approved template.

![The From dropdown in the message panel with the WhatsApp number selected, and the candidate shown as opted in to WhatsApp](https://mintcdn.com/journeyfront/61dBaB1hIRAsZpUl/images/communication/whatsapp/gen-from-whatsapp.png?fit=max\&auto=format\&n=61dBaB1hIRAsZpUl\&q=85\&s=df4c4ea1fbb0df1b42901c2be110ccd0)

![The Select Template panel for WhatsApp, listing approved templates with their message, category and a Use Template button](https://mintcdn.com/journeyfront/g7xdp16h6ZFRxhHy/images/communication/text-messages/05-pick-whatsapp-template.png?fit=max\&auto=format\&n=g7xdp16h6ZFRxhHy\&q=85\&s=2fd1da66fc8fa6239853ed55bd892f16)

Everything else works the same as text messages. See [Text messages](https://help.journeyfront.com/communication/text-messages.md).

## WhatsApp rules

* **Templates start conversations.** To message a candidate first, use an approved template.
* **Free-form replies for 24 hours.** Once the candidate replies, you can type free-form messages for 24 hours. After that, you need a template again.
* **Candidates must be on WhatsApp** on the phone number you have for them.
* **Daily limits.** WhatsApp limits how many new conversations your business can start each day. See [WhatsApp limits and quality](https://help.journeyfront.com/integrations/texting-providers/whatsapp.md#whatsapp-limits-and-quality).

While the 24-hour window is open, a green bar above the message box shows how long you have left to reply freely.

![A WhatsApp conversation in the message panel after the candidate replied, with a green bar saying the conversation window is open and how much time is left, and a free-form reply being typed](https://mintcdn.com/journeyfront/61dBaB1hIRAsZpUl/images/communication/whatsapp/gen-reply-window.png?fit=max\&auto=format\&n=61dBaB1hIRAsZpUl\&q=85\&s=bf1d57ca3695f716de576ca1011e81e3)

## Connect WhatsApp

An admin connects your company's WhatsApp Business number once. WhatsApp goes through the same provider you text through, so set up texting first.

**1. Open the Text Messages add-on**

Go to **Settings**, then **Add-Ons**, then **Text Messages**, and click **Connect WhatsApp**.

**2. Choose the number and display name**

Choose the phone number candidates will message you on and confirm the display name candidates will see. Then click **Connect your WhatsApp Business Account**.

![The Connect WhatsApp window, with a WhatsApp phone number selected, the display name pre-filled with the company name, and the Connect your WhatsApp Business Account button](https://mintcdn.com/journeyfront/g7xdp16h6ZFRxhHy/images/integrations/texting-providers/01-connect-whatsapp.png?fit=max\&auto=format\&n=g7xdp16h6ZFRxhHy\&q=85\&s=96a50cd7379f435af0ecda4670dd49a9)

**3. Finish in Facebook**

In the Facebook window, select **your own** business account. When asked about the phone number, choose **"Use a display name only."** The number is ready to message once its status shows **Online**.

For every step, or if your WhatsApp number sends through Webex Connect, see [WhatsApp setup](https://help.journeyfront.com/integrations/texting-providers/whatsapp.md).

## WhatsApp templates

Create your templates ahead of time so they're approved and ready when you need them. A message template can hold both an SMS version and a WhatsApp version, and Journeyfront uses the right one for the channel you send on. The **WhatsApp** tab on a template appears once your WhatsApp number is connected.

If your WhatsApp number sends through Twilio (Journeyfront's account or your own):

**1. Open the template**

Go to **Settings**, then **Templates**, then **Message Template**. Open a template, or click **Add Message Template**, and select the **WhatsApp** tab.

**2. Choose a category**

Choose **Utility** for messages about the candidate's application, such as confirmations, reminders and next steps. Choose **Marketing** only for promotional messages.

**3. Write the message**

Write the **Body**. You can add bold or italic text and insert variables, like the candidate's first name, from the menu. Optionally add a header, a footer and up to three buttons.

**4. Check the preview**

The live **preview** shows exactly what the candidate will receive.

**5. Submit for approval**

Click **Submit for Approval**. WhatsApp usually reviews templates within minutes to a few hours, and the status updates on its own. Once it shows **Active**, the template is approved and ready to send.

![The WhatsApp tab of a new message template, with Category, Header, Body, Footer and Buttons, a live WhatsApp preview and the Submit for Approval button](https://mintcdn.com/journeyfront/g7xdp16h6ZFRxhHy/images/communication/text-messages/04-whatsapp-template-tab.png?fit=max\&auto=format\&n=g7xdp16h6ZFRxhHy\&q=85\&s=3c98e81bbb4b85fe57ea9fd1e5eb22c7)

> [!TIP]
>
> Pick **Utility** and keep the wording specific to the candidate's application. WhatsApp doesn't deliver Marketing templates to U.S. (+1) numbers, and it can reclassify a promotional-sounding Utility template as Marketing.

If your WhatsApp number sends through Webex Connect, templates are written and approved in Webex Connect, then linked in Journeyfront. See [Link a WhatsApp template from Webex Connect](https://help.journeyfront.com/integrations/texting-providers/whatsapp.md#link-a-whatsapp-template-from-webex-connect).

The template list shows each template's WhatsApp status:

| Status | What it means |
| - | - |
| Draft | The WhatsApp version hasn't been sent to WhatsApp yet |
| In Review | WhatsApp is reviewing it |
| Active | Approved and ready to send. The dot next to it shows WhatsApp's quality rating for the template. Templates linked from Webex Connect also show Active |
| Rejected | WhatsApp declined it. Open the template to see the reason at the top of its WhatsApp tab, then edit the wording and resubmit |
| Paused or Disabled | WhatsApp has restricted it, usually for quality or policy reasons |

![The Message Template list in Settings, with the WhatsApp Status column showing Active, In Review, Rejected, Draft and Paused templates](https://mintcdn.com/journeyfront/61dBaB1hIRAsZpUl/images/communication/whatsapp/gen-template-statuses.png?fit=max\&auto=format\&n=61dBaB1hIRAsZpUl\&q=85\&s=cf9186bca888acab357e17a517e4f186)

## Track delivery

WhatsApp messages show a clock while sending, a check when sent, and double checks when delivered or read. If a message can't be delivered, **Not delivered** appears under it. Hover over it to see the reason.

![A WhatsApp conversation in the message panel, with one message marked Not delivered and a later message showing its delivery check](https://mintcdn.com/journeyfront/g7xdp16h6ZFRxhHy/images/communication/text-messages/02-delivery-status.png?fit=max\&auto=format\&n=g7xdp16h6ZFRxhHy\&q=85\&s=5b03138736da90cb3463f6bbfce4a9de)

## Consent

Once WhatsApp is connected, your application form asks candidates for WhatsApp consent alongside text message consent. The two are tracked separately, and the message panel shows whether a candidate has opted in to WhatsApp.

![The application form's Messaging Consent question, with separate SMS/Text and WhatsApp checkboxes under the consent wording](https://mintcdn.com/journeyfront/61dBaB1hIRAsZpUl/images/communication/whatsapp/gen-consent.png?fit=max\&auto=format\&n=61dBaB1hIRAsZpUl\&q=85\&s=0d1569efefb9584994c6eb35d0b91cb0)

## Billing

There's no separate WhatsApp add-on. If Journeyfront provides your texting account, WhatsApp messages use the same prepaid messaging balance as your texts. If your company uses its own Twilio or Webex Connect account, your provider bills you directly. See [Add-ons and credits](https://help.journeyfront.com/account-setup/add-ons.md).

## What candidates see

WhatsApp messages come from your company's WhatsApp display name and number, like any WhatsApp business message, with any formatting and buttons from your template.

## FAQ

> [accordion] Why do I need a template to message a candidate?
>
> WhatsApp requires businesses to use a pre-approved template for the first message in a conversation. It's their policy to prevent spam. After the candidate replies, you can send free-form messages for 24 hours.

> [accordion] Why was my WhatsApp message not delivered?
>
> Hover over **Not delivered** to see the reason. The most common cause is a Marketing template sent to a U.S. number; rewrite it as a Utility template and resubmit it. Other causes include a candidate who isn't on WhatsApp, or a free-form message sent more than 24 hours after the candidate's last reply.

> [accordion] Can we use more than one WhatsApp number?
>
> No. Each account connects one WhatsApp number.

> [accordion] Does it matter which provider our WhatsApp number uses?
>
> Not for sending. The message panel, replies and delivery updates work the same. The one difference is where templates are written: in Journeyfront for Twilio, and in Webex Connect for Webex Connect.

> [accordion] Does WhatsApp cost extra?
>
> There's no separate WhatsApp add-on. If Journeyfront provides your texting account, WhatsApp uses the same messaging balance as your texts. If you use your own Twilio or Webex Connect account, your provider bills you directly.

## Related

> [card] [Text messages](https://help.journeyfront.com/communication/text-messages.md)
>
> Text candidates by SMS.

> [card] [WhatsApp setup](https://help.journeyfront.com/integrations/texting-providers/whatsapp.md)
>
> Connect your WhatsApp Business number.

> [card] [Add-ons and credits](https://help.journeyfront.com/account-setup/add-ons.md)
>
> See your messaging balance and usage.

> [card] [Workflows overview](https://help.journeyfront.com/workflows/overview.md)
>
> Steps, activities and automation.


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