Call campaigns
In a campaign, your agent calls a list of people, one at a time. You paste the numbers or use a file, write what the agent says first and choose when it starts. At the end, you download the results of every call.
You launch campaigns in the console, under «Outbound», on the «Campaigns» tab. The agent only calls Portuguese numbers, landlines and mobiles.
What you need
- An active, configured agent, and an active number in your organization. The number does not have to be connected to that agent: you choose the number that calls under «From».
- Balance on your account. Each answered minute comes out of the balance.
- The list of people to call: numbers to paste, or an Excel or CSV file.
Launch a campaign with pasted numbers
Pasting the numbers is the quickest way. It is the first one the console shows.
- In the console, open «Outbound» and choose the «Campaigns» tab.
- Under «Contacts», keep «Paste numbers». In the «Paste the numbers here» box, paste the numbers, one per line or comma-separated, with or without +351. You can paste from a spreadsheet.
- For the agent to say each person's name, write the name first and then the number on each line, for example «Ana Silva 912 345 678».
- The console reads the list straight away. Repeated numbers are removed. Lines under «To check» only go in if you select «Include». Lines under «To fix» do not go in, and each one says what is wrong.
- Under «What the agent says first», write the first sentence: that the business's virtual assistant is speaking, the business name and the reason for the call. In this campaign, this sentence replaces the agent's first message. If you turn on «Say each person's name», the sentence gets
[nome]and each person hears their own name. - To hear the sentence first, select «Hear it on my phone», type your number and select «Call me». It is a real call and is paid like the others.
- Under «Schedule», choose «Call now» or «Later». With «Later», pick the day and time in «Campaign date and time».
- Check the «Agent», the number that calls, under «From», and the «Ring timeout», between 10 and 70 seconds. If you have only one agent with one number, the console shows it all on one line, with a «Change» button. If you leave «Campaign» empty, the campaign gets an automatic name.
- Read the summary: what people will hear, the estimated cost and how long it may take. Then select «Call … now», «Schedule for …» or, if you have no balance, «Launch when there is balance».
- With «Call now», the calls start 30 seconds later. Until then, «Stop» cancels the campaign before any call goes out. After that, the console shows how many calls are done.
Use a file
With a file, each person can have their own sentence, their own instructions and their own data.
- Under «Contacts», choose «Use a file».
- Select «How to prepare the file». There are three spreadsheet templates, each with a «Download this template» button.
- Save the spreadsheet as Excel (XLSX) or CSV, up to 50 MB. The old .xls file is not accepted. Row 1 holds the column names. Each row after it is one person.
- Choose the file under «Recipient file». For a CSV, the console shows a preview and the problems straight away, such as missing numbers or numbers that will not be called. An XLSX is checked when you send it.
- Type the name under «Campaign» and choose the «Agent», the number under «From», the «Ring timeout» and the «Schedule».
- Select «Save campaign». With «Call now», the console asks «Launch the campaign now?». Select «Launch now», and you have 30 seconds to «Stop». With «Later», the campaign is saved and starts at the set time.
The file's columns
phone_number: the number the agent calls. It is the only required column. If it is empty, the row is refused.first_message: the first sentence the person hears. If it is empty, the agent uses its own first message.prompt: instructions for that call. They replace the agent's. If it is empty, the agent uses its own instructions.- Other columns, such as
nomeorservico, are each person's data. Write the column name in lowercase, without accents or spaces. - To use a piece of data in the sentence or the instructions, write the column name with two braces on each side, as the templates show. Fill in every cell of that column: if one is empty, the agent says the sentence without that data.
Which numbers the agent calls
- Only Portuguese numbers: landlines, which start with 2 or 30, and mobiles starting with 91, 92, 93 or 96.
- Write them with +351, with 00351 or as just the 9 digits. Spaces do not count.
- In Excel, format the numbers column as text, so Excel keeps the +. The templates already come that way.
- In a file, a row with an error does not stop the others. It is marked as failed, with the reason, and the rest go ahead.
- In a file, each row is a call, even when the number repeats. In a pasted list, repeats are removed.
How the campaign moves on
- Each number makes one outbound call at a time. The agent calls one person, ends the call and moves on to the next.
- For more calls at once, ask Atendia for an extra simultaneous call, by e-mail to suporte@atendia.pt. Each extra simultaneous call has a monthly fee.
- Single calls on the same number, such as the ones your program asks for, go first. While they wait, the campaign shows «Waiting for a line».
- If you have no balance, the campaign shows «Waiting for balance» and restarts by itself up to 30 minutes after you top up.
- If the balance runs out midway, the campaign stops, and a call in progress may be cut off. With automatic recharge turned on, Atendia charges the saved card and, if the payment goes through, the calls go on. If you chose a «Monthly maximum» and it allows no further recharge, automatic recharges stop until the 1st of the next month, and the organization's owners get an e-mail.
- The phone rings until the «Ring timeout». Anyone who does not answer is marked «Not answered». If the agent has «New attempt» turned on, Atendia calls again on its own. Without it, the campaign does not call them again.
- If the agent has its calling hours turned on (in «Outbound rules», on the agent's page), the campaign only calls within them: outside the hours, calls wait for the next opening, showing «Waiting for calling hours». The calling hours come turned off. With them off, the campaign does not stop at night: with a pasted list, the console warns you when some calls may fall at night, but it does not block them.
The agent's outbound rules
- On the agent's page, the «Outbound rules» tab decides what the agent does in campaign calls. It also applies to the calls your program asks for.
- «Calling hours»: the days and hours when the agent may call. They come turned off.
- «New attempt»: if nobody answers, Atendia calls again on its own. You choose how many times, from 1 to 5, and how often, from every 5 minutes to every 24 hours. It comes turned off.
- Counts as nobody answering: it rings with no answer, the line is busy or rejects the call, voicemail answers and no message is left, another recording answers, or someone answers and nobody speaks. It does not call again when the person answers, when a message is left, or when the call fails or is cancelled.
- «Voicemail»: when the agent recognises voicemail, it ends the call or leaves your message, up to 500 characters. Atendia can suspend this recognition. While it is suspended, the agent's page says so, and the agent neither recognises voicemail nor leaves a message. Your choice stays saved.
- «Call me later»: when the person asks to be called later, the agent agrees a day and time with them and books a callback to the same number, up to 30 days later. It comes turned off.
- Each new attempt and each callback is a call: it uses credit like any other. A call that is never picked up uses no credit. A recording that answers and a call answered in silence use the seconds they lasted.
The «Do not call» list
- Under «Outbound», the «Do not call» tab holds the numbers your account does not call. It applies to campaigns, the «Quick call», «Repeat call», new attempts, callbacks and the calls your program asks for.
- To put numbers on the list, press «Add numbers» and type or paste one number per line. A line that is not a phone number is not added, and the console tells you which one.
- On an outbound call, when the person asks not to be called again, the agent saves that call's number on the list and only then tells them it is registered. It does this only on outbound calls and only for the number of that call. On an inbound call, the agent does not register the request and does not say it is registered: add the number yourself.
- A call to a number on the list is not made. The «Quick call» and «Repeat call» are refused at once. In a campaign, the row is refused, with the reason «On the «Do not call» list», and the others go ahead. A call already booked becomes «Failed», with the same reason and no new attempt.
- A number stays on the list until it is removed. «Remove from list» asks for confirmation, and only the Owner and the Administrator can do it.
- On an agent with «Zero-PII retention», the number is kept on the list too, because the request could not be honoured without it. It is kept with no link to the call.
Follow and cancel
- Below the form, the list of campaigns shows each one's «Status», for example «Scheduled», «Calling», «Waiting for balance», «Completed» or «Cancelled».
- In the «Campaign actions» menu, «View details» shows the counts and each call, with its status. A refused row shows the «Reason».
- «Cancel campaign» asks you to confirm. If the campaign has not started, no call is made. If it is already calling, the remaining calls do not go out, and calls in progress continue until they end.
- On the «History» tab you see each call. A «Scheduled» call is cancelled with «Cancel call». A «Not answered» or «Failed» call has «Repeat call», which makes a new call to that person.
The results
- In the «Campaign actions» menu, «Export results CSV» downloads a file with one row for each person on your list.
- Each row has the number (
phone_number), the status (outbound_status), the duration in seconds (duration_seconds), the reason for a failure (failure_reason) and the start and end times (started_at,ended_at). - After them come your list's columns and the fields the agent filled in, the ones you chose on the agent's «Analysis» tab, and the «Analysis» checks.
- To call again the people who did not answer, turn on «New attempt» on the agent before you launch the campaign. After it ends, launch another campaign with those numbers.
The result of every call: email summary, Analysis and notice to your program
With the Builder
Tell the Builder whom you want to call and why. It writes the campaign sentence and takes you to the «Campaigns» screen. The sentence shows up under «What the agent says first», with the note «Phrase written with the Builder.». The Builder does not receive the numbers and does not launch campaigns: you paste the numbers in the box and you select the button.
From your program
Your program can also create campaigns and ask for calls, with an API key. Those campaigns show up under «Campaigns» in the console.
Make calls from your program (for developers)
Good to know
- Each answered minute comes out of the balance. A call answered by voicemail, by another recording, or where nobody speaks ends as «Not answered», but it uses the seconds it lasted. When the agent recognises voicemail, it does not talk to it: it ends the call or leaves your message, as you choose in «Outbound rules», on the agent's page.
- With a pasted list, the summary before launch estimates the cost and duration with calls of 1 to 5 minutes. It is an estimate: the real cost depends on how long each call lasts.
- Atendia does not limit campaigns: there is no limit on contacts or on campaigns. The file can be up to 50 MB.
- The voice and language of the calls come from the agent.
- «The agent speaks first» starts turned off: the agent waits for the person to speak and, if they say nothing for 6 seconds, it starts. If you turn it on, the agent says the first sentence as soon as the person answers.
- If you turn on transfer, the agent can also hand a campaign call to a person on your team.
What you pay Atendia is on the prices page: Atendia prices
What the law asks
Whom you call, when, and what the agent says are your choice and your responsibility. A note on the law: calls to consumers between 9 am and 10 pm, say who you are right away, and have prior consent for marketing calls. Atendia does not block any of this. For example, start the campaign sentence with your company's name.