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

# WhatsApp Messaging

> Send pre-filled WhatsApp messages to contractors and tenants using configurable templates.

This guide covers sending WhatsApp messages from PropOps and managing your message templates.

***

## Sending a message

<Steps>
  <Step title="Open the job">
    Navigate to the job you want to send a message about.
  </Step>

  <Step title="Click Send WhatsApp">
    Click the **WhatsApp** button in the job action bar. This opens the message composer.
  </Step>

  <Step title="Select a template">
    Choose a message template from the dropdown. The template text is shown with dynamic variables (e.g. job reference, address, contractor name) already filled in.
  </Step>

  <Step title="Review and send">
    Click **Send**. WhatsApp Web or the WhatsApp app opens with the message pre-filled and the recipient's number set. Review the message in WhatsApp and tap **Send**.
  </Step>
</Steps>

<Info>
  PropOps opens WhatsApp with the message ready to go — you confirm and send it yourself. No WhatsApp Business API account is required.
</Info>

***

## Managing templates

<Steps>
  <Step title="Open the template editor">
    Go to **Admin → WhatsApp Templates**.
  </Step>

  <Step title="Create or edit a template">
    Click **Add Template** to create a new template, or click an existing template to edit it. Define the message body and any placeholder variables.
  </Step>

  <Step title="Save the template">
    Save the template. It becomes available immediately in the message composer — no external approval is needed.
  </Step>
</Steps>

***

## Template variables

Templates support dynamic variables that are filled in automatically when composing a message:

| Variable             | Replaced with                    |
| -------------------- | -------------------------------- |
| `{job_ref}`          | The job reference number         |
| `{address}`          | The job site address             |
| `{contractor_name}`  | The contractor's full name       |
| `{contractor_price}` | The contractor price for the job |
| `{appointment_date}` | The scheduled appointment date   |

***

## Requirements

WhatsApp messaging requires:

1. Message templates configured in **Admin → WhatsApp Templates**
2. A valid phone number on the recipient's profile (contractor or tenant)
3. The recipient must have WhatsApp installed on the number stored in their profile