> ## 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 CSV Import > Import contacts from AgentBox (Reapit Sales) into Voqo AI via CSV upload. If your agency has Reapit-approved API access, the [AgentBox API integration](agentbox-setup) is the recommended path — it handles the initial backfill **and** keeps your contacts in step with AgentBox automatically. Use the CSV path on this page if you don't have API access yet, or for a quick one-off migration. ## Prerequisites * **Workspace admin** role (required to manage contacts) * An AgentBox (Reapit Sales) account with the **Download CSV** permission enabled for your staff profile * Your AgentBox contacts exported as a **Standard Contact CSV** file ## Export Contacts from AgentBox 1. In AgentBox, click the **Contacts** icon from the main menu. 2. Use **Advanced Search** to filter the contacts you want to export. 3. Click the **Download CSV** action icon. 4. Select **Standard Contact CSV** as the export type. 5. Click **Download** and save the file. AgentBox limits each CSV export to **1,000 contacts**. If you have more than 1,000 contacts, filter your search and export in batches. For bulk exports beyond this limit, contact AgentBox Support. ## Import into Voqo AI 1. Go to **Contacts** in the sidebar. 2. Click **+ Add Contact**. 3. Select the **CSV Import** tab. 4. In the **CRM Format** dropdown, select **AgentBox**. 5. Drag and drop your `.csv` file (or click to browse). Maximum file size is 32 MB. 6. Click **Upload & Import**. Your import begins processing in the background. Click **View Import History** to track progress. ## What Gets Imported | Your Data | AgentBox CSV Column | How It Appears in Voqo | | ---------------- | ---------------------------------------- | -------------------------------------------- | | Name | `First Name`, `Last Name` | Contact name and last name | | Email | `Email` | Primary email address | | Mobile | `Mobile` | Primary phone number (E.164 format) | | Home phone | `Phone` | Additional phone number | | Work phone | `Work Phone` | Additional phone number | | Company | `Company` | Stored in CRM metadata | | Address | `Address`, `Suburb`, `State`, `Postcode` | Stored in CRM metadata | | Staff assignment | `Assigned Staff` | Stored in CRM metadata | | Contact tags | `Contact classes` | Contact categories (e.g. Buyer, Seller, VIP) | **Additional fields** such as `Title`, `Preferred Name`, and `Letter head` are preserved in the contact's CRM metadata for reference. ### Phone number normalisation All phone numbers are automatically converted to international format (E.164). Australian numbers like `0412 345 678` become `+61412345678`. Numbers that cannot be validated are skipped -- the contact is still imported if it has at least one valid phone number or email address. ### What gets skipped * **No name**: Rows with no first name and no last name are skipped. * **No contact method**: Rows with no valid phone number and no email address are skipped. * **Duplicates within the file**: If two rows represent the same contact (same name, email, and phone), only the last occurrence is kept. ## How Dedup Works When importing, Voqo AI checks for existing contacts to avoid duplicates: 1. **Same contact re-imported** -- If you upload the same CSV again, existing contacts are updated (not duplicated). Voqo generates a unique fingerprint from each contact's name, email, and phone number to detect matches. 2. **Phone or email match** -- If a manually created contact shares a phone number or email with an imported contact, they are linked. Your existing name and notes are preserved. 3. **New contact** -- Otherwise, a new contact record is created. ## Import History View the status of all your CSV imports: 1. Go to **Contacts**. 2. Click **Import History** in the top bar. Each import shows the file name, status, row counts (created, updated, skipped), and timestamp. ## Troubleshooting | Issue | Solution | | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "AgentBox exports are plain .csv files" error | You uploaded a `.zip` file. AgentBox exports contacts as bare `.csv` files -- upload the CSV directly. | | Contacts missing after import | Contacts without any phone number or email are skipped. Contacts without a first name and last name are also excluded. Check your AgentBox export filters. | | Phone numbers not matching | Voqo normalises phone numbers to E.164 international format. Landline numbers without area codes may fail validation. Re-export from AgentBox with full phone numbers. | | File too large | Maximum upload size is 32 MB. AgentBox limits exports to 1,000 contacts per file, so this is unlikely -- check if the file contains extra data. | | Import stuck on "Processing" | Large imports may take a few minutes. If the status does not change after 10 minutes, try uploading again. | If unresolved, contact support with your workspace ID and the CSV file. ## Related Docs * [AgentBox Setup (API integration)](agentbox-setup) — ongoing two-way sync with delta updates * [Choose and Connect Integrations](overview-integration) * [VaultRE Setup](vaultre-setup)