Skip to main content

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). A CSV-only import isn’t enough on its own — see CSV-imported contacts below.
  • Your AgentBox API access includes note permissions — the write-back option only appears when it does (see 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).
  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 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.

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 itVoqo 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 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) 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