Test a campaign before you start it
Before a real run you can send one test call or one test message to a test recipient, usually your own phone or mailbox, and see exactly what a contact would get. A test is built from the campaign as it is saved, never reaches the audience and does not show up in the campaign's statistics. It works for dialer campaigns (agent and blaster) and for message campaigns.
Where to find it
Open Admin, Contact centre, Dialer campaigns and then a campaign. The Test mode panel is on the campaign's page and in its editor, for voice campaigns and for message campaigns. You need queues:read to look at a voice campaign's test panel and queues:write to send a test. For a message campaign the permissions are messaging:read and messaging:write.
A test can be sent while the campaign is a draft, scheduled or paused. A running, stopped or completed campaign cannot be tested: pause it first.
Set the test recipient
The recipient says where tests go. There are two levels:
- The company default. Open the Company default test recipient link in the panel (the page is titled Test recipient of the company) and fill in the phone, e-mail address and chat ids you want to use. It needs
settings:writeto save. Use your own phone and addresses. - The campaign's own recipient. In the Test recipient section of the panel, fill in the fields you want to override and choose Save test recipient. A field you leave empty uses the company default, and the panel shows it as Company default.
The fields are:
| Field | Used for |
|---|---|
| Phone (international format) | Test calls, SMS and WhatsApp |
| E-mail address | E-mail steps |
| Telegram chat id, Messenger id, Instagram id | The matching channels. You can choose them from your inbox contacts with Pick from the inbox contacts. |
A voice campaign shows the phone field only. A message campaign shows the fields of the channels it uses.
A test only ever goes to the saved test recipient. The address is never taken from the audience, so a test cannot reach a customer by mistake.
Send a test
- Open the campaign and scroll to Test mode.
- For a message campaign, tick the Channels to test. With none ticked, every channel that is ready is used. A channel without an address shows no test address.
- Choose Test call (voice campaign) or Send test (message campaign).
A test call
The PBX places one real call to the test number with the campaign's own configuration: the message (text read aloud or recording), answering-machine detection, the agent and opt-out keys, the caller ID, and the dial plan, outbound rules and toll-fraud protection of the extension that places the calls. For an agent campaign you are connected to a free agent of the queue, as a real contact would be. A test call uses one of your licence's simultaneous calls like any trunk call.
A test message
Every step of the campaign is written for a sample person (the name reads Test Recipient) and sent once on each channel you ticked, under the usual channel rules. WhatsApp outside the 24 hour window goes as the approved template. Messenger and Instagram only work inside their reply window. E-mail subjects start with [Test] and carry a sample unsubscribe link.
Read the result
The Test results table lists the latest tests, newest first, with Time, Channel, Sent to, Status and Result. While a test is running the table updates by itself (Updating live while a test is running).
- Status follows the call or message: Queued, Ringing, Answered, Detecting answering machine, Playing the message, Waiting for a key, Connecting an agent, Sending, Sent, Delivered, Read, Completed, Skipped or Failed.
- Result for a call is one of A person answered, Answering machine, No answer, Busy, Connected to an agent, No agent was free, Pressed the opt-out key or The call failed, with the key the callee pressed.
- When something is skipped or fails, the row gives the reason in plain words, for example The 24 hour reply window is closed, No approved template for this channel, Channel not connected, The campaign has no message, Text-to-speech is not available or On the do-not-contact list.
What a test does and does not do
- It is not counted: not in the campaign's progress, results or estimate, not in the history of any person, and not in the cost of SMS.
- The opt-out key during a test call reports Pressed the opt-out key but does not put your number on the opt-out list.
- The do-not-contact list still applies. If the test recipient is on it, the test is refused with a message telling you to remove it from the opt-outs or to choose another recipient.
- A test is placed when you press the button. The campaign's calling days and hours are not applied to it, so pick a sensible moment for the person who will receive it.
- A campaign accepts 10 tests per hour. The panel shows how many are used (for example 3 of 10 tests used this hour), and after that asks you to try again later.
- Every test and every change of a test recipient is written to the audit log.
If a test is refused
| Message | What to do |
|---|---|
| Set a test recipient for the campaign or in the company settings first. | Fill in the phone or address as described above. |
| Only a draft, scheduled or paused campaign can be tested. | Pause the campaign. |
| This test recipient is on the do-not-contact list. | Remove it from the opt-outs or use another recipient. |
| This campaign has used its tests for this hour. | Wait and try again. |
| This server cannot place tests right now. | The call engine or the channel is not connected. Check the trunk or the channel, then try again. |
| The test request is not valid. | Check the recipient and the channels you ticked. |