Skip to main content

Vision Batch Messaging: The Complete Guide

How to create a patient file in Vision with mobile numbers included, and send, track and troubleshoot a Batch Message.

Written by Sameera

Overview

Batch Messaging lets you send the same message to a group of patients in one go. For Vision practices, your file must now include each patient's most recent mobile number (or email address) and their date of birth. Accurx uses the contact details in your file, and no longer looks up every patient in Vision to find them. There's no need to reformat the mobile or CHI numbers — Accurx uses them exactly as they appear in your Vision export.

Why the change: Looking up every patient in Vision during a large batch was slowing Vision down for practices. Using the details in your file removes almost all of those lookups.

You can send three types of Batch Messages:

  • Message: free text or a template, with an optional attachment and SNOMED code

  • Questionnaire: structured questions, with replies coming back to your Accurx inbox

  • Self-Book: invites patients to book an appointment

Batch Messaging is part of the premium tier of Accurx Desktop. Open it from the toolbar: click the downward arrow, then Batch message. It opens in your browser.


Before you start

Your file must contain an identifier and a way to contact each patient.

Column

Required?

What it does

NHS or CHI number

Yes

Identifies the patient

Date of birth

Yes

Identifies the patient

Mobile number (headed Mobile No or Mobile Telephone)

Yes, unless you include an email column

The number we text. Use the patient's most recent mobile — no need to reformat it.

Email address

Optional

Sends by email instead of SMS, with no SMS fallback.

Please also:

  • You don't need to reformat the mobile or CHI numbers. Export them from Vision and upload them as they are.

  • Export a recent mobile number. Run your search close to when you send.

  • Remove patients you shouldn't message, such as those who have declined SMS consent or are deceased. Batch Messaging does not filter these out for you.

  • Remove duplicate NHS or CHI numbers.

  • Remove columns you don't need. Extra columns can cause errors. Accurx is a data processor, so we can't edit your file for you.

Patients without a valid mobile number or email address in your file won't receive the message. The rest of the batch will still be sent.


Create your file in Vision

Use an ad hoc search, a Vision+ patient list, or a Vision+ patient group export. Whichever you use, the file must include the NHS or CHI number and a column for mobile numbers.

Option 1: Ad-hoc search (recommended)

  1. In Vision, open the Reporting tab, then Search and Reports.

  2. Click Reports, then New Ad-hoc Search.

  3. Under Search Input, choose your patient group.

  4. Next to Report Details, click Add Entity, open Additional Patient Data, and add Communication numbers and Other identifiers. Communication numbers are what put the mobile number in your file, so don't skip it.

  5. Set Record Output to Export Data (Tab Separated). This gives you a .tsv or .txt file, which keeps NHS and CHI numbers intact. Only use .csv if you're confident leading zeros won't be lost.

  6. Click Run and save the file somewhere easy to find.

  7. Open the file and check that the mobile number column is headed Mobile Telephone. Remove any columns you don't need.

Option 2: Vision+ patient list (to be tested)

Draft method, not yet tested. It comes from another supplier's Vision guide and isn't in Vision's own help pages. Test on a live Vision+ system before publishing.

  1. In Vision+, open a search or list that includes the patients you want to message.

  2. Check the list shows these columns: NHS Number (or CHI number), Mobile Telephone, and, if you want to email patients, E-mail address.

  3. Remove any patients who have declined SMS or email consent.

  4. Right-click the list of patients, select Table, then click Save as CSV.

  5. Open the file and remove any columns you don't need. Keep the Mobile Telephone heading as it is.

  6. If the upload fails, open the CSV, save it again, and retry.

This method should produce a file with a column already named Mobile Telephone, so there's no renaming or Excel cleanup.

Option 3: Vision+ patient group export

  1. Open Practice Reports, select Patient Groups, and open your group.

  2. Download the patient group as a CSV file using CSV File. Vision+ exports the columns currently shown in the list, so check that the file has the CHI or NHS number and a mobile number. If there's no mobile column, use Option 1 or 2 instead.

  3. Open the file in Excel. Delete every column except the CHI or NHS number and the mobile number. Head the mobile column Mobile Telephone.

  4. Select the CHI or NHS numbers (not the heading).

  5. Right-click the selection and choose Format Cells.

  6. Select Custom, then 0.

  7. Under Type, enter ten zeros (0000000000) and click OK. This stops Excel from removing leading zeros.

  8. Save as a text (tab-delimited) file and close it, confirming any prompts to replace.

If leading zeros go missing from CHI numbers, save as .tsv or .txt rather than .csv.


Check mobile numbers in Vision+ before you export

Vision+ uses the first mobile number recorded for each patient. To see who has a usable number:

  1. In Practice Reports, open Patient Groups and select your group.

  2. Select Merge Patient Group, then SMS.

  3. Use the SMS Filters (Validated Mobile Numbers, Invalid Mobile Numbers, Declined SMS) to find patients to fix or remove.

Patients with an invalid or missing first mobile won't be messaged by Accurx either, so update their record in Vision before you run your export.


Send your batch

  1. Start a batch. From the toolbar, click the downward arrow, then Batch message. In Accurx Web, click + New, then Batch message.

  2. Upload your file. Choose Upload a file, click Continue, and select the file you created in Vision. If it has no mobile or email column, you'll see "Your file needs a mobile number column". Add the column and upload again.

  3. Review the patient list. Patients who can't be contacted are listed with a reason (see Troubleshooting). If some have no valid mobile, you'll see how many. Either fix their numbers in your file and upload again, or carry on and send to everyone else. Click Download List to keep a copy, then Continue.

  4. Compose your message. Write your own or search for a template or questionnaire (templates are managed in Manage Templates). The character count shows how many fragments the message uses. You can also attach a file with the paperclip icon (it must be generic, with no patient-identifiable information, as everyone gets the same document, and patients enter their date of birth to open it); add a SNOMED code with the tag icon, which is saved to the record; or choose a Questionnaire instead of a message, so patients can reply. Patients can't reply to a simple batch message.

  5. Schedule or stagger (optional). Click the arrow next to Send. Batches scheduled more than 3 days ahead: re-check each patient's mobile number before sending.

  6. Send. Click Send, then Send again to confirm. Messages are saved to each patient's record unless you untick Save. Saving takes about 2 seconds per patient, so keep Vision and the Accurx toolbar open until it finishes.

You'll then see the batch message sent. Click View message status to track it.

Messages go by email if your file has one, otherwise by NHS App (England only, with an SMS fallback if unread after 24 hours), otherwise by SMS. Self-Book batches always start by SMS or the NHS App.


Track your batch

Each batch shows a status. Click View details beside a batch to see every message.

Status

Meaning

Scheduled

Waiting for its scheduled send time

Sending

Sending or waiting for delivery confirmation

Done

Delivery has finished

Saving

Saving to the record

Saved

Saving to the record has finished

Cancelled

Batch Message was cancelled

The summary shows patients in the batch, messages delivered, patients without a valid mobile, and messages that failed (for example, the phone was off). Delivered counts only text messages, as email providers don't send delivery receipts.

Sent messages can't be unsent. Our support team can revoke access to links in a batch, but patients will still see the message, and revoked links can't be reactivated.


Troubleshooting and FAQs

What you see

Why

What to do

Your file needs a mobile number column

No mobile or email column in the file

Add a Mobile Telephone column (or an email column) and upload again

Contact details not provided

That patient's mobile is blank in your file

Add their mobile and re-upload, or send without them

Not a UK phone number

The number isn't a valid UK mobile

Correct it in Vision, re-export, and re-upload

The mobile number is likely to fail

A message to this number failed in the last 3 months

Check the number with the patient

Patient deceased

The patient is marked as deceased

Remove them from your search

CHI numbers missing leading zeros

Excel stripped them from a .csv

Save as .tsv or .txt, or use the Custom format step

Stuck on Sending

One or two messages are awaiting confirmation

Check View details

Unable to save

Messages couldn't be saved to the record

Check saving has finished; contact support if it persists

Why doesn't Accurx look up the mobile in Vision anymore? Looking up every patient during a large batch overloaded Vision for practices. Using the details in your file means patient look up is minimised, so Batch Messages don't slow Vision down.

What if a patient has no mobile number or email address in my file? They won't receive the message. Everyone else in the Batch Message still will.

Can I send a Batch Message by email only? Patients with an email address in your file receive an email, and there's no SMS fallback.

Does this affect EMIS or SystmOne? No. This change only applies to Vision practices.

Did this answer your question?