# Building an automation

You build an automation in the [Signals console](https://console.signals.pressone.africa). Open
**Automations**, select **New automation** and work through the six steps of the builder. Nothing
is called until you switch the automation on.

## The six steps

1. **Who it calls.** This step shows the two ways customers reach the automation: one at a time
   as triggers from your system, or in a spreadsheet of up to 5,000 customers that you upload. Both
   work on every automation, so there is nothing to choose here.
2. **What the person sees ringing.** Select the originating number. It must be a Signals number
   your project owns.
3. **What they hear first.** Write the message and choose the voice that reads it.
4. **The question you ask them.** Write the keypad question and define up to four options.
5. **When to try again.** Set the retry rule for each of no answer, a busy line, a failed call
   and a rejected call.
6. **When not to call at all.** Decide whether to honour the do-not-call list, limit each number
   to one call per day, and restrict calls to calling hours.

Preview the message as you write it. Once you switch the automation on, place a test call to your
own phone from the builder before you send real triggers. A test call on an automation that is still
off is refused with `409` and code `automation_off`, and the do-not-call list applies to test calls
too.

## Message variables

A message can contain variables, written as a name in double braces such as `{{name}}`. Each
trigger fills them in: `name` comes from the trigger's `name` field and every other variable from
its `parameters` object. A message of "Hello `{{name}}`, your appointment is confirmed for Friday
at `{{time}}`." with `name` set to `Adebayo Ogundimu` and `parameters.time` set to `10:30` is read
as "Hello Adebayo Ogundimu, your appointment is confirmed for Friday at 10:30." The question and
the other spoken lines cannot contain variables.

## Keypad options

Each option is a single digit, used once, with a label and an action. The action either ends the
call, repeats the message, transfers the customer to another number or adds the customer to the
do-not-call list. Every option except repeat needs an outcome value: a short word such as
`confirmed` or `reschedule` that your system receives in the completed event's
`pressed.outcome_value`. The customer has between 3 and 30 seconds to press a key, as you set.

## Voices

The console offers 13 voices in two groups. You choose the voice in step 3: **Change voice**
opens the list, where you can play each voice's sample, read who it sounds like and which type
of voice it is, and narrow the list by accent, gender and type. Playing a sample does not
choose the voice; **Use this voice** does. Speech is priced by type; the console's Rates page
has the prices. A new automation uses US female until you choose another voice.

| Group | Voice | Sounds like | Sample |
| --- | --- | --- | --- |
| Natural | US female | American female | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/us-female-neural.mp3) |
| Natural | US male | American male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/us-male-neural.mp3) |
| Expressive | Nigerian female, expressive | Nigerian female | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/us-female-expressive.mp3) |
| Expressive | Nigerian male, expressive | Nigerian male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/us-male-expressive.mp3) |
| Expressive | Joy | Nigerian female | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/nigerian-female-expressive-joy.mp3) |
| Expressive | Ola | Nigerian male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/nigerian-male-expressive-ola.mp3) |
| Expressive | Nafiu | Nigerian male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/nigerian-male-expressive-nafiu.mp3) |
| Expressive | Katie | British female | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/british-female-expressive-katie.mp3) |
| Expressive | Charlotte | British female | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/british-female-expressive-charlotte.mp3) |
| Expressive | Nathaniel | British male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/british-male-expressive-nathaniel.mp3) |
| Expressive | Adam | British male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/british-male-expressive-adam.mp3) |
| Expressive | Jon | American male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/us-male-expressive-jon.mp3) |
| Expressive | Peter | American male | [Play](https://storage.googleapis.com/pressonedotco/voice-samples/us-male-expressive-peter.mp3) |

## Limits

| Setting | Limit |
| --- | --- |
| Spreadsheet upload | 5,000 customers |
| Message | 1 to 1500 characters |
| Question and other spoken lines | 1 to 600 characters each, without variables |
| Keypad options | 1 to 4, each a single digit, with no digit used twice |
| Outcome value | A lowercase letter followed by lowercase letters, digits or underscores, up to 40 characters |
| Time to press a key | 3 to 30 seconds |
| Retry at an interval | Every 5 to 120 minutes, 1 to 5 times |
| Retry the next day | At a set local time, 1 to 3 times |
| Calling hours | A start time before the end time, in 24-hour `HH:MM`, in a named time zone such as `Africa/Lagos` |
| Transfer number | E.164 format, such as `+2348012345678` |

Once the automation is on, continue with [Triggering calls](/automations/triggering-calls).
