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

> Send pre-filled WhatsApp messages to contractors and tenants using configurable templates — no WhatsApp Business API required.

PropOps lets you send WhatsApp messages to contractors and tenants directly from a job record. Messages are composed using configurable templates with dynamic placeholders, then opened in WhatsApp Web or the WhatsApp mobile app for you to review and send.

<Info>
  No WhatsApp Business API account is required. PropOps generates a pre-filled WhatsApp message link — when you click **Send**, WhatsApp opens with the message ready to go. You confirm and send it yourself.
</Info>

***

## How it works

<Steps>
  <Step title="Template selected">
    Choose a message template from the configured list in your admin panel.
  </Step>

  <Step title="Recipient chosen">
    Select the contractor or tenant to message. Their phone number is pulled from their profile automatically.
  </Step>

  <Step title="Message composed">
    PropOps substitutes the template placeholders (job reference, address, contractor name, etc.) and generates the final message text.
  </Step>

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

***

## Message templates

Templates are managed in **Admin → WhatsApp Templates**. Each template has:

| Field         | Description                                                                            |
| ------------- | -------------------------------------------------------------------------------------- |
| **Name**      | Internal label for the template                                                        |
| **Body**      | The message text with placeholder variables                                            |
| **Variables** | Dynamic values substituted at send time (e.g. job reference, address, contractor name) |

Templates do not need external approval — they are managed entirely within PropOps.

***

## Supported recipients

| Account type | Supported |
| ------------ | --------- |
| Contractor   | ✅         |
| Tenant       | ✅         |
| Agent        | ❌         |
| Staff        | ❌         |
| Landlord     | ❌         |

***

## Use cases

* **Job assignment** — notify a contractor that a new job has been assigned
* **Appointment reminders** — remind a tenant about a scheduled visit
* **Status updates** — inform a tenant that their repair is complete
* **Document requests** — ask a contractor to upload an expired certification

***

## Message logging

Every WhatsApp message sent through PropOps is logged against the job record, including the template used, recipient, message text, and timestamp. This provides a full audit trail of communications.