Signals Docs
Automations

Building an automation

You build an automation in the Signals console. 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.

GroupVoiceSounds likeSample
NaturalUS femaleAmerican femalePlay
NaturalUS maleAmerican malePlay
ExpressiveNigerian female, expressiveNigerian femalePlay
ExpressiveNigerian male, expressiveNigerian malePlay
ExpressiveJoyNigerian femalePlay
ExpressiveOlaNigerian malePlay
ExpressiveNafiuNigerian malePlay
ExpressiveKatieBritish femalePlay
ExpressiveCharlotteBritish femalePlay
ExpressiveNathanielBritish malePlay
ExpressiveAdamBritish malePlay
ExpressiveJonAmerican malePlay
ExpressivePeterAmerican malePlay

Limits

SettingLimit
Spreadsheet upload5,000 customers
Message1 to 1500 characters
Question and other spoken lines1 to 600 characters each, without variables
Keypad options1 to 4, each a single digit, with no digit used twice
Outcome valueA lowercase letter followed by lowercase letters, digits or underscores, up to 40 characters
Time to press a key3 to 30 seconds
Retry at an intervalEvery 5 to 120 minutes, 1 to 5 times
Retry the next dayAt a set local time, 1 to 3 times
Calling hoursA start time before the end time, in 24-hour HH:MM, in a named time zone such as Africa/Lagos
Transfer numberE.164 format, such as +2348012345678

Once the automation is on, continue with Triggering calls.

Last modified on