Call
Rings an extension, a user group, or an external number. Each destination has its own ringing window, which builds a cascade within a single module.
At a glance
| Outputs | one, unlabeled, taken only if nobody answers |
| Fields | one Destination: line per destination, each with a ringing slider |
| Ringing window | from 0 to 180 seconds, 0 to 30 by default |
| Accepted destinations | an extension, a user group, an external number, a {{variable}} |
| Number of destinations | unlimited, one per line |
How it works
All the destinations in the list are launched within the same attempt. Each line's slider says at which second that destination starts ringing and at which second it stops: this is what builds a cascade, the desk phone first, then the mobile, without stacking two modules.
A destination can take four forms:
- an extension in your installation, suggested in the list as soon as you type the first characters;
- a user group, suggested in the same list marked Group, which rings all its members;
- an external number, which you type as-is;
- a
{{variable}}set earlier in the plan, for example by DTMF entry or API request.
Before dialing, the installation strips out anything in the number that isn't a digit or a +. Spaces, dots, and hyphens in an external destination therefore have no effect.
If a destination picks up, the call ends with the conversation: the rest of the plan is not played. The module's output is only taken when nobody answers. Everything you connect after this module therefore handles a single case, that of the unanswered call. If the person who picked up transfers the call, the plan doesn't take back control either.
And if that output isn't connected to anything, the call is hung up at the end of the ringing, with no voicemail and no announcement. This is the most common cause of calls that "just cut off by themselves" on this module.
A line with an empty destination is discarded when saving. If no valid line remains, the module rings nobody and goes straight to its output.
What to fill in
| Field | What's expected | If you leave it blank |
|---|---|---|
| Destination: | an extension, a user Group, an external number, or a {{variable}} | the line is discarded when saving, as if you had never created it |
| Ringing slider | the start second and end second of ringing for this destination, between 0 and 180 | the slider stays at 0 to 30, that is thirty seconds of ringing |
Step by step
- Place the Call module and connect the previous node to its input.
- Open it with a double click. The Call window opens with a first destination line.
- Type the first characters in Destination: and choose from the suggested list: an extension, a user Group, or a plan variable. For an external number, type the whole number.
- Set this line's slider to the ringing window you want.
- Click Add for a second destination, and repeat as many times as needed.
- Click Save to close the window. The module now shows the list of its destinations.
- Connect the module's output to what should happen when nobody answers: a voicemail box, an announcement, a queue.
- Click Save in the editor's toolbar, then Apply changes.
- Call the number that enters this plan, let it ring without answering, and check that the "nobody answered" branch runs correctly.
If it doesn't work
Nobody rings, the call goes straight to the rest of the plan. No valid destination was saved. Reopen the module: a line left blank was discarded when saving, and the module shows Not configured under its title.
The destination picks up, and the rest of the plan is never played. This is expected behavior. The module's output is only used for the case where nobody answers. Anything that must be played in every case belongs before the module, not after.
The call is cut off at the end of ringing instead of going to voicemail. The module's output isn't connected to anything. Connect it to a Voicemail box, an announcement, or a queue.
I had chosen a group, and a number gets dialed instead. The line was edited with the keyboard after the group was chosen, which cancels that choice. Reopen the module and reselect the Group from the suggested list, without editing the text afterward.
The mobile rings at the same time as the desk phone, but I wanted a cascade. Both lines have the same start second. Set the second line's slider to start later, for example 0 to 20 for the desk phone and 15 to 45 for the mobile.
How the call flow is built, explained in pictures
See the Dial plans page