How-to guide

Outbound calls

Place a single call, run a campaign over a list of contacts, start calls from a link, and set the do-not-call and consent rules every call passes.

What you'll learn

How to have an agent call people: one call, a campaign over a list, or a call started by your own system. Every call spends money (calls are billed per minute) and every call is checked against your do-not-call and consent rules first.

Open Outbound calls in the sidebar. The tabs are Campaigns, Single call, Triggers and Do-not-call and consent.

Prerequisites

Place a single call

  1. Open Single call.
  2. Enter Number to call, including the country code.
  3. Choose From number, one of your active numbers, and the Agent. If you leave the agent alone, the number's own agent is used.
  4. Optionally turn on Voicemail handling, and add Details for the agent (optional, JSON), such as {"customer_name":"Sam"}. Every value must be text. The agent can use them as variables.
  5. Choose Place call.

The call dials immediately and is billed. If the number is on your do-not-call list, or breaks a calling rule, it is refused and the reason is recorded.

Run a campaign

A campaign calls a list of contacts, a few at a time, and retries the ones who do not answer.

  1. Open Campaigns and choose New campaign.
  2. Fill in:
FieldWhat it does
NameRequired, up to 200 characters.
From numberRequired. The number the calls come from.
AgentOptional. Leave it to use the number's agent.
ConcurrencyHow many calls run at the same time.
Max attemptsHow many times one contact is tried.
Retry delay (sec)How long to wait before trying a contact again.
Dial timeout (sec)How long a call rings before giving up.
Calls / minuteOptional cap on how fast calls start.
Initial directive (optional)What the agent should say or do first.
  1. Save. Creating a campaign does not dial anyone.
  2. Open the campaign and choose Add contacts: paste phone numbers (with country codes) or upload a CSV with a header row.
  3. Choose Start. A confirmation says how many contacts will be dialled; choose Start dialing. This places calls and bills per answered minute. Spend appears in Billing as calls complete.

While it runs you see progress and rates, and a contacts table that links each contact to their last call. Pause stops new calls and Resume continues. Cancel campaign stops it: calls not yet placed are cancelled and completed calls are unaffected.

Start calls from your own system

A trigger is a private link that places a call when your system calls it.

  1. Open Triggers and choose New trigger.
  2. Enter a Name and the phone number it calls from. Optionally choose an Agent and an opening prompt, which can use variables.
  3. Choose Create trigger. The Call URL and Token are shown once, so copy them now.

Anyone who has the URL can place calls from your number. Keep it secret, and Delete the trigger to stop it working.

Open Do-not-call and consent. It has two parts.

Do-not-call list. Choose Add number, enter the number in international format and an optional reason. Remove deletes it from the list immediately, with no confirmation. A table of recent decisions shows which calls were allowed or refused.

Calling rules. These apply to every outbound call, from a campaign, a single call or a trigger:

SettingWhat it does
Never call numbers on the do-not-call listRefuses listed numbers.
Only call within calling hours, in the person's local timeUses Calls start at (hour) and Calls end at (hour) (quiet hours outside them).
Only call people whose consent is on fileRefuses anyone without recorded consent.
Calls per person per day (0 = no limit)Caps repeat calls to one person.
Time zone when the person's is unknownThe fallback for calling hours.

Choose Save to apply them. Phone calling is regulated and the rules differ by country; check what applies to you before you call people at volume.

Common problems

ProblemFix
Place call is greyed outA field is missing or invalid. The form says which, once you leave the field.
A call was refusedOpen Do-not-call and consent and check the decisions table for the reason.
A campaign will not startIt needs contacts and an active From number.

Next steps

On this page