Skip to main content
Versions let you change a live agent without affecting the conversations it’s already having. You edit a draft, test it, and publish it when it’s ready. With Split Traffic, you can run two published versions side by side and compare their results before choosing a winner. For how versions fit into a safe rollout, see Path to production.
Versions and Split Traffic are enabled per account. Contact support@callers.ai to turn them on.

​
How versions work

  • Every agent starts with version V1.
  • When you save changes to a published version, Callers creates a new Draft with the next number (V1 → V2, v1.2 → v1.3). The published version keeps running unchanged.
  • Live conversations always use the Published version. Drafts are only used by test calls you point at them.
  • Each version stores its own script and scenarios, which workflow items it uses, and which knowledge bases are connected.

​
What’s shared by all versions

Many settings belong to the agent as a whole, not to a version: General Settings, Availability, Channels, the voice and conversation parameters, and the workflow catalog (triggers, pre-call actions, in-call actions, and webhooks). Each version chooses which catalog items it uses. To compare two voices or patience levels, run the versions as separate agents instead. When you change a shared setting, Callers shows “These changes will be applied to all versions:” with an Undo option per category. Click Apply to all versions to confirm.

​
Manage versions

Click Versions in the editor header. Versions are grouped into Published, Drafts, and Previously Published. The header shows a Draft or Published badge for the version you’re editing.
Versions History drawer listing V5 and V2 under Published with 10% and 90% traffic badges, V7 and Test scenarios under Drafts with Draft badges, and V3 under Previously Published, each with a date, author, and a menu button

The Versions History drawer, grouped into Published, Drafts, and Previously Published, with traffic shares on the published versions.

​
Publish a version

1

Save your draft

Make your changes and click Save. The Publish button appears when there are no unsaved changes.
2

Test the draft

Click Test and pick the draft in the version dropdown. See Test your agent.
3

Publish

Click Publish. If the agent is running, Callers warns that publishing stops the running version and applies all settings from the new one.
4

Restart

After publishing, choose Start Campaign to start the agent again, or Not Now.
Publishing is blocked if a required integration isn’t connected (“Cannot publish version”) or if the agent has no phone number (“Please assign a phone number before publishing this version.”).
Name versions after what changed, such as V3 – shorter intro or V4 – new pricing objection. It makes comparisons and rollbacks much easier.

​
Roll back

To return to an earlier version, open Versions, find it under Previously Published, and Publish it again. Or Duplicate it to start a new draft from that point.

​
Version history

Accounts that don’t use draft and published versions have Versions History instead. It lists saved snapshots of the agent, with the newest marked Latest.
  • Click a snapshot to view it (“You’re now viewing one of your old versions”). Click Back to latest to return.
  • Choose Restore to replace the agent with that snapshot. “Restoring will replace all current Agent data with the selected version.”

​
Split Traffic

Split Traffic sends a share of contacts to each of two published versions so you can A/B test a script change: a new opening, a different pitch, a shorter flow.
1

Prepare two versions

Have one published version and a second version (draft or published) to test against it.
2

Open Split Traffic

In Versions, open the second version’s menu and choose Split Traffic. The Split your campaign traffic dialog opens.
Versions History drawer with the draft V5 selected and its menu open, offering Publish, Split Traffic, Edit name, Duplicate, and Delete Version

A draft version's menu: Publish, Split Traffic, Edit name, Duplicate, and Delete Version.

3

Set percentages

Enter a whole-number percentage for each version. They must add up to exactly 100. A new split defaults to 50/50.
4

Approve

Click Approve and Publish. If the agent is running, Callers asks you to confirm because publishing stops it. Start the agent again to run the test.

​
Rules

  • Up to 2 versions can receive traffic (1% or more) at the same time. To publish a third, set one of the two to 0% first.
  • Each new contact is assigned to a version at random, weighted by the percentages.
  • A contact stays on its assigned version for all retries, as long as that version keeps at least 1% of traffic.
  • To end a test, set the losing version to 0% (or Unpublish it with Approve and Unpublish).

​
Compare results

Turn on Insights Mode and open the Analytics tab. For each published version you’ll see Total Contacts, Connect Rate, Success Rate, Call Volume Hourly, Calls Duration, Failed Call Reason, and Failed vs successful call trend.
Change one thing per test and let each version reach a meaningful number of connected calls before deciding. Timing matters too: compare versions over the same days and hours.

​
FAQ

Contacts belong to the agent. Each call records which version handled it, so results and insights can be broken down by version.
No. Live calls use the published version until you publish the draft.
Publishing a new version stops the running agent so all its settings apply cleanly. Start it again from the publish confirmation or the status menu.
Uploads are checked against the variables of every published version combined.

Test your agent

Test drafts before publishing.

Agent results and insights

Insights Mode and per-step statistics.

Knowledge base

Connect knowledge bases per version.

Agent settings

Which settings are shared across versions.