Autodialer & Predictive Dialling
Use Admin → Dialer in your SessionPBX workspace to call a contact list and connect answered calls to available agents. Choose Automatic dialer for one call per available agent, or Predictive dialer to adjust the number of calls using agent availability and recent answer patterns.
Availability and pricing
Both dialers are optional add-ons for Teams Business. Every Teams Business workspace can start a free trial without manual approval. Paid access requires customer approval and an agreed concurrent-call limit. Dialers are hidden and unavailable on Teams Phone.
| Add-on | Price | Calling behaviour |
|---|---|---|
| Autodialer | $15 USD per assigned paid agent per month | Reserves an available agent before dialling each contact, then connects the answered call. |
| Predictive dialling | $25 USD per assigned paid agent per month | Starts conservatively, then adjusts concurrent dials using available agents and recent answers, within your approved limits. |
Assign each add-on only to the agents who need it. The price does not apply to every seat in the workspace. Each add-on has its own assignments; assigning both paid add-ons to one agent has a combined value of $40 USD per month. Your carrier continues to bill call traffic separately.
The Dialer menu is visible to Teams Business workspace administrators before either add-on is activated. Each agent can start their own 14-day trial of each dialer from their row, with up to three active trial agents per dialer at once and two concurrent calls shared across trials. No manual approval is needed. Opening the page or starting a workspace subscription trial does not start an agent’s dialer trial clock.
Billing is currently managed with SessionTalk support. Saving or removing agent assignments does not automatically change Chargebee subscription quantities. Arrange paid activation and later billing changes with support; assignment controls are not a checkout or cancellation flow. See the current pricing .
Before you begin
You need:
- A Teams Business workspace and administrator access.
- An active dialer trial or approved paid access for the dialer you want to use.
- Enabled team members with working phones or apps.
- A working outbound SIP trunk and a calling extension with Outbound PSTN enabled.
- Contact numbers in full international format, beginning with
+and the country code.
First confirm that the selected calling extension can make a normal outbound call through your carrier. Then run a small test campaign before using a larger contact list.
Start an agent’s free trial
- Open Admin → Dialer → Agent add-ons.
- Select Assign Autodialer agents or Assign Predictive dialling agents.
- Find the agent’s row and select Start Trial to begin their 14-day free trial.
- That agent is assigned immediately and their own trial end date appears in the row. Other agents stay unchanged.
- Create a campaign and add contacts when ready. Starting a trial does not start calls.
Each agent can try each dialer once. Agents can start on different dates and receive their own 14-day period. Up to three agents can use trial access per dialer at once, sharing two concurrent calls across both dialers. Carrier call charges still apply.
Assign and remove agents
Select Start Trial in an eligible agent’s row to start their trial and assign access immediately. Use Remove access to unassign an agent, or Assign access to restore their existing active trial or approved paid access. Removing or reassigning access saves immediately and does not restart the trial.
Each row shows that agent’s status and trial end date. There is no Trial/Paid dropdown. Removing and reassigning an agent never restarts their clock. Disabled or removed members cannot dial. Removing paid access does not cancel billing automatically; arrange billing changes with support.
Move an agent to paid
- After the agent has started their trial, select Move to paid in that agent’s row.
- Review the agent’s name and monthly price: $15 USD for Autodialer or $25 USD for Predictive dialling.
- If paid access is not approved yet, select Request paid access to contact SessionTalk support for approval, billing setup and an agreed allowance.
- Select Confirm move to paid. Only that agent changes to paid access and remains assigned.
Other agents’ trials, dates and assignments stay unchanged. Opening or cancelling the confirmation does not change access. Billing remains managed with support. Each add-on has independent agent assignments.
How trials expire
An agent’s trial ends 14 days after their own start time. Existing trials started under the previous shared-date setup keep their original end dates. Repeated start requests, removing and reassigning agents, or changing the workspace plan do not restart a trial.
At expiry, that agent stops receiving new dialer calls. Already connected calls can finish, and other agents retain their own access. A campaign’s outbound calling extension must still have active access. Trial expiry never changes an agent to paid or triggers a purchase. Use Move to paid on that agent’s row when ready.
Create a campaign
- Select New campaign and enter a Campaign name.
- Choose Automatic dialer or Predictive dialer under Dialing mode.
- Select the Campaign agents who will receive answered calls. Only agents with active access to that mode appear.
- Choose an Outbound calling extension from those agents. It must have external calling enabled; your trunk supplies its configured caller ID.
- Set the calling and retry options below.
- Select Save campaign.
Saving a campaign does not start calling. Add contacts, check agent availability, and select Start campaign when ready.
Calling settings
| Setting | What it controls |
|---|---|
| Maximum concurrent calls | The campaign’s simultaneous contact calls. It cannot exceed the approved allowance. |
| Contact ring time (seconds) | How long to ring a contact: 10–90 seconds. |
| Agent ring time (seconds) | How long to ring an agent after the contact answers: 5–30 seconds. |
| Agent wrap-up (seconds) | Time before an agent receives another campaign call after a completed call, or after failing to answer an agent call: 0–300 seconds. |
| Maximum attempts per contact | Total attempts, including the first call: 1–5. The default is 1, so automatic retries are off initially. |
| Retry delay (seconds) | Wait before retrying an eligible busy or unanswered contact: 60–86,400 seconds. |
| Maximum dials per available agent | Predictive mode only: an upper limit of 1–3 dials per available agent. The actual rate can be lower. |
The workspace limit is shared across campaigns and both dialer modes. A mode can also have its own limit across campaigns. Ringing, connecting and connected contact calls all use this allowance. Creating another campaign does not increase it. Ask support if the approved limit needs to change.
Add contacts or import CSV
Open the campaign and select Add contact to enter a name and number, or select Import CSV to upload a contact list. A campaign can contain up to 10,000 unique numbers.
Use name and phone columns, for example:
name,phone
Demo contact,+442079460123
Second demo contact,+442079460124These are format examples; replace them with your own test contacts. Keep phone numbers as text in your spreadsheet so the leading + is preserved. The import preview shows the unique numbers found; select Import contacts to confirm.
Duplicate numbers in the file, or numbers already in the campaign, are skipped. Re-importing does not reset a contact’s status or attempts. If an import stops partway through, the page reports how many contacts were processed; retrying the file skips numbers already added.
To manage a contact, select Edit beside it:
- Choose Suppressed — do not call to exclude it from calling.
- Choose Pending — include in calling to explicitly schedule another attempt.
- Select Remove contact to remove it from the campaign.
You can also select Delete directly beside a contact in the list to remove it from that campaign. The list shows 25 contacts per page by default. Use Rows per page to choose 25, 50 or 100, and Previous or Next to move between pages. Deleting the last contact on a page returns to the last remaining page.
Once a number has call history, its phone number cannot be changed in place. Add a new contact for a different number. Campaign settings and contact changes require the campaign to be paused with no active calls remaining.
Run, pause and monitor
Set agents’ presence to Available, ensure their phones or apps can receive calls, and select Start campaign. The dialer uses agents who are free of calls and not reserved by another campaign or still in wrap-up. Busy or unavailable agents do not create capacity for new calls.
Agents answer their normal phone or app; the dialer does not force auto-answer. When configured, the workspace’s music on hold plays to an answered contact while an agent is being reached.
The campaign page refreshes progress automatically and shows:
- Pending: contacts waiting for an attempt.
- Dialed: attempts made, including retries.
- Connected: calls connected to an agent.
- Unconnected answers: answered contact calls that ended without reaching an agent.
- Active calls: calls currently dialling, connecting or connected.
Select Pause campaign to stop new calls. Calls already dialling or connected continue; wait for them to finish before changing settings, editing contacts or deleting the campaign. To resume, select Start campaign again.
Running campaigns pause after a voice-node restart and require an explicit restart from the campaign page. Calling or access errors can also pause a campaign; review the displayed message and correct the cause before restarting it. Deleting a campaign removes its contact list and dialer history, while existing call-log records remain.
Predictive pacing and answered calls
Predictive campaigns begin at one dial per available agent. After 10 completed attempts, recent answer rates can permit more concurrent ringing within the configured ratio and approved caps. If an answered contact cannot be connected to an agent, pacing backs off and temporarily stops starting new calls.
An answered call can be voicemail or another automated system. The dialer does not detect humans versus answering machines. Predictive pacing also cannot guarantee that every answered contact reaches an agent, so monitor Unconnected answers and reduce the dial ratio or concurrency when needed.
Only confirmed busy and unanswered contacts qualify for automatic retry, subject to the attempt and delay settings. Failed, interrupted, suppressed and unconnected answered contacts are not automatically retried. Review them before explicitly returning them to Pending.
Test before normal use
- Assign one approved agent and create an Automatic dialer campaign with Maximum concurrent calls set to 1.
- Add a small set of test contacts whose recipients are ready to receive the calls. Confirm the agent is Available.
- Start the campaign. Answer a contact call and then the agent’s phone; check two-way audio, caller ID and the call log. If recording is enabled, check its playback too.
- Pause while a call is active. Confirm that the call can finish and no new contact is dialled.
- With suitable retry settings, let a test contact ring unanswered and check that it retries only after the configured delay.
- If using Predictive dialling, start a separate small test with approved agents and a low dial ratio. Check agent availability and Unconnected answers before increasing the rate.
Troubleshooting
| Problem | What to check |
|---|---|
| Dialer is missing | Confirm Teams Business and administrator access, then refresh the workspace. Teams Phone cannot use the add-ons. Manual approval is not needed to see the menu or start the standard trial. |
| Start Trial is unavailable | Check that the agent is enabled, has not already tried this dialer, and the workspace is not suspended or at its trial agent limit. Each agent’s trial can start only once per dialer. |
| New campaign or a dialling mode is unavailable | Assign at least one enabled agent active access to that mode. Check whether the trial has expired. |
| Campaign runs but does not dial | Confirm pending contacts are due, selected agents are Available and free, wrap-up has ended, and other campaigns are not using the call allowance. |
| Campaign cannot start or pauses with an error | Read its message. Check approval, trial expiry, the calling extension’s outbound permission and the carrier trunk. Correct the cause, then select Start campaign. |
| CSV import is rejected | Check name and phone headers, non-empty names and international numbers beginning with +. Correct the reported row and retry. |
| Settings or contacts cannot be edited | Pause the campaign and wait for all active calls to finish. |
| Too many unconnected answers | Check that selected agents can answer their phones. Reduce Predictive’s dial ratio or concurrency and repeat a small test. |
| Agent counts or the bill look wrong | Check each agent’s trial or paid status for each add-on, then contact support to reconcile billing quantities. Assignment changes do not update billing automatically. |
For trunk, device or audio problems, see Troubleshooting SessionPBX. Give support the workspace and campaign names, dialler mode, time and timezone, and the displayed error or contact outcome.