> ## 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 Note Write-Back > Automatically save notes from Voqo AI calls into AgentBox as enquiries — and push your own notes too. ## What is it? With note write-back on, Voqo saves a note against the matching AgentBox contact whenever your AI agent has a meaningful call or SMS conversation with a synced contact. Your team sees the full story in AgentBox — who enquired, about what, and what happens next — without anyone re-typing call outcomes. In AgentBox, each of these notes is saved as an **enquiry** — AgentBox's own record of a contact interaction. You choose which kind of enquiry they're saved as, and you can write enquiries by hand from Voqo too. Write-back is **off by default**. Writing into your CRM is deliberate — you turn it on when you're ready. ## Prerequisites * AgentBox is connected to your workspace via the API integration (see [AgentBox Setup](agentbox-setup)). A CSV-only import isn't enough on its own — see [CSV-imported contacts](#csv-imported-contacts) below. * Your AgentBox API access includes **note** permissions — the write-back option only appears when it does (see [Troubleshooting](#troubleshooting) if you can't find it). Voqo re-checks your access on every sync, so a permission added in AgentBox later takes effect on the next sync — you don't need to reconnect. ## Turn on write-back 1. Go to **Integrations** and open the **⋮** Settings on the AgentBox card. 2. Select the **Contacts** tab. 3. Turn on **Write notes back to AgentBox**. 4. Choose the **Note types** to write — **Call**, **SMS**, or both. 5. Choose the **Enquiry type** your automatic notes are saved as (for example **Buyer Enquiry** or **Vendor Enquiry**). The list is your AgentBox account's own enquiry types. 6. Leave the **Attribution marker** on (recommended — see [below](#the-attribution-marker)). 7. Click **Save**. That's it. From the next meaningful conversation onwards, Voqo writes an enquiry to the contact's record in AgentBox. ### Two-way sync, handled for you Turning on write-back automatically keeps **contact sync** on — Voqo needs your contacts synced so there's always a record to write back to. There's nothing else to set up. While write-back is on, contact sync can't be switched off. If you want to stop syncing contacts, turn off write-back first. ### The attribution marker The **Attribution marker** adds a short line to each note Voqo writes, making it clear the note came from your AI agent rather than a colleague. It's **on by default**, and here's the honest reason why: Many agencies connect AgentBox with a shared or admin API key. When that's the case, a note Voqo writes shows the key's staff member as the author — so without a marker, an AI-written enquiry looks exactly like one a named colleague typed by hand. The marker keeps that from happening, because your agent should never be mistaken for a person. The marker defaults on, and turning it off is intended for agencies that have set up a **dedicated "Voqo AI" staff user** in AgentBox — so the enquiry already shows Voqo as the author and the extra line isn't needed. Under a shared login without the marker, an AI-written note can look like a colleague wrote it, which is why it stays on by default. See [How notes are attributed](#how-notes-are-attributed) below. ## How your notes appear in AgentBox Every note Voqo writes lands as an **enquiry** on the contact in AgentBox, saved under the enquiry type you chose. Enquiries carry the time the conversation actually happened — an inbound call from Tuesday shows Tuesday's date, not the time Voqo synced it. AgentBox enquiries are **permanent once written** — AgentBox itself doesn't allow them to be changed or removed afterwards. That shapes how editing and deleting work in Voqo, covered in [Notes in AgentBox can't be edited or deleted](#notes-in-agentbox-cant-be-edited-or-deleted). ## Which conversations create a note? Not every call does — only meaningful ones. Voqo writes a note when there's genuinely something worth recording: * **Creates a note** — a property enquiry, a price or quote discussion, interest in an inspection, feedback on a listing, a follow-up commitment * **Doesn't create a note** — a plain "call me back", a wrong number, a call with no real enquiry This keeps your AgentBox records clean: every enquiry Voqo writes is one your team would actually want to read. ## What a note looks like Notes are short, factual, and written in an activity-log voice — for example: > Sarah Nguyen enquired about 19 Example Street, Sampleton. Keen on a Saturday inspection and asked about recent sale prices in the street. Each note names the contact, says what was discussed, and includes the property when one came up. How the conversation came in — an inbound call, outbound call, or SMS — shows as a badge on the note in Voqo, so it never has to clutter the wording. ## Examples — what your notes look like in AgentBox Here's how notes show up as **enquiries** in AgentBox across the different situations. Each example is the enquiry as your team reads it — the enquiry type it's saved under, followed by the comment text. **A call note** (your agent's post-call summary), attribution marker **on**: > **Buyer Enquiry** > Michael Tran called about 42 Rosebank Avenue, Croydon. He's after a four-bedroom under \$1.2M and wants to inspect this Saturday. Asked whether the vendors would consider an early offer. > — Logged via Voqo AI **The same call note with the attribution marker off** — identical text, no marker line (only available once a dedicated Voqo AI staff user is set up): > **Buyer Enquiry** > Michael Tran called about 42 Rosebank Avenue, Croydon. He's after a four-bedroom under \$1.2M and wants to inspect this Saturday. Asked whether the vendors would consider an early offer. **An SMS reply note** — a text conversation your agent handled: > **Buyer Enquiry** > Priya Sharma replied by text confirming she'll attend the 11am open home at 8 Hillcrest Road, Blackburn, and asked for the contract of sale to be emailed through. > — Logged via Voqo AI **A manual note you typed in Voqo** and ticked *Also save to AgentBox*: > **Vendor Enquiry** > Spoke with the vendor at 15 Marne Street, Camberwell — happy to drop the asking price by \$20k ahead of the weekend. Wants a call back Monday with buyer feedback. > — Logged via Voqo AI **With a linked property.** When a note has a property attached, the enquiry is tied to that listing in AgentBox, and the contact is recorded as a **prospective buyer** for it: > **Buyer Enquiry** · attached to *42 Rosebank Avenue, Croydon* > Michael Tran is keen on this one and wants a Saturday inspection. Enquired about the vendors' price expectations. > — Logged via Voqo AI **Without a linked property**, the same note is simply an enquiry on the contact, with no listing attached and no prospective-buyer record created. ## Save your own notes to AgentBox You can write notes by hand too, and send them straight to AgentBox. Open a contact, find the **Notes** section, and select **Add note**: 1. **Choose an enquiry type.** When the contact is linked to AgentBox and write-back is on, the type list is **your AgentBox account's own enquiry types** — the same categories you already use inside AgentBox. If AgentBox isn't linked, you'll see Voqo's general categories instead. 2. **Link a property, if you want the note tied to a listing.** A **Link a property** box lets you search your properties by address and attach one. See the note below about what this does in AgentBox. 3. **Type your note.** 4. **Choose where it goes.** An **Also save to AgentBox** checkbox sits under the note. Tick it to send the note to AgentBox as well as Voqo; leave it unticked to keep the note in Voqo only — handy for internal observations you don't want in the CRM. If the checkbox is greyed out, hover it to see what's needed to switch write-back on for this contact. 5. Select **Save**. If you leave **Also save to AgentBox** unticked, your note is saved in Voqo instantly. If you tick it, Voqo saves the note to AgentBox **first** and keeps it only once AgentBox has accepted it — so a note you add by hand is confirmed in your CRM the moment it appears. If AgentBox can't accept it, **nothing is saved**: the note stays open with a short reason so you can fix it and save again, or cancel. You never end up with a half-saved note. **Linking a property also creates a prospective buyer.** When you attach a property to a note on an AgentBox contact, AgentBox automatically records that contact as a **prospective buyer** for that listing. This is standard CRM hygiene — someone who enquired about a property is a prospective buyer — but it's a real change to your data, so Voqo tells you before you save. If you don't want that record created, don't link a property. ## See your notes in Voqo too Every note Voqo writes to AgentBox also appears in the contact's **Notes** section in Voqo, and so do the notes you write by hand. Each note shows, at a glance, its type, who wrote it, when, and whether it reached your CRM: * The **note type** sits above the note text. For automatic notes a **channel** badge sits alongside it, showing how the conversation came in — **Inbound call**, **Outbound call**, or **SMS**. * Under the note you'll see **when it happened** and **who wrote it** — *Voqo AI* for automatic call and SMS notes, or your team member's name for ones added by hand. * A **sync status** at the end of that line shows whether the note has reached AgentBox: * **Synced to AgentBox** — a steady icon once the note is safely saved in your CRM. Notes you add by hand show this as soon as they appear, because Voqo confirms them in AgentBox before saving. * **Syncing** — a small spinning icon while an automatic call or SMS note is on its way to AgentBox. * **Needs attention** — if an automatic note couldn't reach AgentBox, the icon turns amber. Hover for the reason, and click it to **retry** the push. Nothing is lost in the meantime — the note is always safe in Voqo. See [Add Notes to Contacts](../agent-settings/contact-notes) for everything else notes can do. ## Notes in AgentBox can't be edited or deleted AgentBox enquiries are permanent once written, so Voqo works with that rather than pretending otherwise: * **Editing.** Once a note is synced to AgentBox, its **Edit** control is switched off, with a short note explaining why. AgentBox keeps the enquiry exactly as it was first written. Notes that were only ever kept in Voqo (you left **Also save to AgentBox** unticked) stay editable as normal. * **Deleting.** You can still delete a synced note from Voqo — but because AgentBox can't remove the enquiry, **the copy in AgentBox stays**. Before you delete, Voqo confirms this plainly: the note goes from your Voqo list, and the historical record remains in your CRM. This keeps your CRM's history intact while still letting you tidy up your own view in Voqo. ## CSV-imported contacts If you brought contacts into Voqo through a **CSV import** rather than the AgentBox API connection, write-back is **switched off for those contacts** until they've been matched to their AgentBox record. Here's why: a CSV file doesn't carry the AgentBox contact ID, so Voqo can't yet tell AgentBox which contact a note belongs to. Once the AgentBox **API integration** is connected and runs a sync, Voqo matches each imported contact to its AgentBox record automatically — and from then on, write-back works for them like any other synced contact. Until that match happens, the **Also save to AgentBox** checkbox is greyed out on those contacts, with a tooltip explaining what's needed. Nothing fails silently — you'll always see why the option isn't available yet. To resolve it, connect the AgentBox API integration (see [AgentBox Setup](agentbox-setup)) and let it sync. ## How notes are attributed Every enquiry Voqo writes is recorded against the staff user tied to the API key you connected AgentBox with. How that reads depends on your setup: * **A dedicated "Voqo AI" staff user** (recommended). If you provision a staff user in AgentBox just for Voqo and connect with a key issued under it, every enquiry is clearly authored by Voqo AI in your CRM. This is the cleanest setup, and it's the only one that lets you turn the attribution marker off. * **A shared or admin key** (the common case). The enquiry shows that staff member as the author, so the **attribution marker** stays on to make clear the note came from your AI agent. **About the dedicated Voqo AI user.** When Voqo writes an enquiry about a contact that doesn't yet have an assigned staff member in AgentBox, AgentBox attaches the connection's staff user to that contact as its owner. It never changes a contact you've already assigned to someone. If you set up a dedicated Voqo AI user, expect it to gradually pick up ownership of previously unassigned contacts — that's AgentBox's behaviour, and worth knowing before it shows up in your assignment views. ## Troubleshooting | Issue | Solution | | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | I can't see the write-back option on the Contacts tab | Your AgentBox API access doesn't include note permissions. If it already does, run **Sync** on the AgentBox card once — Voqo re-checks permissions on every sync and the option then appears. If it still doesn't, contact support and we'll check your access with you. | | The **Also save to AgentBox** checkbox is greyed out when adding a note | The checkbox is there but disabled until the note can be written back — **hover it for the exact reason**. Common causes: the contact came in through a CSV import and hasn't been matched to AgentBox yet (see [CSV-imported contacts](#csv-imported-contacts)), AgentBox is disconnected, your API access doesn't include note permissions, or **Write notes back to AgentBox** is turned off in the AgentBox Contacts settings. Fix the one the tooltip names and the checkbox becomes tickable. | | The enquiry types I'm choosing from look unfamiliar | When AgentBox is linked with write-back on, the list is pulled straight from your AgentBox account — so it matches your own enquiry types, not a generic set. If a type is missing, add it in AgentBox and it'll appear in Voqo. | | A call didn't create a note | Only meaningful conversations create notes — a plain callback request or wrong number won't. | | A note shows in Voqo but hasn't reached AgentBox | Its sync icon will be amber — hover for the reason and click it to retry. Notes usually reach AgentBox within a few minutes, and Voqo retries automatically if AgentBox is briefly unavailable. If it still won't sync, check the contact is synced from AgentBox — notes only push to contacts linked to your AgentBox account. | | I deleted a synced note but it's still in AgentBox | That's expected. AgentBox enquiries are permanent, so deleting removes the note from Voqo only — the copy in AgentBox stays as a historical record. | | I can't edit a note that's already synced | AgentBox enquiries can't be changed once written, so Voqo locks the note after it syncs. Notes kept in Voqo only (write-back left unticked) can still be edited. | ## Related docs * [AgentBox Setup](agentbox-setup) * [AgentBox CSV Import](agentbox-csv-import) * [Add Notes to Contacts](../agent-settings/contact-notes) * [Choose and Connect Integrations](overview-integration)