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

# Integrations

> Connect PropOps to n8n workflow automation, WhatsApp messaging, Brevo email, Mapbox, and web push notifications from the admin panel.

PropOps connects to external services to power automation, messaging, mapping, and push notifications. All integrations are configured through the admin panel — no server access is needed.

<CardGroup cols={2}>
  <Card title="n8n Workflow Automation" icon="bolt">
    Trigger custom workflows from PropOps events to automate repetitive tasks and connect to third-party systems.
  </Card>

  <Card title="WhatsApp Messaging" icon="message-circle">
    Send pre-filled WhatsApp messages to contractors and tenants directly from job records.
  </Card>

  <Card title="Brevo Email" icon="mail">
    Transactional email delivery for job notifications, onboarding, SLA alerts, and more — with 30+ managed templates.
  </Card>

  <Card title="Mapbox" icon="map">
    Interactive contractor coverage maps showing trade areas, travel-time radii, and nearby points of interest.
  </Card>

  <Card title="Web Push / Apple APNs" icon="bell">
    Real-time push notifications delivered to browsers and iOS devices without requiring a native app.
  </Card>
</CardGroup>

***

## n8n Workflow Automation

n8n is an open-source workflow automation engine. PropOps can trigger n8n workflows in response to platform events — for example, when a job is created, when an SLA is breached, or when a contractor completes a job.

**What you can automate:**

* Notify external systems (Slack, Teams, CRM, accounting software) when job status changes
* Escalate unacknowledged jobs after a configurable delay
* Sync job data to spreadsheets or databases
* Trigger approval flows in external tools

<AccordionGroup>
  <Accordion title="Connecting n8n to PropOps">
    1. Go to **Settings → Integrations** in the admin panel.
    2. Enter your n8n instance URL and an API token with the appropriate permissions.
    3. Select **Test Connection** to verify the credentials.
    4. Save the settings.

    Once connected, PropOps can send webhook payloads to your n8n instance. Configure the corresponding webhook trigger node in n8n to receive and act on the events.
  </Accordion>

  <Accordion title="Available trigger events">
    Events that can trigger n8n workflows include job creation, job status changes, SLA breach alerts, contractor assignments, invoice generation, and security guard events. Contact your PropOps administrator to confirm which events are enabled for your organisation.
  </Accordion>
</AccordionGroup>

***

## WhatsApp Messaging

The WhatsApp integration lets you send pre-filled template messages to contractors and tenants directly from a job record, without leaving PropOps. No WhatsApp Business API account is required.

**What it enables:**

* Send appointment confirmations and reminders to tenants
* Notify contractors of new job assignments
* Share job reference numbers and access instructions

<AccordionGroup>
  <Accordion title="Setting up WhatsApp">
    1. Navigate to **Admin → WhatsApp Templates** to create your message templates.
    2. Each template supports dynamic placeholders such as `{job_ref}`, `{contractor_name}`, and `{appointment_date}`.
    3. Templates are managed entirely within PropOps — no external approval is needed.
  </Accordion>

  <Accordion title="Sending messages">
    A **Send WhatsApp** button appears on job records. Select it, choose the appropriate template, and click send. WhatsApp opens with the message pre-filled — review and tap **Send** in WhatsApp. Sent messages are logged against the job for audit purposes.
  </Accordion>
</AccordionGroup>

***

## Brevo Email

PropOps Web uses Brevo (formerly Sendinblue) for all outbound transactional email. Over 30 templates cover the full job lifecycle — from job creation and contractor assignment through to completion, invoicing, and SLA breach alerts.

**What it enables:**

* Automated email at every key job milestone
* Case-note email threading — replies from recipients are automatically linked back to the job
* Onboarding, email verification, and password reset emails
* Overdue certificate and document reminders

<AccordionGroup>
  <Accordion title="Connecting Brevo">
    1. Log in to your Brevo account and generate an API key from **SMTP & API → API Keys**.
    2. Go to **Settings → Integrations** in PropOps and enter your Brevo API key, sender email address, and sender name.
    3. Save the settings. PropOps will use these credentials for all outbound email from that point forward.
  </Accordion>

  <Accordion title="Email template management">
    Email templates are managed in your Brevo account. Each template is referenced in PropOps by its numeric Brevo template ID. The mapping between PropOps events and template IDs is configured in **Settings → System Configuration**.

    You can preview any sent email in **Settings → Email Logs**, which records the template used, recipient address, and delivery timestamp for every outbound message.
  </Accordion>
</AccordionGroup>

***

## Mapbox

The contractor coverage map is powered by Mapbox GL JS. It shows all contractors on a full-screen interactive map with filters by trade, coverage radius, and travel time. Isochrone overlays visualise how far a contractor can travel within a given time, and points of interest (hospitals, parking, nearby landmarks) are available as optional overlays.

**What it enables:**

* Visual matching of contractors to job locations
* Travel-time radius visualisation per contractor
* Postcode and location search with autocomplete
* Local vs. nationwide contractor separation

<AccordionGroup>
  <Accordion title="Enabling Mapbox">
    1. Create a Mapbox account at [mapbox.com](https://www.mapbox.com) and generate a public access token from your account dashboard.
    2. Go to **Settings → Integrations** in PropOps and enter your Mapbox access token.
    3. Save. The contractor coverage map will be available immediately under **Coverage Map** in the main navigation.

    Without a valid Mapbox token the coverage map page will not load.
  </Accordion>
</AccordionGroup>

## Web Push / Apple APNs

PropOps delivers real-time push notifications to browsers (via Web Push with VAPID keys) and to iOS devices (via Apple APNs). Users receive push alerts for job updates, SLA breaches, security events, and other configurable events without needing to have PropOps open.

**What it enables:**

* Browser push notifications on desktop and Android
* iOS push notifications via Apple APNs
* Background event processing so alerts arrive even when the tab is closed

<AccordionGroup>
  <Accordion title="Enabling web push (VAPID)">
    VAPID keys are generated once during initial setup and stored in the system configuration. No ongoing API key management is required for web push beyond the initial setup.

    Users must grant notification permission in their browser. They are prompted to do so the first time they log in after push notifications are enabled. Users can manage their push subscription from their profile page.
  </Accordion>

  <Accordion title="Enabling iOS push (Apple APNs)">
    To deliver notifications to iOS devices:

    1. Obtain an Apple Push Notification service (APNs) certificate or token from your Apple Developer account.
    2. Go to **Settings → Integrations** and upload your APNs credentials.
    3. Save. iOS devices will begin receiving push notifications on the user's next login.

    iOS users must install PropOps to their home screen as a PWA and grant notification permission when prompted.
  </Accordion>

  <Accordion title="Notification channel settings">
    To control which events trigger push notifications and for which roles, go to **Settings → Notification Settings**. See [Settings → Notifications](/configuration/settings#notifications) for full details.
  </Accordion>
</AccordionGroup>