> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://pegasys.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Using the Macropoint Integration


||| Macropoint tracking is only available on **brokered dispatches** — the dispatch must be assigned to a carrier and have at least one shipment attached. An Equipment/driver record is **not** required.

Macropoint provides real-time location tracking of carrier shipments without the need for ELD hardware or a driver app. Pegasys integrates with Macropoint so you can request tracking on a brokered dispatch directly from the dispatch view and have location updates, trip events, and stop arrivals/departures flow back into Pegasys — and out to your customers — automatically.

**Installing Macropoint**
1. Ensure the Macropoint app is installed through the Pegasys marketplace
* Click **Marketplace** along the top navigation bar
* Click the **Macropoint** tile
* Click **Install** and confirm
2. Enter your **Macropoint ID** when prompted and click **Confirm**
* Need help locating your Macropoint credentials? Contact the Macropoint support team
3. Installation requires the **Manage Dispatch** and **Administrator** app permissions

**Completing the integration (one-time setup)**
Once installed, the Macropoint marketplace page displays four webhook URLs unique to your account:
1. **Location Updates**
2. **Order Status Change**
3. **Trip Event Updates**
4. **Form Submits**

Provide each of these URLs to the Macropoint team and paste them into the matching Macropoint webhook field. These are how Macropoint sends tracking data back to Pegasys, so tracking will not flow through until they are configured on Macropoint's side.

|| Each URL contains a private token unique to your company. Treat these URLs as confidential — anyone with them can post tracking data to your account.

**Transmitting a Dispatch to Macropoint**
1. Open the **Dispatch** you wish to track
* The dispatch must be assigned to a carrier and have at least one shipment
2. Click **More** along the top of the dispatch, then click **Track with Macropoint**
3. Complete the tracking request:
* **Tracking Start Date / Time** - when Macropoint should begin tracking
* **Tracking Interval (minutes)** - how often a location ping is requested
* **Time Zone** - the time zone for the start date/time
* **Phone Number** *(required)* - the carrier/driver mobile number Macropoint will track. This number is validated before the request is sent
* **Vehicle** *(optional)* - the truck/unit number, used when no equipment record is attached
* **Trailer** *(optional)* - the trailer number, used when no equipment record is attached
4. Click **Start Tracking** to send the order to Macropoint

**Viewing tracking later**
Once a dispatch has been successfully sent to Macropoint, the **Track with Macropoint** option is replaced by **Macropoint Tracking** under the **More** menu.
1. Click **More**, then **Macropoint Tracking**
2. The window displays:
* A **map** plotting every position Macropoint has reported, connected in travel order
* **Location Updates** - each reported location and the date/time it was recorded
* **Order Status** - the latest status message returned by Macropoint

**How this pushes to the Shipment Tracking link**
As Macropoint reports back through the webhook URLs, the data is applied automatically:
1. **Location Updates** are stored against the dispatch and become the truck's live position
2. **Trip Event Updates** automatically mark stop **arrivals and departures** on the dispatch
3. **Order Status Changes** are recorded against the order

The public **Shipment Tracking** link your customers receive will display the most recent Macropoint position, provided:
* The dispatch status is **In Transit**, and
* Macropoint is installed

|| When Macropoint is installed and reporting, its location takes priority over manual check calls and ELD integrations (KeepTruckin / BigRoad) for the live location shown on the Shipment Tracking link.

**Uninstalling Macropoint**
You can disconnect at any time from the **Macropoint** page in the Marketplace by clicking **Uninstall**. New tracking requests will be unavailable until Macropoint is reinstalled.