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

# AgentBox Setup

> Connect AgentBox (Reapit) to sync listings and your full contact list into Voqo AI.

AgentBox by Reapit is a widely used real estate CRM across Australia. Connecting it lets your active stock flow into Voqo's Knowledge Base automatically, and brings your **full AgentBox contact list** into Voqo — buyers, vendors, enquirers and everyone in between — so your AI voice agent has the complete picture to work from.

Once connected, Voqo keeps itself in step with AgentBox automatically. Listings and contacts refresh on a schedule with no manual exports or uploads.

<Note>
  Prefer a one-shot CSV upload instead? See [AgentBox CSV Import](agentbox-csv-import). The API connection on this page is the recommended path because it handles both the initial backfill **and** keeps your data in step going forward — but CSV is a good fit if you don't have API access set up yet.
</Note>

## Prerequisites

* **Workspace admin** role (required to manage integrations)
* An AgentBox account with Reapit-approved **production API access** (see below)
* Your AgentBox **Client ID** and **API Key** ready to paste

### Getting API access from Reapit

AgentBox API access is a paid, gated process managed by Reapit (AgentBox's parent company). Before you can connect, you'll need to organise the following:

* **A \$1,000 setup fee** payable to Reapit for production API access
* **A signed agreement** between your agency and Reapit covering the integration
* **A 2–3 week lead time** from sign-off to credentials being issued
* **IP allow-listing** — Reapit will add Voqo's static egress IP to your account's allow-list

This is a one-off setup, not an ongoing cost from Voqo. To kick it off, contact <a href="mailto:support@voqo.ai?subject=AgentBox%20API%20access">support</a> — we'll send you everything you need to give to Reapit, including our static IP and the agreement template.

<Note>
  Sandbox credentials won't work for the live integration. Make sure Reapit has issued you **production** Client ID and API Key values before starting the connect flow.
</Note>

## Connect AgentBox

The connect flow is a four-step wizard. Step 1 verifies your credentials, Step 2 picks which AgentBox office you're connecting, Step 3 chooses what to sync, and Step 4 previews how many records will come in so you can confirm before kicking off the sync.

### Step 1 — Credentials

1. Go to **Integrations** in the sidebar.
2. Find the **AgentBox** card and click **Connect**.
3. Paste your **Client ID** and **API Key** into the matching fields.
4. Click **Test connection**.

If your credentials are valid, Voqo ticks the connection and moves you to Step 2. If not, you'll see an error — double-check both values and try again.

### Step 2 — Choose your office

AgentBox accounts can manage multiple offices under one franchise. Voqo connects **one AgentBox office per workspace** — so pick the office this workspace should sync against.

* If your AgentBox key sees only one office, this step is skipped and the office is picked automatically.
* If your key sees more than one office, you'll see a single-select dropdown. Pick the office you want this workspace to sync from.

<Note>
  If you manage multiple AgentBox offices and want each in Voqo, you'll need a separate Voqo workspace for each office. This keeps each office's contacts and listings cleanly scoped.
</Note>

### Step 3 — Pick what to sync

You'll see five scope options:

* **Listings** — default on. Your active and recent stock flows into the Knowledge Base automatically.
* **Sold & off-market listings** — opt-in. Retain settled, withdrawn, and archived listings in your Knowledge Base instead of removing them, with a **Sold** badge on the listing card and full sale-history detail.
* **Leased listings** — opt-in. Retain leased rentals in your Knowledge Base with a **Leased** badge, including weekly rent, lease term, and lease start/end dates pulled from AgentBox's tenancy detail.
* **Pre-Market listings** — opt-in, default off. Pull in **Appraisal**, **Listing Presentation**, **Missed Appraisal**, and **Pending** stage listings with a **Pre-Market** badge.
* **Contacts** — opt-in. Tick this to bring your AgentBox contacts into Voqo.

You can change any of these later via the **⋮** Settings on the AgentBox card. See [Managing your listing scope](#managing-your-listing-scope) below for how scope changes affect your synced listings.

When you tick **Contacts**, an optional limit field appears:

> **Initial backfill limit (optional)**

Most agencies leave this **blank** to bring in their full contact list — that's the recommended path. The limit field is there for two cases:

* **Sanity-check the integration first.** Set a small number (e.g. 100) to see exactly what comes through before committing to a full backfill.
* **Very large tenants who want a phased rollout.** Cap the first import and bring the rest in later by switching to **Sync all contacts** in **⋮ Settings** and hitting **Resync**.

<Note>
  **When the limit is set, Voqo enters "test mode" for contacts.** The initial backfill brings in your **least recently updated** contacts (the dormant tail — they don't matter operationally, so they're safe to sample with), and ongoing delta syncs are **paused** until you reconnect without a limit. Listings sync is unaffected and keeps running normally.

  To go live with ongoing contact sync, open the **⋮ Settings** on the AgentBox card, select **Sync all contacts** and **Save**, then click **Resync** to bring in your full contact list. There's no need to disconnect — your existing contacts are preserved.
</Note>

### Step 4 — Preview and confirm

This step appears only when you've ticked **Contacts**. It's a dry-run preview — nothing has been committed yet.

You'll see:

* The **total number of contacts** in the selected AgentBox office
* An **estimated sync time** based on AgentBox's API throughput
* A reassurance that you can close the modal and let it run in the background

You'll also see an info block reminding you:

> **Contacts already in your workspace won't be re-imported.** If an AgentBox contact matches an existing record by phone or email, we'll keep the existing record and skip the AgentBox duplicate. You'll see the skipped count in your Sync History.

You have two choices:

* **Adjust** — go back to Step 3 to set or change the initial-backfill limit.
* **Confirm and start sync** — commits the integration and kicks off both listings and contacts sync jobs in the background. The modal closes immediately.

## What happens after you connect

Listings appear in your Knowledge Base within minutes. Contacts run as a background job — for a tenant of tens of thousands of contacts, expect around 10–20 minutes for the initial backfill. You can keep working while the sync runs.

The **AgentBox** card on the Integrations page shows a **Connecting** badge while any sync job is in progress. Once all jobs complete, the badge flips to **Connected**.

Newly synced contacts from the initial backfill are added to your **Action Loop** so your agent can start working through them straight away. Subsequent automatic syncs run silently in the background — a dedicated notification surface for ongoing changes is on the roadmap.

To watch progress in detail, open the **Sync History** panel from the top of the Integrations page.

## Listing states from AgentBox

AgentBox exposes the richest lifecycle of any CRM Voqo connects to. When you opt in to each scope, listings flow into dedicated tabs in your Knowledge Base.

### Sold listings

When you enable **Sold & off-market listings**, AgentBox properties marked **Conditional**, **Unconditional**, **Settled**, or **Sold - Other Agent** appear in the **Sold** tab with a red **Sold** badge.

Each sold listing carries:

* **Sold price** — the agreed sale price.
* **Sold date** — the date the sale was agreed (contract date).
* **Sale method** — Auction, Private Treaty, Tender, Expressions of Interest, or other, as recorded in AgentBox.
* **Price-display flag** — honours AgentBox's vendor-confidentiality setting; sold price is hidden in the Knowledge Base if the vendor instructed AgentBox not to publish it.

### Leased listings

When you enable **Leased listings**, AgentBox rentals marked **Leased** appear in the **For Lease** archive with a **Leased** badge. The card carries:

* **Weekly rent** — AgentBox's tenancy rent value, normalised to weekly.
* **Lease start date** — pulled from AgentBox's `tenancyDetails.leaseStartDate`.
* **Lease end date** — pulled directly from AgentBox's `tenancyDetails.leaseEndDate`.
* **Lease term** — pulled from AgentBox's `tenancyDetails.leaseTerm`.

AgentBox returns full tenancy detail, so leased listings are accurate end-to-end — no derivation.

### Inspection and open-home times

AgentBox listings now bring their **inspection and open-home times** into your Knowledge Base. When a property has scheduled inspections in AgentBox, those times appear on the listing so your AI agent can tell callers exactly when they can view the property.

* **Where it shows** — inspection times surface on the listing alongside its other detail.
* **Kept current** — times refresh on each sync, so cancelled or rescheduled inspections stay accurate.
* **No setup needed** — this is automatic for AgentBox listings; there's no separate toggle.

### Off-market listings

AgentBox listings marked **Archived**, **Withdrawn**, **Sold - Other Agent**, or **Leased - Other Agent** appear in the **Off-Market** tab with an **Off-Market** badge. Your AI agent prefixes these listings with **"OFF-MARKET —"** when speaking about them.

### Pre-market listings (Appraisal, Listing Presentation, Pending)

When you enable **Pre-Market listings**, AgentBox properties in **Appraisal**, **Listing Presentation**, **Missed Appraisal**, or **Pending** stages — the listings you're pitching or working towards a formal listing on — appear in the **Pre-Market** tab with a **Pre-Market** badge.

These are useful when you want your AI agent to be aware of properties you're pitching, even before they go live. **Default off** so they don't clutter your Knowledge Base if you don't need them.

You can hide pre-market listings from your Knowledge Base view without un-syncing them — see [Pre-Market Listings](../knowledge-base/pre-market-listings) for the Hide toggle.

### Upcoming auctions

AgentBox auction listings populate Voqo's **Upcoming Auctions** smart-list template. The auction date is pulled from AgentBox's `auctionDate` field. Build a list under **Quick Create → Upcoming Auctions** and attach it to your AI agent so it can prepare for auction-week calls.

***

## Smart lists for AgentBox listings

In the Knowledge Base **Quick Create** menu, you can build per-state smart lists that include AgentBox stock:

* **Sold Properties** — every sold listing (across all integrations); narrow to AgentBox with the source filter
* **Leased Properties** — every settled leased rental
* **Pre-Market Properties** — every Appraisal-stage AgentBox listing (only populated when pre-market scope is on)
* **Upcoming Auctions** — every listing with an auction date in the next 14 days

<Note>
  **`Lease Properties` vs `Leased Properties`** — these are different lists. **Lease Properties** is your current rental stock available to lease. **Leased Properties** is the archive of rentals that have already been leased out. Pick the one that matches your use case.
</Note>

***

## Managing your listing scope

You can change what AgentBox syncs at any time from the **⋮** Settings on the AgentBox card.

### Choose how far back to keep sold and leased listings

When you enable **Sold & off-market listings** or **Leased listings**, a **Historical listing window** selector appears in your AgentBox settings. It controls how far back Voqo includes sold, leased, and off-market listings on the next sync, based on when each listing was last updated.

* **Pick a window** — **Last 1 month**, **Last 3 months**, **Last 6 months**, **Last 12 months** (the default), or **Last 24 months**.
* **Older listings roll off automatically.** A sold or leased listing that hasn't been updated within your chosen window drops out of your Knowledge Base on the next sync.
* **Widen the window to bring older listings back.** Switch to a longer window and run a sync — the older sold and leased listings reappear.
* **The selector only shows when Sold or Leased is enabled.** Your live and pre-market listings always sync in full and are never affected by this window.

### Turning a scope off — and getting your listings back

When you turn **off** a listing scope in your AgentBox settings, Voqo **removes** the already-synced listings of that type from your Knowledge Base. Because this removes records, Voqo always asks you to confirm first:

* **You'll see a confirmation dialog** telling you exactly **how many listings** will be removed, and **which manually managed lists** they sit in (if any), before anything is deleted.
* **Nothing is removed until you confirm.** Click **Cancel** to leave everything in place.
* **Nothing is lost permanently.** You can **restore** these listings at any time by re-enabling the scope and running a sync.

## Grouping your AgentBox listings

In the Knowledge Base, the **Quick Create** menu includes an **AgentBox Properties** list under *By Integration Source*. Pick it to build a list that automatically holds every property synced from AgentBox — new listings join the list on each sync, and removed listings drop out. Attach that list to an agent so it only ever references your AgentBox stock. You can also narrow it further with the listing-agent filter to give an agent just one agent's properties.

## Already managed by another CRM ("Claimed")

If you've already connected another CRM to this workspace — for example VaultRE or Eagle MRI — and an AgentBox contact matches an existing record by phone or email, Voqo will **leave that contact managed by the original CRM** and count it as **Claimed** in your Sync History.

This is correct behaviour, not an error. It means:

* Your existing records keep their source badge (VaultRE or Eagle), notes, and call history intact.
* You won't see two near-duplicate contact rows for the same person across different CRMs.
* The AgentBox sync still imports every contact that **doesn't** already exist in your workspace.

You'll see the count of these skipped records as **Skipped (already managed by another CRM)** alongside the created and updated counters for each sync job in **Sync History**. If you ever need to switch which CRM owns a given contact, contact <a href="mailto:support@voqo.ai?subject=AgentBox%20contact%20ownership">support</a>.

## Sync History

The **Sync History** button lives at the top right of the **Integrations** page. Click it to slide open a panel showing every sync job across all your integrations.

For each job you'll see:

* **Provider** — AgentBox, VaultRE, Eagle MRI, etc.
* **Scope** — Listings or Contacts
* **Status** — Pending, Processing, Completed, or Failed
* **Counts** — records created, updated, and skipped (including the **Skipped (already managed by another CRM)** counter when relevant)
* **Estimated vs actual time** — so you can see whether the sync is on track
* **Auto or Manual** — whether the job was triggered by a scheduled sync (**Auto**) or by you (**Manual**)

Active jobs sit at the top with a live spinner. Failed jobs show a short error message and a **Retry** button.

## Ongoing sync

After the initial backfill is complete, Voqo runs scheduled delta syncs against AgentBox automatically. These pull anything that has changed in AgentBox since the last successful sync — including updates to contacts you've already brought into Voqo, and any **new contacts** created in AgentBox after you connected.

No action is required — scheduled syncs are fully automatic and appear as **Auto** rows in **Sync History**. If you want to pull updates between scheduled runs, click **Sync now** on the AgentBox card.

## Troubleshooting

| Issue                                                        | What to do                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Invalid credentials**                                      | Double-check the **Client ID** and **API Key** values are pasted correctly and in full. Confirm with Reapit that your credentials are **production** (sandbox credentials won't authenticate). If the error persists, re-issue the API key in AgentBox and try again.                                                                                                                                                                          |
| **AgentBox is currently unavailable**                        | A transient AgentBox outage. Wait a few minutes and try again. If it persists for more than 15 minutes, contact <a href="mailto:support@voqo.ai?subject=AgentBox%20outage">support</a>.                                                                                                                                                                                                                                                        |
| **No offices appearing in Step 2**                           | Your API key may not have permission to see any offices. Check the key's permissions in AgentBox admin, or ask Reapit to re-issue with the right scope.                                                                                                                                                                                                                                                                                        |
| **Contacts not appearing in Action Loop**                    | The initial backfill posts new contacts to your Action Loop. Subsequent delta syncs run silently in the background — a separate notification surface for ongoing changes is on the roadmap. Open **Sync History** to confirm contacts have been imported.                                                                                                                                                                                      |
| **A contact I expected is missing**                          | If the contact already exists in your workspace from another CRM (VaultRE or Eagle MRI), it will be marked as **Claimed** and kept under the original CRM. Check your Sync History for the **Skipped (already managed by another CRM)** count. If you set an **initial backfill limit**, you're in test mode — only the capped number of (least recently updated) contacts came in. Reconnect with the limit field blank to bring in everyone. |
| **Initial contacts sync is taking longer than the estimate** | The estimate is conservative. Open **Sync History** for the live status — if the job is still **Processing**, it's on track. If it shows **Failed**, hit **Retry**.                                                                                                                                                                                                                                                                            |
| **A scheduled sync didn't appear**                           | Check **Sync History** for the latest **Auto** entry on AgentBox. If you don't see one within an hour of the scheduled window, contact <a href="mailto:support@voqo.ai?subject=AgentBox%20scheduled%20sync%20missing">support</a>.                                                                                                                                                                                                             |
| **My sold or leased listings disappeared**                   | You may have turned off the matching scope, or an older listing rolled off your **Historical listing window**. Re-enable the scope (or widen the window) from the AgentBox settings and run **Sync now** to bring them back.                                                                                                                                                                                                                   |
| **I want to keep more sold history**                         | Open the AgentBox settings and set the **Historical listing window** to a longer period (up to **Last 24 months**), then run a sync.                                                                                                                                                                                                                                                                                                           |
| **Inspection times aren't showing on a listing**             | Inspection and open-home times only appear when the property has scheduled inspections in AgentBox. Add or confirm the inspection in AgentBox, then run **Sync now**.                                                                                                                                                                                                                                                                          |

## Disconnect

1. Click **Disconnect** on the AgentBox card.
2. Confirm the action.

Disconnecting stops all future syncs. Previously synced listings and contacts remain in your workspace but are no longer linked to AgentBox — the source badge disappears and scheduled syncs stop.

## Need help?

If anything's not working as expected, contact <a href="mailto:support@voqo.ai?subject=AgentBox%20integration%20help">support</a> with your workspace ID and a screenshot of the **Sync History** panel.

## Related docs

* [AgentBox CSV Import](agentbox-csv-import) — one-shot CSV upload, useful before you have API access in place
* [Choose and Connect Integrations](overview-integration)
* [Knowledge Base Lists and Sources](knowledge-base-integrations)
* [Sold Listings in the Knowledge Base](../knowledge-base/sold-listings)
* [Leased Listings in the Knowledge Base](../knowledge-base/leased-listings)
* [Pre-Market Listings in the Knowledge Base](../knowledge-base/pre-market-listings)
