> ## 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.

# VaultRE Note Write-Back

> Automatically save notes from Voqo AI calls into your VaultRE contact records — and push your own notes too.

## What is it?

With note write-back on, Voqo saves a note against the matching VaultRE contact whenever your AI agent has a meaningful call or SMS conversation with a synced contact. Your team sees the full story in VaultRE — who enquired, about what, and what happens next — without anyone re-typing call outcomes.

Write-back is **off by default**. Writing into your CRM is deliberate — you turn it on when you're ready.

## Prerequisites

* VaultRE is connected to your workspace (see [VaultRE Setup](vaultre-setup))
* Your VaultRE API token includes **note** permissions — the write-back option only appears when it does (see [Troubleshooting](#troubleshooting) if you can't find it)

## Turn on write-back

1. Go to **Integrations** and open the **⋮** Settings on the VaultRE card.
2. Select the **Contacts** tab.
3. Turn on **Write notes back to VaultRE**.
4. Choose the **Note types** to write — **Call**, **SMS**, or both.
5. Click **Save**.

That's it. From the next meaningful conversation onwards, Voqo writes a note to the contact's record in VaultRE.

### 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.

## 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 VaultRE records clean: every note Voqo writes is one your team would actually want to read. You can raise or lower the bar with a [custom note style](#customise-your-notes).

## 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 — the house style leads with the contact's name (a [custom note style](#customise-your-notes) can change the voice and point of view, but always keeps those facts). How the conversation came in — an inbound call, outbound call, or SMS — shows as a badge on the note in Voqo and as the note's type in VaultRE, so it never has to clutter the wording.

## Customise your notes

Under **Advanced settings** (on the Contacts tab, once write-back is on) you'll find **Custom note style**. Describe in your own words how notes should read — the wording, the voice, the point of view (first person or third), and what's worth noting — for example:

> Short, third-person. Always name the property. Only note real property enquiries — skip plain callback requests.

Your custom style takes over completely: it controls the wording, voice, and point of view of **every** note Voqo writes. The built-in house style is used only when you haven't set a custom style. Either way, each note still includes the key facts — who the contact is, the property, and what was discussed — your style controls how those are phrased, never whether they're there.

Click **Preview** to see a sample note written in your style before you save. Leave the field blank to use our house style.

One description controls both the wording **and** the bar for what gets noted — so "only note price discussions" means exactly that.

## Save your own notes to VaultRE

You can write notes by hand too, and send them straight to VaultRE. Open a contact, find the **Notes** section, and select **Add note**:

1. **Choose a note type.** When the contact is linked to VaultRE and write-back is on, the note-type list is **your VaultRE account's own note types** — the same categories you already use inside VaultRE. If VaultRE isn't linked, you'll see Voqo's general categories instead.
2. **Link a property, if the type asks for one.** Some note types are about a specific property — pick one of those and a **Link a property** box appears. Search your properties by address and attach one, so the note lands against the right listing in VaultRE.
3. **Type your note** (up to 500 characters).
4. **Choose where it goes.** An **Also save to VaultRE** checkbox sits under the note. Tick it to send the note to VaultRE 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 VaultRE** unticked, your note is saved in Voqo instantly. If you tick it, Voqo saves the note to VaultRE **first** and keeps it only once VaultRE has accepted it — so a note you add by hand is confirmed in your CRM the moment it appears. If VaultRE can't accept it — for example an enquiry-type note that needs a property, with none linked — **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.

### Where the note types come from

When VaultRE is linked with write-back on, Voqo reads the note types straight from your VaultRE account, so the categories you pick from match your own setup — not a generic list. If you add or rename note types in VaultRE, the updated list flows through to Voqo automatically.

## See your notes in Voqo too

Every note Voqo writes to VaultRE 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** (e.g. *General*, *Enquiry*, *Open Home*) 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 (hover to confirm it was written by the system), or your team member's name for ones added by hand. If a note was later edited, the edit time shows here too.
* A **sync status** at the end of that line shows whether the note has reached VaultRE:
  * **Synced to VaultRE** — 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 VaultRE before saving.
  * **Syncing** — a small spinning icon while an automatic call or SMS note is on its way to VaultRE.
  * **Needs attention** — if an automatic note couldn't reach VaultRE, 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.

## Editing and deleting synced notes

Once a note is synced to VaultRE, Voqo keeps both copies in step:

* **Editing** a synced note updates VaultRE too. When you save, the button reads **Syncing to VaultRE…** while Voqo confirms the change landed in your CRM — then it saves. If VaultRE is briefly unavailable, you'll see a short message and can retry; your edit isn't lost. The note's **date** and any **linked property** are fixed when it's first created — VaultRE keeps the originals — so those two are locked while editing; you can still change the wording and the note type.
* **Deleting** a synced note removes it from **both Voqo and VaultRE**. You'll be asked to confirm first — the dialog reminds you the note is synced and that deleting removes it from both and can't be undone. If VaultRE is briefly unavailable, the delete shows an error and you can try again.

Notes that were only ever kept in Voqo (you unticked **Also save to VaultRE**) edit and delete instantly, with no CRM step.

## Troubleshooting

| Issue                                                                  | Solution                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| I can't see the write-back option on the Contacts tab                  | Your VaultRE API token doesn't include note permissions. Regenerate your token in VaultRE with note access and reconnect, or <a href="mailto:support@voqo.ai?subject=VaultRE%20note%20write-back">contact support</a> and we'll help you sort it out.                                                                                                                                   |
| The **Also save to VaultRE** 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 isn't linked to VaultRE, VaultRE is disconnected, your API token doesn't include note access, or **Write notes back to VaultRE** is turned off in the VaultRE Contacts settings. Fix the one the tooltip names and the checkbox becomes tickable. |
| The note types I'm choosing from look unfamiliar                       | When VaultRE is linked with write-back on, the list is pulled straight from your VaultRE account — so it matches your own note types, not a generic set. If a type is missing, add it in VaultRE 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. If you've set a **Custom note style** that narrows what's worth noting, that applies too.                                                                                                                                                                                                  |
| A note shows in Voqo but hasn't reached VaultRE                        | Its sync icon will be amber — hover for the reason and click it to retry. Notes usually reach VaultRE within a few minutes, and Voqo retries automatically if VaultRE is briefly unavailable. If it still won't sync, check the contact is synced from VaultRE — notes only push to contacts linked to your VaultRE account.                                                            |
| My edit or delete is stuck on "Syncing to VaultRE…"                    | Editing or deleting a synced note waits for VaultRE to confirm the change. If VaultRE is briefly unavailable you'll see a short error — just try again. Your note and your change are never lost.                                                                                                                                                                                       |
| My note wouldn't save and stayed open with a message                   | When **Also save to VaultRE** is ticked, the note is saved to VaultRE first — if VaultRE rejects it (for example an enquiry-type note with no property linked), nothing is saved and the note stays open with the reason. Fix what it mentions — link a property, or pick a different note type — and save again, or untick **Also save to VaultRE** to keep it in Voqo only.           |
| A note reads plainer than usual                                        | If our note-writing assistant is briefly unavailable, Voqo still saves a simple factual note of the call rather than losing it.                                                                                                                                                                                                                                                         |

## Related docs

* [VaultRE Setup](vaultre-setup)
* [Add Notes to Contacts](../agent-settings/contact-notes)
* [Choose and Connect Integrations](overview-integration)
